azure-container-registry

Azure Container Registry スキル

このスキルでは、Azure Container Registry に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイを扱います。ローカルのクイックリファレンスコンテンツと、リモートドキュメントの取得機能を組み合わせています。

このスキルの使用方法

IMPORTANT for Agent: 関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲があるカテゴリ（例：L35-L120）では、指定された行を read_file で読み込んでください。ファイルへのリンクがあるカテゴリ（例：[security.md](security.md)）では、リンク先の参照ファイルを read_file で読み込んでください。

IMPORTANT for Agent: 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-L52	ACR の問題の診断と解決：ヘルスチェック、エラーコード、ログイン／認証、ネットワーク、パフォーマンス、タスクログ、転送、アーティファクトキャッシュ／ストリーミング、Arc 拡張機能、CMK の問題。
ベストプラクティス	L53-L61	ACR の運用に関するベストプラクティス：パブリックイメージへの依存関係の管理、安全なイメージ削除、タグ付け／バージョン管理戦略、レジストリ、イメージ、アクセスの保護。
意思決定	L62-L68	ACR の Kubernetes 認証方法の選択、geo レプリケーション戦略の決定、Docker Content Trust から Notary Project へのイメージ署名の移行に関するガイダンス
アーキテクチャと設計パターン	L69-L74	ACR のパフォーマンスとガバナンスに関するパターン：イメージプルのキャッシュ、geo レプリケーション戦略、エッジ／オフライン向けの接続レジストリ、パブリックイメージの承認済みインポートワークフロー。
制限とクォータ	L75-L80	ACR SKU、パフォーマンスと機能の制限の詳細に加え、イメージのストレージ容量、リポジトリ数、サイズクォータの計算方法と適用方法。
セキュリティ	L81-L120	Azure Container Registry の保護：認証方法（Entra、マネージド ID、トークン）、RBAC／ABAC、ネットワーク／ファイアウォール／VNet の制御、暗号化キー、イメージの署名／検証、ポリシー／コンプライアンス、Defender のスキャン。
構成	L121-L141	ACR の動作の構成：キャッシュ、保持／ソフト削除、パージ、ロック、IPv6、Webhook、メトリック／ログ、ACR Tasks（YAML、タイマー、パッチ適用、エージェントプール、ワイルドカードキャッシュ）。
統合とコーディングパターン	L142-L159	ACR と Kubernetes、ACI、GitHub Actions、ORAS、ACR Transfer の統合、および認証、プルシークレット、Helm、アーティファクトキャッシュ、Webhook、イメージの署名／検証の構成。
デプロイ	L160-L164	ARM テンプレートを使用した ACR クイックタスクとデータ転送の自動化、および Azure Arc 拡張機能による ACR 接続レジストリのデプロイと管理。

トラブルシューティング

トピック	URL
az acr check-health を実行して ACR をすばやく診断する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-check-health
Azure Container Registry の一般的な問題をトラブルシューティングする	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-faq
az acr check-health のエラーコードと修正方法を確認する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-health-error-reference
Azure Container Registry のタスク実行ログを表示、管理する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tasks-logs
Azure Container Registry Transfer の問題をトラブルシューティングする	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-transfer-troubleshooting
Azure Container Registry のネットワーク接続をトラブルシューティングする	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-troubleshoot-access
ACR のログイン、認証、認可の問題をトラブルシューティングする	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-troubleshoot-login-authn-authz
Azure Container Registry のパフォーマンスの問題を診断して解決する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-troubleshoot-performance
Azure Container Registry のアーティファクトキャッシュの問題をトラブルシューティングする	https://learn.microsoft.com/en-us/azure/container-registry/troubleshoot-artifact-cache
Azure Container Registry のアーティファクトストリーミングの問題を診断して修正する	https://learn.microsoft.com/en-us/azure/container-registry/troubleshoot-artifact-streaming
接続済みレジストリの Arc 拡張機能の問題をトラブルシューティングする	https://learn.microsoft.com/en-us/azure/container-registry/troubleshoot-connected-registry-arc
Azure Container Registry のカスタマー マネージド キーの問題をトラブルシューティングする	https://learn.microsoft.com/en-us/azure/container-registry/tutorial-troubleshoot-customer-managed-keys

ベストプラクティス

トピック	URL
ACR を使用してパブリックイメージの依存関係を管理する	https://learn.microsoft.com/en-us/azure/container-registry/buffer-gate-public-content
Azure Container Registry の運用に関するベストプラクティスに従う	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-best-practices
レジストリのストレージを管理するために ACR イメージを安全に削除する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-delete
ACR でイメージのタグ付けとバージョン管理のベストプラクティスを適用する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-image-tag-version
Azure Container Registry にセキュリティのベストプラクティスを適用する	https://learn.microsoft.com/en-us/azure/container-registry/secure-container-registry

意思決定

トピック	URL
Azure Container Registry の Kubernetes 認証オプションを選択する	https://learn.microsoft.com/en-us/azure/container-registry/authenticate-kubernetes-options
ACR の署名を DCT から Notary Project に移行する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-content-trust-deprecation
ACR の geo-replication をいつ、どのように使用するかを判断する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-geo-replication

アーキテクチャと設計パターン

トピック	URL
ACR で接続済みレジストリを設計、使用する	https://learn.microsoft.com/en-us/azure/container-registry/intro-connected-registry
ACR でパブリックイメージのゲート付きインポートワークフローを実装する	https://learn.microsoft.com/en-us/azure/container-registry/tasks-consume-public-content

制限とクォータ

トピック	URL
Azure Container Registry の SKU の機能と制限を比較する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-skus
Azure Container Registry のイメージストレージの制限を確認する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-storage

セキュリティ

トピック	URL
信頼された Azure サービスがネットワーク制限付き ACR にアクセスできるようにする	https://learn.microsoft.com/en-us/azure/container-registry/allow-access-trusted-services
Azure Container Registry の匿名プルアクセスを有効にする	https://learn.microsoft.com/en-us/azure/container-registry/anonymous-pull-access
Azure Container Registry へのクロステナント AKS 認証を構成する	https://learn.microsoft.com/en-us/azure/container-registry/authenticate-aks-cross-tenant
IP ルールで Azure Container Registry のパブリックアクセスを制限する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-access-selected-networks
Microsoft Entra サービスプリンシパルを使用して ACR にアクセスする	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-auth-service-principal
Azure Container Registry の認証方法を選択して構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-authentication
Azure Container Registry のマネージド ID 認証を構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-authentication-managed-identity
Azure Policy を使用して ACR のコンプライアンスを監査する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-azure-policy
ACR の Microsoft Entra 条件付きアクセス ポリシーを構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-configure-conditional-access
Azure Container Registry の Docker Content Trust を有効にする	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-content-trust
専用データ エンドポイントを使用して ACR トラフィックを保護する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-dedicated-data-endpoints
ACR で受け入れる Microsoft Entra 認証スコープを制御する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-disable-authentication-as-arm
Azure Container Registry アクセスのファイアウォール規則を構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-firewall-rules
Container Registry で Azure ABAC リポジトリのアクセス許可を構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-rbac-abac-repository-permissions
Azure Container Registry の組み込み RBAC ロールのリファレンス	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-rbac-built-in-roles-directory-reference
ACR の組み込み RBAC ロールを割り当てて管理する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-rbac-built-in-roles-overview
Azure Container Registry のカスタム RBAC ロールを作成して割り当てる	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-rbac-custom-roles
Azure Container Registry のサービスタグによるネットワークアクセスを構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-service-tag
マネージド ID を介して ACR Tasks から Key Vault のシークレットにアクセスする	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tasks-authentication-key-vault
ACR Tasks のマネージド ID を構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tasks-authentication-managed-identity
ACR Tasks でレジストリ間認証にマネージド ID を使用する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tasks-cross-registry-authentication
Azure Container Registry でトークンベースのリポジトリ アクセス許可を構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-token-based-repository-permissions
Key Vault 経由で CA 証明書を使用して ACR イメージに署名する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tutorial-sign-trusted-ca
Ratify を使用して AKS のイメージ署名検証を強制する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tutorial-verify-with-ratify-aks
仮想ネットワーク サービス エンドポイントで ACR アクセスを制限する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-vnet
ACR データの流出を防ぐため、アーティファクトのエクスポートを無効にする	https://learn.microsoft.com/en-us/azure/container-registry/data-loss-prevention
信頼されたサービスを使用して ACR Tasks のネットワーク バイパス ポリシーを管理する	https://learn.microsoft.com/en-us/azure/container-registry/manage-network-bypass-policy-for-tasks
ACR の組み込み Azure Policy 定義のリファレンス	https://learn.microsoft.com/en-us/azure/container-registry/policy-reference
接続済みレジストリからプルするためのクライアント トークンを構成する	https://learn.microsoft.com/en-us/azure/container-registry/pull-images-from-connected-registry
Microsoft Defender for Cloud で ACR イメージをスキャンする	https://learn.microsoft.com/en-us/azure/container-registry/scan-images-defender
Azure Policy のコンプライアンス制御を ACR に適用する	https://learn.microsoft.com/en-us/azure/container-registry/security-controls-policy
ACR タスク エージェント プールの RBAC アクセス許可を移行する	https://learn.microsoft.com/en-us/azure/container-registry/tasks-agent-pools-permission-migration
接続済みレジストリの Arc 拡張機能デプロイを保護する	https://learn.microsoft.com/en-us/azure/container-registry/tutorial-connected-registry-arc
Azure Container Registry のカスタマー マネージド暗号化キーを構成する	https://learn.microsoft.com/en-us/azure/container-registry/tutorial-customer-managed-keys
Azure Container Registry でカスタマー マネージド キーを有効にする	https://learn.microsoft.com/en-us/azure/container-registry/tutorial-enable-customer-managed-keys
Azure Container Registry のカスタマー マネージド キーをローテーションして取り消す	https://learn.microsoft.com/en-us/azure/container-registry/tutorial-rotate-revoke-customer-managed-keys

構成

トピック	URL
Azure CLI を使用して ACR でアーティファクトキャッシュを有効化および構成する	https://learn.microsoft.com/en-us/azure/container-registry/artifact-cache-cli
Azure Container Registry でポータルからアーティファクトキャッシュを有効化する	https://learn.microsoft.com/en-us/azure/container-registry/artifact-cache-portal
ACR でイメージを自動クリーンアップするために acr purge を構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-auto-purge
Azure Container Registry のエンドポイントの種類とフラグに関するリファレンス	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-endpoint-reference
Azure Container Registry でイメージとリポジトリのロックを構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-image-lock
Azure Container Registry の IPv6 デュアルスタックエンドポイントを有効化する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-ipv6-dual-stack
Azure Container Registry の保持ポリシーを構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-retention-policy
ACR の論理削除保持ポリシーを構成して使用する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-soft-delete-policy
複数ステップの ACR Tasks を使用してイメージをビルド、テスト、パッチ適用する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tasks-multi-step
Azure Container Registry Tasks の YAML スキーマリファレンス	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tasks-reference-yaml
タイマーを使用して Azure Container Registry Tasks をスケジュールする	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tasks-scheduled
ビルドワークフロー向けに複数ステップの ACR Tasks を構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tutorial-multistep-task
イメージイベント向けに Azure Container Registry の Webhook を構成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-webhook
Azure Container Registry の継続的なパッチ適用を構成する	https://learn.microsoft.com/en-us/azure/container-registry/how-to-continuous-patching
Azure Container Registry の監視メトリックとログに関するリファレンス	https://learn.microsoft.com/en-us/azure/container-registry/monitor-container-registry-reference
ACR タスク専用のエージェントプールを構成する	https://learn.microsoft.com/en-us/azure/container-registry/tasks-agent-pools
ACR アーティファクトキャッシュのワイルドカードルールを構成する	https://learn.microsoft.com/en-us/azure/container-registry/wildcards-artifact-cache

統合とコーディングパターン

トピック	URL
マネージド ID を使用して ACR 間のアーティファクト キャッシュを構成する	https://learn.microsoft.com/en-us/azure/container-registry/artifact-cache-acr-to-acr-cli
サービス プリンシパルを使用して Azure Container Instances に ACR へのアクセスを許可する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-auth-aci
Azure Container Registry にアクセスするための Kubernetes プル シークレットを作成する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-auth-kubernetes
ACR で Helm チャート リポジトリをホストおよび管理する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-helm-repos
Azure API を使用してイメージとアーティファクトを Azure Container Registry にインポートする	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-import-images
ORAS を使用して ACR の OCI アーティファクトとサプライ チェーン アーティファクトを管理する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-manage-artifact
az acr pack build を使用して Buildpacks でイメージをビルドする	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tasks-pack-build
ARM テンプレートを使用して ACR Transfer を自動化する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-transfer-arm-template
Azure CLI 拡張機能で ACR Transfer を使用する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-transfer-cli
Notation を使用して GitHub Actions で ACR イメージをビルド、プッシュ、署名する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tutorial-github-sign-notation-artifact-signing
GitHub Actions ワークフローで署名済み ACR イメージを検証する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tutorial-github-verify-notation-artifact-signing
Azure Key Vault 証明書を使用して Notation で ACR イメージに署名する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tutorial-sign-build-push
Notation と Artifact Signing を使用して ACR イメージに署名し、検証する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tutorial-sign-verify-notation-artifact-signing
統合に ACR webhook JSON スキーマを使用する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-webhook-reference

デプロイ

トピック	URL
ARM テンプレートで ACR クイック タスクの実行をキューに登録する	https://learn.microsoft.com/en-us/azure/container-registry/container-registry-task-run-template
ACR 接続済みレジストリの Arc 拡張機能をデプロイする	https://learn.microsoft.com/en-us/azure/container-registry/quickstart-connected-registry-arc-cli