agent 経由のアップデート

agent は万能インストーラーです。対象ホストで動き出してしまえば、他のどのコンポーネントをアップデートするときも operator がホストに直接触る必要はありません — agent が話している backend も、メッセージを運ぶブローカーも、agent 自身も対象です。

この章はコンポーネントごとに 1 ページずつあります:

全コンポーネントで共通の仕組み:

バケット / ストリーム	用途
`OBJECT_APP_PACKAGES`	汎用バイナリストレージ (backend、client、NATS サーバーなど)。キーは `<name>/<version>`。
`OBJECT_SCRIPTS`	マニフェストが `script_object` で参照する PowerShell スクリプト本体。キーは `<name>/<version>`。
`OBJECT_AGENT_RELEASES`	agent バイナリ専用。agent の rollout 専用の watcher / target_version フローを持つので `APP_PACKAGES` とは別バケットになっています。
`agent_config` (KV)	レイヤード config — global / グループ別 / PC 別。`target_version` はここに置かれます。
`jobs` (KV)	ジョブカタログ。各エントリは operator が `exec` できるマニフェストです。

CLI コマンド一覧:

コマンド	動作
`kanade app publish <name> <version> <file>`	`OBJECT_APP_PACKAGES` にアップロード。
`kanade script publish <name> <version> <file>`	`OBJECT_SCRIPTS` にアップロード。
`kanade job create <yaml>`	`jobs` KV にジョブマニフェストを upsert。
`kanade exec <job-id> --pcs <pc> [--pcs <pc> …]`	登録済みジョブを PC 群に対して起動。
`kanade agent publish <file>`	agent バイナリをアップロード (バージョンは PE VERSIONINFO から自動抽出)。
`kanade agent rollout <version> --pc \\| --group \\| --global`	指定スコープの `target_version` を切り替え。各 agent は self-update watcher 経由でこれを拾います。