EN | JA

システムアーキテクチャ

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 の実行ユーザー規則 を参照してください。