kind: Sync

収束操作の定義です。pre → run → post の3ステージで構成され、外部コマンドをサブプロセスとして呼び出します。pre と post は省略できます。

yaml apiVersion: nagi.io/v1alpha1 kind: Sync metadata: name: dbt-default spec: pre: type: Command args: ["python", "pre.py"] run: type: Command args: ["dbt", "run", "--select", "{{ sync.selector }}"] post: type: Command args: ["python", "post.py"]

Environment Variables

各ステップ（pre, run, post）は env フィールドで環境変数を宣言できます。サブプロセスには、ここで宣言した値と OS 動作に必要な最小セットのみが渡されます。親シェルの環境変数は引き継がれません。値は ${VAR} 形式で Nagi プロセスの環境変数を参照できます。詳細は環境変数を参照してください。

Attributes

Attribute	Type	Required	Default	Description
run.args	list[string]	Yes	-	Command and arguments in argv format.
run.type	StepType	Yes	-	Execution type for this step (currently only Command).
run.env	map[string, string]	—	{}	Environment variables to set for the subprocess.
run.identity	string	—	-	Reference to a kind: Identity resource. Overrides the Sync-level identity for this stage.
run.timeout	Duration	—	-	Per-step timeout. Overrides the Sync-level timeout for this stage.
identity	string	—	-	Reference to a kind: Identity resource. Applied to all stages unless overridden per-stage.
post	SyncStep	—	-	Optional step executed after the main sync command.
pre	SyncStep	—	-	Optional step executed before the main sync command.
timeout	Duration	—	-	Sync-wide timeout applied to each step unless overridden. Falls back to NagiConfig::default_timeout when omitted.

SyncStep

Attribute	Type	Required	Default	Description
args	list[string]	Yes	-	Command and arguments in argv format.
type	StepType	Yes	-	Execution type for this step (currently only Command).
env	map[string, string]	—	{}	Environment variables to set for the subprocess.
identity	string	—	-	Reference to a kind: Identity resource. Overrides the Sync-level identity for this stage.
timeout	Duration	—	-	Per-step timeout. Overrides the Sync-level timeout for this stage.