Guida Control

Guida Control は、Guida Complete と Guida Node をブラウザーから操作するための、独立したプロプライエタリなアルファ版アプリケーションです。 Remote Ops API 経由で接続し、ノードのワークスペースファイル、キュー、ワークフロー台帳、運用データベースを直接読み取ることはありません。

公開コンテナーイメージは、付属ライセンスに従って Guida の評価と運用に利用できます。イメージが公開されていることと、Guida Control がオープンソースであることは同じではありません。

操作画面とデータの所有者

Overview と Command Center は注意事項、能力、進行中の作業、範囲を限定した操作をまとめます。Results は取得結果、エクスポート、配信記録を扱います。Pipelines と Extractors では契約、認定計画、下書き、差分、preflight、保護された実行を扱います。Workspace、Browser、Workbench、Activity、Nodes がノードの確認を補い、Advanced は必要な場合だけ有効にします。Remote View はブラウザータブを配信し、許可されている場合は操作もできます。

ワークスペース、エクストラクター、パイプライン、キュー、ワーカー、ワークフロー実行、項目、イベント、復旧情報の所有者は Guida ノードです。Control が自身の SQLite データベースに保存するのは、ノード登録、接続設定、Control の操作履歴、エクスポートおよび配信記録です。Guida の運用データの複製ではありません。

読み取りから始める

監視と契約確認にはリモート制御は不要です。状態を変更する操作には、Control 側の GUIDA_CONTROL_REMOTE_CONTROL=1 と、選択したノードの controlEnabled の両方が必要です。その場合でも最終判断は Guida が行い、能力、許可ドメイン、ポリシー、確認、サイズ、タイムアウトの制限を適用します。

現在の MVP では Remote Ops 自体はクライアント認証を行いません。NetBird ACL、ファイアウォール、リバースプロキシの規則、localhost トンネル、mTLS などでチャネルを保護してください。Remote Ops ポートをインターネットへ直接公開しないでください。

Guida Node の Remote Ops は通常 9631、Guida Control のブラウザー UI は通常 127.0.0.1:9632 を使用します。ノードを登録またはインポートし、状態と互換性を確認したうえで、変更操作が必要になるまでリモート制御を無効にしておくことを推奨します。

Control はコンパクトなスキーマ索引を読み、必要な詳細契約だけを取得します。パイプライン編集は、下書き、差分、保存または削除、検証、preflight、計画、プレビューという明示的な順序で進みます。保存だけで実行は始まりません。詳しくは エクストラクターと セマンティックパイプラインを参照してください。

このアルファ版では、運用作業を監督下で行ってください。組み込みの Enterprise ID、ロールベースアクセス制御、導入済みフリートの自動適格性判定は現時点の提供範囲ではありません。出荷済みの契約で確認できるまでは、将来の機能として扱ってください。