はじめに
kanade — 奏 は Windows・Linux・Apple Silicon macOS フリート向けの端末管理システムです。運用者は単一の CLI / SPA からスクリプト実行、ソフトウェア導入、インベントリ収集、数百台の PC のライブ性能データ表示を行えます。構成要素は次のとおりです。
| 構成要素 | 役割 |
|---|---|
| kanade-agent | 管理対象 PC 上で動く Windows サービス。NATS を購読し、コマンドを実行して結果を送り返します。 |
| kanade-backend | HTTP API + projector。状態を永続化し、SPA を配信し、operator 用エンドポイントを公開します。 |
| kanade-client | Windows と Apple Silicon macOS 14+ 向けの任意導入の Tauri エンドユーザーアプリ。macOS のネイティブ通知・自動起動連携は未実装です。 |
| NATS server | コマンド配信と結果集約のメッセージブローカー。エージェントはコマンドとテレメトリに NATS を使い、インストーラジョブはバックエンドの HTTP 経由で成果物を取得する場合もあります。 |
| kanade CLI | operator が使うコマンドライン。バイナリの publish、ジョブの起動、状態の照会を行います。 |
このサイトは 2 種類の読者を想定しています:
- 運用者 (kanade fleet の運用者) 向け — 各端末に ssh せずに各コンポーネントをアップデートする方法について解説しています(agent 経由のアップデート 参照)。
- 開発者 (agent が実行する PowerShell ジョブを作成する人) 向け — スクリプトが動作する仕組みや制限事項、最近の agent バージョンにおける変更点について解説しています(agent 向けスクリプトを書く 参照)。
詳細なプロトコル / on-wire 仕様は Spec にあります (旧 single-page ドキュメント。docs サイトが整うにつれて章別に分割予定)。