はじめに

kanade — 奏 は Windows 端末群の管理システムです。operator はひとつの CLI / SPA から、数百台規模の PC に対してスクリプト実行・ソフトウェア配布・インベントリ収集・ライブのパフォーマンスデータ取得を一気にこなせます。構成要素:

コンポーネント役割
kanade-agent管理対象 PC 上で動く Windows サービス。NATS を購読し、コマンドを実行して結果を送り返します。
kanade-backendHTTP API + projector。状態を永続化し、SPA を配信し、operator 用エンドポイントを公開します。
kanade-clientオプションの Tauri デスクトップアプリ。エンドユーザー向け UI。
NATS serverコマンドのファンアウトと結果集約を担うメッセージブローカー。agent は NATS だけと話し、backend も NATS から読みます。
kanade CLIoperator が使うコマンドライン。バイナリの publish、ジョブの起動、状態の照会を行います。

このサイトは 2 種類の読者を想定しています:

  • operator (kanade fleet の運用者) — 各端末に ssh せずに各コンポーネントをアップデートする方法 (agent 経由のアップデート 参照)。
  • 開発者 (agent が実行する PowerShell ジョブを書く人) — 何が動いて何が動かないか、最近の agent バージョンで何が変わったか (agent 向けスクリプトを書く 参照)。

詳細なプロトコル / on-wire 仕様は Spec にあります (旧 single-page ドキュメント。docs サイトが整うにつれて章別に分割予定)。