azure-deploy
`.azure/deployment-plan.md` とインフラファイルが既に準備済みのアプリケーションに対してAzureデプロイを実行するスキルです。`azd up`、`azd deploy`、`terraform apply`、`az deployment` コマンドをエラー自動回復機能付きで実行し、本番環境への反映を行います。新規アプリの作成やインフラのセットアップが目的の場合は代わりに `azure-prepare` を使用してください。
description の原文を見る
Execute Azure deployments for ALREADY-PREPARED applications that have existing .azure/deployment-plan.md and infrastructure files. DO NOT use this skill when the user asks to CREATE a new application — use azure-prepare instead. This skill runs azd up, azd deploy, terraform apply, and az deployment commands with built-in error recovery. Requires .azure/deployment-plan.md from azure-prepare and validated status from azure-validate. WHEN: \"run azd up\", \"run azd deploy\", \"execute deployment\", \"push to production\", \"push to cloud\", \"go live\", \"ship it\", \"bicep deploy\", \"terraform apply\", \"publish to Azure\", \"launch on Azure\". DO NOT USE WHEN: \"create and deploy\", \"build and deploy\", \"create a new app\", \"set up infrastructure\", \"create and deploy to Azure using Terraform\" — use azure-prepare for these.
SKILL.md 本文
Azure Deploy
権威的なガイダンス — 必須遵守事項
前提条件: azure-validate スキルは、このスキルを実行する前に、必ず 呼び出され、完了し、ステータスが
Validatedである必要があります。
⛔ 停止 — 前提条件確認必須 続行する前に、両方の前提条件が満たされていることを確認してください:
- azure-prepare が呼び出され完了した →
.azure/deployment-plan.mdが存在する- 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 Gateway: このスキルを使用して、azure-prepare 中に APIM/AI ゲートウェイインフラストラクチャが既に作成されているアプリケーションをデプロイします。APIM リソースの作成または変更については、APIM デプロイメントガイドを参照してください。AI ガバナンスポリシーについては、azure-aigateway スキルを呼び出してください。
ルール
- azure-prepare および azure-validate の後に実行
.azure/deployment-plan.mdは、ステータスValidatedで存在する必要があります- デプロイ前チェックリスト必須 —
Pre-Deploy Checklist - ⛔ 破壊的操作には
ask_userが必須 —global-rules - スコープ:デプロイメント実行のみ — このスキルは、
azd up、azd deploy、terraform apply、およびaz deploymentコマンド実行を統制します。これらのコマンドは、このスキルのエラーリカバリーおよび検証パイプラインを通じて実行されます。
ステップ
| # | アクション | リファレンス |
|---|---|---|
| 1 | プラン確認 — .azure/deployment-plan.md を読み、ステータス = Validated かつ Validation Proof セクションが入力されていることを確認 | .azure/deployment-plan.md |
| 2 | デプロイ前チェックリスト — すべてのステップを完了する必須 | Pre-Deploy Checklist |
| 3 | レシピ読み込み — .azure/deployment-plan.md の recipe.type に基づいて | recipes/README.md |
| 4 | RBAC ヘルスチェック — Container Apps + ACR でマネージド ID:azd provision --no-prompt を実行し、続行前に AcrPull ロールが伝播していることを確認(チェックリスト参照) | Pre-Deploy Checklist — Container Apps RBAC |
| 5 | デプロイ実行 — レシピステップに従う | Recipe README |
| 6 | デプロイ後 — SQL マネージド ID を設定し、該当する場合は EF マイグレーションを適用 | Post-Deployment |
| 7 | エラー処理 — レシピの errors.md を参照 | — |
| 8 | 成功確認 — デプロイメント完了とエンドポイントへのアクセス確認 | Verification |
| 9 | ライブロール確認 — Azure に問い合わせて、プロビジョニングされた RBAC ロールが正しく十分であることを確認 | live-role-verification.md |
| 10 | 結果レポート — デプロイされたエンドポイント URL を完全修飾 https:// リンクとしてユーザーに提示 | Verification |
⛔ URL フォーマットルール
ユーザーにエンドポイント URL を提示する場合、
https://スキーム(例:https://myapp.azurewebsites.net、myapp.azurewebsites.netではなく)で完全修飾 URL を 常に 使用する必要があります。多くの Azure CLI コマンドはスキームなしのベア ホスト名を返します — 提示する前に常にhttps://を先頭に追加してください。
⛔ 検証証拠確認
プランをチェックする場合、Validation Proof セクション(セクション 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 セットアップ
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- microsoft
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/microsoft/azure-skills / ライセンス: MIT
関連スキル
superpowers-streamer-cli
SuperPowers デスクトップストリーマーの npm パッケージをインストール、ログイン、実行、トラブルシューティングできます。ユーザーが npm から `superpowers-ai` をセットアップしたい場合、メールまたは電話でサインインもしくはアカウント作成を行いたい場合、ストリーマーを起動したい場合、表示されたコントロールリンクを開きたい場合、後で停止したい場合、またはソースコードへのアクセスなしに npm やランタイムの一般的な問題から復旧したい場合に使用します。
catc-client-ops
Catalyst Centerのクライアント操作・監視機能 - 有線・無線クライアントのリスト表示・フィルタリング、MACアドレスによる詳細なクライアント検索、クライアント数分析、時間軸での分析、SSIDおよび周波数帯によるフィルタリング、無線トラブルシューティング機能を提供します。MACアドレスやIPアドレスでのクライアント検索、サイト別やSSID別のクライアント数集計、無線周波数帯の分布分析、Wi-Fi信号の問題調査が必要な場合に活用できます。
ci-cd-and-automation
CI/CDパイプラインの設定を自動化します。ビルドおよびデプロイメントパイプラインの構築または変更時に使用できます。品質ゲートの自動化、CI内のテストランナー設定、またはデプロイメント戦略の確立が必要な場合に活用します。
shipping-and-launch
本番環境へのリリース準備を行います。本番環境へのデプロイ準備が必要な場合、リリース前チェックリストが必要な場合、監視機能の設定を行う場合、段階的なロールアウトを計画する場合、またはロールバック戦略が必要な場合に使用します。
linear-release-setup
Linear Releaseに向けたCI/CD設定を生成します。リリース追跡の設定、LinearのCIパイプライン構築、またはLinearリリースとのデプロイメント連携を実施する際に利用できます。GitHub Actions、GitLab CI、CircleCIなど複数のプラットフォームに対応しています。
tracking-application-response-times
API エンドポイント、データベースクエリ、サービスコール全体にわたるアプリケーションのレスポンスタイムを追跡・最適化できます。パフォーマンス監視やボトルネック特定の際に活用してください。「レスポンスタイムを追跡する」「API パフォーマンスを監視する」「遅延を分析する」といった表現で呼び出せます。