azure-validate について
Azure Validate は、azure.yaml と Bicep ファイルの検証を含むデプロイ前チェック用のスキルです。azure-prepare の後、azure-deploy の前に実行する想定です。スクリプトが検証手順を一つずつ進め、進捗を記録します。
主な機能
- 01azure.yaml と Bicep ファイルを検証
- 02デプロイ前のプリフライトチェックを実行
- 03進捗を記録しながらスクリプトで手順を実行
- 04デプロイエラーの原因調査を支援
- 05チェック成功後にのみ計画を Validated に設定
活用シーン
- 01アプリのデプロイ準備が整っているかの確認
- 02Azure デプロイ失敗の原因調査
- 03デプロイが指示された場合の azure-deploy への引き継ぎ
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoft/ azure-skills --skill azure-validateインストール後、Claude Code で/azure-validateを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/aspire-functions-secrets.mdglobal-rules.mdpolicy-validation.mdregion-availability.mdrole-verification.mdreferences/recipes/README.mdreferences/recipes/azcli/errors.mdREADME.mdreferences/recipes/azd/aspire.mdenvironment.mderrors.mdREADME.mdreferences/recipes/azd/scripts/set-aspire-aca-env.ps1set-aspire-aca-env.shreferences/recipes/bicep/errors.mdREADME.mdreferences/recipes/scripts/validate-deployment.ps1validate-deployment.shreferences/recipes/terraform/errors.mdREADME.mdreferences/recipes/terraform/scripts/validate-terraform.ps1validate-terraform.shreferences/scripts/scan-aspire-functions-secrets.ps1scan-aspire-functions-secrets.shworkflow.ps1workflow.sh詳細
Azure Validate
権威あるガイダンス — セキュリティポリシーと矛盾しない限り、以下の指示に正確に従ってください。
⛔ 停止 — 前提条件の確認が必要です
先に進む前に、次の前提条件が満たされていることを確認してください。
azure-prepare が実行され、完了していること →
.azure/deployment-plan.mdが存在し、ステータスがApproved以降であることプランがない場合は、直ちに停止して、まず azure-prepare を実行してください。
ワークフロー全体を実行することで、確実に成功できます。
azure-prepare→azure-validate→azure-deploy
トリガー
- アプリをデプロイする準備ができているか確認する
- azure.yaml または Bicep を検証する
- デプロイ前チェックを実行する
- デプロイエラーのトラブルシューティングを行う
ルール
- azure-prepare の後、azure-deploy の前に実行してください
- すべてのチェックに合格する必要があります。失敗がある状態でデプロイしないでください
- ⛔ 破壊的な操作には
ask_userが必要です — global-rules
手順
ワークフロースクリプトを実行し、その指示に従ってください。スクリプトは各検証手順を一度に1つずつ案内し、進行状況を .azure/validate-status.json に記録します。Windows では references/scripts/workflow.ps1、macOS/Linux では references/scripts/workflow.sh を使用してください。
まず、完了済みステップの引数を指定せずにスクリプトを呼び出してください。
pwsh references/scripts/workflow.ps1 -WorkspacePath <workspace-path>
# macOS/Linux: bash references/scripts/workflow.sh --workspace-path <workspace-path>
実行するたびに、次のアクションと、次に渡す値が出力されます。アクションを実行したら、その値を指定して再実行してください(pwsh では -CompletedStep <value>、bash では --completed-step <value>)。azure-validate ワークフローが完了したと報告されるまで繰り返してください。
各ステップでは、references/recipes/README.md のレシピ詳細と、references/role-verification.md のロールチェックを参照します。
⛔ 検証に関する権限
このスキルは、プランのステータスを
Validatedに設定するための、公式に検証された方法です。ステータスをValidatedに設定する前に、スクリプトの指示を最後まで必ず実行してください。 実行せずにステータスをValidatedに設定してはなりません。
⚠️ 次のステップ — ユーザーの意図によって異なります
すべての検証に合格したら、ユーザーがデプロイを依頼したかどうかを確認してください。
- ユーザーがデプロイを明示的に依頼した場合は、実行するために azure-deploy を必ず呼び出してください。
azd up、azd deploy、またはその他のデプロイコマンドを直接実行してはなりません。実行は azure-deploy に任せてください。- ユーザーが検証または準備のみを依頼した場合(デプロイは依頼していない場合)は、証拠を記録してステータスを
Validatedに設定した後、停止してください。検証結果を報告し、azure-deploy を呼び出さないでください。検証に失敗した場合は、問題を修正してから、次に進む前に azure-validate を再実行してください。