EN | JA

agent 経由のアップデート

既存の Windows インストーラジョブは、登録済みエージェント経由でバックエンド、クライアント、ブローカーを更新します。エージェント自身の更新は Linux と Apple Silicon macOS にも対応します。Linux バックエンドは別の bundle/setup 経路を使い、macOS Client の配布連携は未実装です。資格情報、接続性、稼働中のエージェントが必要で、オフライン復旧にはホストへの直接アクセスが必要な場合があります。

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

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

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

CLI コマンド一覧:

kanade app, kanade script and kanade agent (publish / rollout / current / logs) talk to the backend HTTP API, not to NATS: they need KANADE_AUTH_TOKEN (see kanade login) for an account with the operator role, and no broker token. Publishes and deletes are audited against that account by the backend. Operators who previously relied on the NATS token alone must now export KANADE_AUTH_TOKEN; without it the backend answers 401 / 403. The NATS user pair in the server settings' agent_install section is the agent role's credential, shared by all agents by design, and the backend- generated installers embed it (alongside the token) only when both halves are set. The backend's own credential and the break-glass credential never go in those settings.

kanade agent publish is capped by the backend at 64 MB for the whole upload (a normal agent binary is well under that). app publish additionally downloads the package back from the backend and checks its digest before reporting success.

コマンド動作
kanade app publish <name> <file> [--version <version>]Upload to OBJECT_APP_PACKAGES through the backend API.
kanade script publish <name> <version> <file>Upload to OBJECT_SCRIPTS through the backend API.
kanade job create <yaml>jobs KV にジョブマニフェストを upsert。
kanade exec <job-id> --pcs <pc1>,<pc2>登録済みジョブを PC 群に対して起動。
kanade agent publish <file> [--version <version>]Upload an agent binary through the backend API (must be an official kanade-agent carrying release metadata; the version is read from it and --version, if given, must match — see Agent release admission).
kanade agent rollout <version> --pc \| --group \| --globalFlip target_version on the chosen scope; agents pick it up via their self-update watcher. Goes through the backend API.
kanade agent currentPrint the global target_version (group / pc overlays are not shown; use kanade config get --group/--pc).
kanade agent logs <pc_id> [--tail <n>]Tail an online agent's log via the backend API.