EN | JA

はじめに

kanade — 奏 は Windows・Linux・Apple Silicon macOS フリート向けの端末管理システムです。運用者は単一の CLI / SPA からスクリプト実行、ソフトウェア導入、インベントリ収集、数百台の PC のライブ性能データ表示を行えます。構成要素は次のとおりです。

構成要素役割
kanade-agent管理対象 PC 上で動く Windows サービス。NATS を購読し、コマンドを実行して結果を送り返します。
kanade-backendHTTP API + projector。状態を永続化し、SPA を配信し、operator 用エンドポイントを公開します。
kanade-clientWindows と Apple Silicon macOS 14+ 向けの任意導入の Tauri エンドユーザーアプリ。macOS のネイティブ通知・自動起動連携は未実装です。
NATS serverコマンド配信と結果集約のメッセージブローカー。エージェントはコマンドとテレメトリに NATS を使い、インストーラジョブはバックエンドの HTTP 経由で成果物を取得する場合もあります。
kanade CLIoperator が使うコマンドライン。バイナリの publish、ジョブの起動、状態の照会を行います。

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

  • 運用者 (kanade fleet の運用者) 向け — 各端末に ssh せずに各コンポーネントをアップデートする方法について解説しています(agent 経由のアップデート 参照)。
  • 開発者 (agent が実行する PowerShell ジョブを作成する人) 向け — スクリプトが動作する仕組みや制限事項、最近の agent バージョンにおける変更点について解説しています(agent 向けスクリプトを書く 参照)。

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