azure-deployment-environments について
azure-deployment-environments は、Azure Deployment Environments を利用する開発者やプラットフォームチーム向けのガイダンススキルです。ローカル参照情報とリモート取得するドキュメントを組み合わせ、構成、セキュリティ、アーキテクチャ、トラブルシューティング、CI/CD デプロイを扱います。
主な機能
- 01カスタムイメージのデプロイトラブルシューティング
- 02カタログ構成のガイダンス
- 03環境とカタログの設定
- 04RBAC とマネージド ID のガイダンス
- 05CI/CD デプロイの参照情報
活用シーン
- 01カスタムイメージのデプロイ失敗の診断
- 02再利用可能な環境カタログの構成
- 03アクセス権と開発センターの ID 設定
- 04CI/CD による環境デプロイの自動化
MCP 対応
ドキュメント取得には mcp_microsoftdocs の microsoft_docs_fetch ツールを推奨しています。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-deployment-environmentsインストール後、Claude Code で/azure-deployment-environmentsを入力して読み込まれたか確認します。
詳細
Azure Deployment Environments スキル
このスキルでは、Azure Deployment Environments に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイを扱います。ローカルのクイックリファレンスコンテンツと、リモートドキュメントの取得機能を組み合わせています。
このスキルの使い方
エージェントに関する重要事項: 関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲が記載されているカテゴリ(例:
L35-L120)では、指定された行をread_fileで読み取ってください。ファイルリンクが記載されているカテゴリ(例:[security.md](security.md))では、リンク先の参照ファイルをread_fileで読み取ってください。
エージェントに関する重要事項:
metadata.generated_atが3か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocsツールが利用できない場合は、インストールするようユーザーに提案してください:インストールガイド
このスキルでドキュメントの内容を取得するには、ネットワークアクセスが必要です。
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用します。Markdown が返されます。 - フォールバック:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用します。Markdown が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L41 | Azure Deployment Environments でのカスタムイメージのデプロイ失敗を診断して解決します。一般的なエラーパターン、確認すべきログ、修正手順を含みます。 |
| ベストプラクティス | L42-L46 | Azure Deployment Environments のカタログの整理と構成に関するガイダンスです。スケーラブルで保守しやすいカタログを実現するための、リポジトリのレイアウト、テンプレートのグループ化、命名、ガバナンスを扱います。 |
| 意思決定 | L47-L51 | Azure Deployment Environments の廃止または置き換えを計画、実行、管理するためのガイダンスです。移行と廃止に関する考慮事項を含みます。 |
| アーキテクチャと設計パターン | L52-L56 | Azure Deployment Environments の回復性とスケーラビリティに優れたアーキテクチャを設計するためのガイダンスです。フォールトトレランス、高可用性、冗長性、堅牢な環境設計のベストプラクティスを含みます。 |
| 制限とクォータ | L57-L61 | Azure Deployment Environments のリソース制限に対するクォータの増加を要求して管理します。容量制約への対処方法とサポートリクエストの申請方法を含みます。 |
| セキュリティ | L62-L69 | Deployment Environments の RBAC と ID の設定です。ロールの計画と割り当て、マネージド ID の構成、REST API に対する認証を扱います。 |
| 構成 | L70-L82 | Azure Deployment Environments の environment.yaml の定義、開発センターとプロジェクトの構成、カタログ、環境の種類、CLI/ARM のセットアップ、自動削除、ADE CLI の環境変数を扱います。 |
| 統合とコーディングパターン | L83-L89 | Azure Developer CLI と ADE CLI を使用した環境の作成、カスタムコンテナーイメージのビルド、Azure Deployment Environments のカスタムイメージワークフローの管理について説明します。 |
| デプロイ | L90-L93 | Azure Pipelines や GitHub Actions などの CI/CD ツールと Azure Deployment Environments を使用して、テンプレートからの環境作成、更新、デプロイを自動化する方法を説明します。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure Deployment Environments でのカスタムイメージのデプロイ失敗を診断する | https://learn.microsoft.com/en-us/azure/deployment-environments/troubleshoot-custom-image-logs-errors |
ベストプラクティス
| トピック | URL |
|---|---|
| Azure Deployment Environments のカタログを効率よく構成する | https://learn.microsoft.com/en-us/azure/deployment-environments/best-practice-catalog-structure |
意思決定
| トピック | URL |
|---|---|
| Azure Deployment Environments の廃止と置き換えを計画する | https://learn.microsoft.com/en-us/azure/deployment-environments/deployment-environments-retirement-guide |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| Azure Deployment Environments の回復性に優れたアーキテクチャを設計する | https://learn.microsoft.com/en-us/azure/deployment-environments/concept-reliability-deployment-environments |
制限とクォータ
| トピック | URL |
|---|---|
| ADE リソースの制限に対するクォータ増加をリクエストする | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-request-quota-increase |
セキュリティ
| トピック | URL |
|---|---|
| Deployment Environments の Azure RBAC ロールを計画する | https://learn.microsoft.com/en-us/azure/deployment-environments/concept-deployment-environments-role-based-access-control |
| Azure Deployment Environments REST API で認証する | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-authenticate |
| Azure Deployment Environments の dev center 用にマネージド ID を構成する | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-managed-identity |
| Azure Deployment Environments へのアクセスに RBAC ロールを割り当てる | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-manage-deployment-environments-access |
構成
統合とコーディングパターン
| トピック | URL |
|---|---|
| Azure Developer CLI を使用して ADE 環境を作成する | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-azure-developer-cli-deployment-environments |
| Azure Deployment Environments でカスタムコンテナーイメージを使用する | https://learn.microsoft.com/en-us/azure/deployment-environments/how-to-configure-extensibility-model-custom-image |
| カスタムイメージのワークフローで ADE CLI コマンドを使用する | https://learn.microsoft.com/en-us/azure/deployment-environments/reference-deployment-environment-cli |
デプロイ
| トピック | URL |
|---|---|
| CI/CD 用に ADE を Azure Pipelines と統合する | https://learn.microsoft.com/en-us/azure/deployment-environments/tutorial-deploy-environments-in-cicd-azure-devops |