rhdh-local

RHDH Local

ローカルでの実行を担当し、呼び出し元のワークフローに証拠を返します。すべてのコマンドでは、このスキルのスタンドアロン CLI を使用します。別のスキルをインストールする必要はありません。

機能の確認

1. uv run scripts/rhdh-local --help を実行します。
2. RHDH_LOCAL_SETUP_DIR を使うか、現在のディレクトリから上位へたどって rhdh-local-setup を見つけます。uv run scripts/rhdh-local --json status を実行します。
3. セットアップが見つからない場合は、必要な環境変数またはチェックアウトのディレクトリ構成を伝え、ランタイム関連の処理だけを中止します。
4. .env のシークレットを会話のコンテキストに読み込んではいけません。不足している変数名だけを尋ね、コンテナランタイムにその値を読み込ませます。

結果に応じた手順

結果	読み込んで従う手順
オーバーレイブランチまたはタグのプラグインバージョンやアーティファクトを確認する	python3 scripts/fetch-plugin-metadata.py <plugin-name> --branch <branch-or-tag> --json を実行します。デフォルトの参照先は main で、ランタイムのセットアップは不要です
カタログまたは PR アーティファクトを有効にする	workflows/enable-plugin.md
プラグインを無効にする	workflows/disable-plugin.md
pristine モードと customized モードを切り替える	workflows/switch-mode.md
プラグインをエンドツーエンドで検証する	workflows/test-plugin.md と references/dynamic-plugin-testing.md
ステータスまたは有効なパッケージを確認する	uv run scripts/rhdh-local --json status または uv run scripts/rhdh-local --json plugins list を実行します
カスタマイズを適用する	uv run scripts/rhdh-local --json apply を実行します
起動または停止する	uv run scripts/rhdh-local --json up [flags] または uv run scripts/rhdh-local --json down を実行します
ヘルスを確認する	uv run scripts/rhdh-local --json health を実行します
バックアップまたは復元する	uv run scripts/rhdh-local --json backup または uv run scripts/rhdh-local restore <archive> を実行します。復元は --force を指定するまでドライランです
起動、ネットワーク、または 504 をトラブルシューティングする	references/troubleshooting.md
環境変数を設定する	references/env-reference.md

不変条件

• rhdh-customizations/ 配下のソースファイルだけを編集します。編集のたびに apply を実行し、rhdh-local/ 配下のコピーを同期します。
• Lightspeed または Orchestrator が有効な場合は、この CLI の up コマンドと down コマンドを使用します。これらのコマンドが Compose のライフサイクルと共有ネットワークを管理します。
• パッケージ参照は spec.dynamicArtifact または呼び出し元が提供した参照から取得します。命名規則から OCI 参照を組み立ててはいけません。
• 動的プラグインのオーバーライドでは includes: ブロックを保持します。バックエンドパッケージをフロントエンドパッケージより前に配置します。
• プラグインテストが成功となるのは、リクエストに関連するインストール、起動、ヘルス、UI の結果が記録されている場合だけです。想定内の認証情報エラーと読み込み失敗を区別します。

呼び出し元から提供される情報

呼び出し元は、このスキルを名前で呼び出し、会話の中で次の情報を指定します。

• 有効にする各パッケージの参照と、そのプラグイン設定、または none
• プラグインで必要な環境変数の名前のみ
• プラグインが描画するカタログテストエンティティ
• 実行するチェック：インストール、起動、ヘルス、UI
• 後でクリーンアップするかどうか

指定された参照をそのまま使用します。参照が不足している場合は、命名規則から組み立てずに尋ねてください。

このスキルからの報告

会話の中で呼び出し元に報告します。別のスキルのディレクトリには書き込みません。

• テスト対象と、実行したモード（customized または pristine）
• リクエストされた各チェック（インストール、起動、ヘルス、UI）について、合格、失敗、またはスキップと、その理由を1行で記載
• 実際に有効化したパッケージと、その正確な参照
• 各結果の裏付けとなるログの抜粋
• クリーンアップの状態：完了、保持、または未依頼

完了条件

報告に、変更したすべてのソースカスタマイズファイル、実行したすべての CLI コマンド、確認したヘルスと UI の証拠、クリーンアップの状態、および呼び出し元がリクエストした各チェックの結果がすべて含まれていれば完了です。