azure-deploy

Name: azure-deploy
Author: microsoft

公式

github.com/microsoftクラウド・DevOps1.6k570.9k 回インストール今日更新

リポジトリ

azure-deploy について

azure-deploy は、準備と検証が完了したアプリケーションを Azure にデプロイするためのスキルです。azd up、azd deploy、terraform apply、az deployment などのコマンドを実行し、エラー処理と検証の手順を含みます。事前に azure-prepare と azure-validate を完了させる必要があります。

主な機能

01azd up と azd deploy の実行
02デプロイ前チェックリストと RBAC 確認
03レシピに沿ったデプロイ手順
04デプロイ後の設定とエラー処理
05エンドポイントの検証と https URL の報告

活用シーン

01準備済みアプリケーションの Azure へのデプロイ
02既存の Azure デプロイへの更新の反映
03APIM ゲートウェイを含むアプリのデプロイ

MCP 対応

本スキルは、サブスクリプションやリソースグループの一覧取得、azd の実行、ロール割り当ての照会など、Azure MCP ツールを使用します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/microsoft/azure-skills --skill azure-deploy

インストール後、Claude Code で/azure-deployを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/

auth-best-practices.md

global-rules.md

live-role-verification.md

pre-deploy-checklist.md

references/recipes/

README.md

references/recipes/azcli/

errors.md

README.md

verify.md

references/recipes/azd/

ef-migrations.md

errors.md

functions-deploy.md

post-deployment.md

README.md

sql-entra-auth.md

sql-managed-identity.md

verify.md

references/recipes/azd/scripts/

apply-migrations.ps1

apply-migrations.sh

grant-and-migrate.ps1

grant-and-migrate.sh

references/recipes/bicep/

errors.md

README.md

verify.md

references/recipes/cicd/

errors.md

README.md

verify.md

references/recipes/cicd/examples/

azdo-azd.yml

azdo-multistage.yml

github-azd.yml

github-bicep.yml

詳細

Azure のデプロイ

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

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

ルール

azure-prepare と azure-validate の後に実行する
.azure/deployment-plan.md が存在し、ステータスが Validated であること
デプロイ前チェックリストが必須です — デプロイ前チェックリスト
⛔ 破壊的な操作には 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	デプロイ前チェックリスト — すべての手順を必ず完了します	デプロイ前チェックリスト
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 のセットアップ

Markdown 対応

ログインしてコメント

基本情報

作者: microsoft
リポジトリ: microsoft/azure-skills
カテゴリ: クラウド・DevOps
インストール数: 570,936
GitHub スター: 1,603
初回掲載: 2026年2月4日

問題を報告

おすすめの Skills

すべての Skills

lark-apps

open.feishu.cn

732.0k

Miaoda（Spark/Miaoda）アプリの開発とホスティング：アプリの作成、ローカルでのフルスタック開発、クラウドでの生成と反復、クリエイティブデザイン（UI モックアップ／インタラクティブなプロトタイプ／ワイヤーフレーム／ランディングページ／ダッシュボード／スライドデッキ／ビジュアル探索）、AI 関連機能や Feishu プラットフォーム機能、その他の外部機能との統合、ログ／Trace／監視指標／PV／UV の確認、環境変数の管理、アプリのコラボレーターと共同作業権限の設定、アプリのロールとメンバーの管理、自動化トリガー（スケジュール／レコード変更／Webhook／Feishu 承認）。システム・ツール・プラットフォーム・アプリの開発や新規作成、ローカル／クラウドでの開発、変更、デプロイ、公開、リリース、共有可能なリンクの取得、HTML によるページやウェブサイトの作成と Miaoda へのデプロイ、デザイン／モックアップ／プロトタイプ／ワイヤーフレーム／PPT／デッキ／ビジュアル探索を希望する場合に使用。また、Miaoda/Spark/Miaoda アプリ（`/app/app_xxx` または `/page/<token>` 形式のリンク、*.aiforce.cloud 形式の実行時ドメイン）、アプリデータベース、アプリファイルストレージ、公開 API Key、公開範囲、アプリのコラボレーター／開発権限、アプリのロール／ロールメンバー、本番ログ、API リクエスト数、エラー数、レイテンシ、アクセス数、環境変数、Miaoda アプリの自動化タスク／スケジュールトリガー／承認後の自動トリガーに関する場合にも使用。通常のクラウドドライブへのファイルアップロード（lark-drive）、Feishu ドキュメントの編集（lark-doc）、ネイティブのスライド作成（lark-slides）は対象外。

azure-prepare

github.com/microsoft

571.7k

azd ベースの Azure プロジェクトをデプロイ用に準備します。Azure Developer CLI (azd) ワークフロー向けに azure.yaml、インフラストラクチャ (Bicep/Terraform)、Dockerfile を生成します。ユーザーが明示的に azd をデプロイメントツールとして使いたい場合、または既に azure.yaml ファイルが存在する場合にのみ使用してください。非 azd デプロイメント、Python App Service コードのみのデプロイ (python-appservice-deploy を使用)、クラウド間の移行 (azure-cloud-migrate を使用) には使用しないでください。用途：azd 用にアプリを準備、azure.yaml を作成、azd インフラストラクチャを設定、Azure 上でアプリを最新化、azd でデプロイ、関数アプリ、タイマートリガー、Service Bus トリガー、イベント駆動関数、マネージド ID、Bicep を生成、Terraform を生成、Azure に作成してデプロイ。

wizard

github.com/mattpocock

571.5k

人間にしか実行できない手順を案内する、対話型の bash ウィザードを生成します。インフラのプロビジョニング、認証情報や CI シークレットの設定、不慣れなサードパーティ製ダッシュボードの操作、一度限りの移行や切り替えに使用します。エージェント自身が実行できる手順には使用しません。

azure-ai

github.com/microsoft

571.2k

Azure AI（検索、音声、OpenAI、Document Intelligence）で使用します。検索、ベクトル/ハイブリッド検索、音声テキスト変換、テキスト音声変換、トランスクリプション、OCR に対応。用途：AI 検索、クエリ検索、ベクトル検索、ハイブリッド検索、セマンティック検索、音声テキスト変換、テキスト音声変換、トランスクリプション、OCR、テキストを音声に変換。