システムアーキテクチャ
kanade は Windows・Linux・Apple Silicon macOS 端末を非同期に管理します。利用可能なインベントリ、セッション、デスクトップ機能はプラットフォームごとに異なります。
コンポーネントトポロジー
システムは 5 つの主要コンポーネントで構成されており、イベント駆動型の pub/sub 構造を介して調整されます。
graph TD
subgraph Operator Session
CLI[kanade CLI]
SPA[React SPA]
end
subgraph Server Infrastructure
Backend[kanade-backend]
NATS[NATS Broker / JetStream]
end
subgraph Managed Endpoints
Agent1[kanade-agent PC-1]
Agent2[kanade-agent PC-2]
Client[kanade-client Tauri App]
end
CLI -->|Command / Query API| Backend
SPA -->|REST / WebSockets| Backend
Backend <-->|State/PubSub| NATS
Agent1 <-->|NATS Connection| NATS
Agent2 <-->|NATS Connection| NATS
Client <-->|KLP local IPC| Agent1
1. kanade-agent
各ホストの常駐実行エンジンです。Windows サービス、Linux systemd サービス、macOS launchd デーモンとして動作します。
- 役割: コア実行エンジン。
- 通信: アウトバウンド専用の NATS 接続を確立します。インバウンドポートを開かないため、ファイアウォールに優しい設計です。
- 機能: ジョブ実行、インベントリ・性能データの報告、自己更新を行います。Windows PowerShell、PowerShell 7 (
pwsh)、shに対応し、選択したシェルは対象ホストへの導入が必要です。Windows 固有のセンサーやジョブが自動的に他の OS で動くわけではありません。
2. kanade-backend
中央の HTTP API およびプロジェクションサーバーです。
- 役割: コマンドの調整、受信テレメトリの処理、およびオペレーター用 Web インターフェースの提供。
- 状態管理: イベント、アクティビティログ、およびステータスレコードをローカルの SQLite データベースに永続化します。
- プロジェクターパターン: NATS コマンドレスポンスストリームを購読し、受信したペイロードを解析して、リアルタイムで状態テーブルに反映(投影)します。
3. NATS ブローカー (with JetStream)
フリート全体のメッセージ転送レイヤーです。
- 役割: 軽量かつ高スループットなメッセージブローカー。
- JetStream: コマンドストリーム、ジョブ登録、およびファイルストレージ(パッケージやエージェントスクリプトを配信するための NATS オブジェクトストアバケットを使用)を保持します。
- 疎結合: バックエンドとエージェントを切り離します。バックエンドがオフラインまたは再起動中であっても、エージェントは実行を継続して送信トレイにレコードをキャッシュし、接続が再開されたらそれらをプッシュします。
4. kanade-client
エンドポイント上のログインユーザーのデスクトップセッションで動作する、オプションの Tauri デスクトップアプリケーションです。
- 役割: エンドユーザーとの対話(プロンプトダイアログ、通知、ユーザー向けダッシュボードなど)を提供します。
- 通信: セキュリティで保護されたローカル IPC メカニズムを介して、ローカルの
kanade-agentと状態を共有します。
5. kanade CLI
オペレーター向けの主要なコマンドラインツールです。
- 役割: ソフトウェアアップデートのパッケージングと公開、ジョブマニフェストの送信と実行、およびコマンドラインからのライブフリートインベントリの照会。
セキュリティと信頼性の設計
アウトバウンド専用接続
エージェントは外向きの NATS 接続を開始します(WebSocket 構成も含みます)。パッケージ導入ジョブはバックエンドの HTTP API から成果物を取得することもあります。管理対象端末に受信用ネットワークリスナーは不要ですが、ローカル KLP IPC は別です。誰がコマンドを発行できるかは、ブローカーの認証・権限とコマンド署名ポリシーに依存します。
エージェントのジョブ実行ユーザー
PowerShell スクリプトは実行ごとのステージングディレクトリを使います。Windows では %ProgramData%\Kanade\agent-scripts、macOS では専用のステージングルート、それ以外の Unix では一時ディレクトリです。ジョブは run_as: system、user、system_gui を指定でき、対応範囲は OS ごとに異なります。実行ユーザーとステージングの保護であり、信頼できないスクリプトのサンドボックスではありません。本番の system ジョブは LocalSystem / root で動きます。macOS の実行ユーザー規則 を参照してください。