azure-deploy

Azure のデプロイ

正式なガイダンス — 必ず遵守してください

前提条件：このスキルを実行する前に、azure-validate スキルを呼び出して完了し、ステータスが Validated になっている必要があります。

⛔ 停止 — 前提条件の確認が必要です 続行する前に、以下の前提条件が両方とも満たされていることを確認してください。

1. azure-prepare が呼び出され、完了している → .azure/deployment-plan.md が存在する
2. azure-validate が呼び出され、合格している → プランのステータスが Validated

どちらか一方でも満たされていない場合は、直ちに停止してください。

• プランがない場合 → まず azure-prepare スキルを呼び出します
• ステータスが Validated でない場合 → まず azure-validate スキルを呼び出します

⛔ プランのステータスを手動で更新しないでください

プランのステータスを自分で Validated に変更することは禁止されています。実際の検証チェックを実行した後に、このステータスを設定できるのは azure-validate スキルだけです。検証を実行せずにステータスを更新すると、デプロイに失敗します。

アプリの準備ができていると決めつけないでください。時間を節約するために検証を省略しないでください。手順を省略すると、デプロイに失敗します。次の完全なワークフローにより、確実に成功できます。

azure-prepare → azure-validate → azure-deploy

トリガー

次のことをユーザーが求めている場合に、このスキルを有効にします。

• すでに準備済みのアプリケーション（azure.yaml と infra/ が存在する）のデプロイを実行する
• 既存の Azure デプロイに更新をプッシュする
• 準備済みのプロジェクトで azd up、azd deploy、または az deployment を実行する
• すでにビルド済みのコードを本番環境にリリースする
• すでに API Management（APIM）ゲートウェイのインフラストラクチャを含むアプリケーションをデプロイする

対象範囲：このスキルはデプロイを実行します。アプリケーションの作成、インフラストラクチャコードの生成、プロジェクトのひな形作成は行いません。これらの作業には azure-prepare を使用してください。

APIM / AI ゲートウェイ：azure-prepare の実行時に APIM/AI ゲートウェイのインフラストラクチャがすでに作成されているアプリケーションのデプロイには、このスキルを使用してください。APIM リソースの作成または変更については、APIM デプロイガイドを参照してください。AI ガバナンスポリシーについては、azure-aigateway スキルを呼び出してください。

ルール

1. azure-prepare と azure-validate の後に実行する
2. .azure/deployment-plan.md が存在し、ステータスが Validated であること
3. デプロイ前チェックリストが必須です — デプロイ前チェックリスト
4. ⛔ 破壊的な操作には ask_user が必要です — global-rules
5. 対象範囲：デプロイの実行のみ — azd up、azd deploy、terraform apply、az deployment コマンドの実行は、このスキルの責任範囲です。これらのコマンドは、このスキルのエラー復旧および検証パイプラインを通じて実行します。

---

手順

#	アクション	参照
1	計画を確認 — .azure/deployment-plan.md を読み、ステータスが Validated であり、Validation Proof セクションに内容が記載されていることを確認します	.azure/deployment-plan.md
2	デプロイ前チェックリスト — すべての手順を必ず完了します	デプロイ前チェックリスト
3	レシピを読み込む — .azure/deployment-plan.md の recipe.type に基づいて選択します	recipes/README.md
4	RBAC ヘルスチェック — Container Apps + ACR でマネージド ID を使用する場合は、azd provision --no-prompt を実行し、続行する前に AcrPull ロールが反映されていることを確認します（チェックリストを参照）	デプロイ前チェックリスト — Container Apps RBAC
5	デプロイを実行 — レシピの手順に従います	レシピの README
6	デプロイ後の作業 — 該当する場合は、SQL マネージド ID を構成し、EF マイグレーションを適用します	デプロイ後
7	エラーに対処 — レシピの errors.md を参照します	—
8	成功を確認 — デプロイが完了し、エンドポイントにアクセスできることを確認します	検証
9	ロールをライブ検証 — Azure に問い合わせ、プロビジョニングされた RBAC ロールが適切かつ十分であることを確認します	live-role-verification.md
10	結果を報告 — デプロイしたエンドポイント URL を、完全な https:// リンクとしてユーザーに提示します	検証

⛔ URL 形式のルール

エンドポイント URL をユーザーに提示する際は、必ず https:// スキームを含む完全な URL を使用してください（例：https://myapp.azurewebsites.net。myapp.azurewebsites.net ではありません）。多くの Azure CLI コマンドはスキームのないホスト名を返します。提示する前に、必ず https:// を付けてください。

⛔ 検証証跡の確認

計画を確認する際は、Validation Proof セクション（Section 7）に、実行したコマンドとタイムスタンプを含む実際の検証結果が記載されていることを確認してください。このセクションが空の場合、検証が省略されています。まず azure-validate スキルを実行してください。

SDK クイックリファレンス

• Azure Developer CLI: azd
• Azure Identity: Python | .NET | TypeScript | Java

MCP ツール

ツール	用途
mcp_azure_mcp_subscription_list	利用可能なサブスクリプションを一覧表示します
mcp_azure_mcp_group_list	サブスクリプション内のリソースグループを一覧表示します
mcp_azure_mcp_azd	AZD コマンドを実行します
azure__role	ライブ RBAC 検証のためにロール割り当てを一覧表示します（手順 9）

参照資料

• トラブルシューティング - よくある問題と解決策
• デプロイ後の手順 - SQL + EF Core のセットアップ