mcpField
A
azure-container-registry

azure-container-registry

github.com/microsoftdocs云与 DevOps796244 次安装3 天前更新
代码仓库

关于 azure-container-registry

azure-container-registry 是面向 Azure Container Registry 运维者的指导技能，结合本地速查内容与网络文档，涵盖故障排查、安全、架构、配置和部署。

主要功能

  1. 01ACR 故障排查指南
  2. 02安全与访问控制参考
  3. 03架构和设计模式
  4. 04配置与部署指南
  5. 05限制、配额和最佳实践

适用场景

  1. 01诊断注册表登录或网络问题
  2. 02规划镜像安全和访问控制
  3. 03选择异地复制或连接注册表
  4. 04配置 ACR Tasks 和集成

MCP 相关

该技能可通过 mcp_microsoftdocs 的 microsoft_docs_fetch 工具获取 Microsoft 文档，也说明了网页抓取备用方式。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-container-registry

安装后在 Claude Code 中输入/azure-container-registry确认已加载。

详细介绍

Azure Container Registry 技能

此技能为 Azure Container Registry 提供专业指导，涵盖故障排除、最佳实践、决策制定、架构与设计模式、限制与配额、安全、配置、集成与编码模式，以及部署。它结合了本地快速参考内容和远程文档获取功能。

如何使用此技能

IMPORTANT（面向 Agent）：使用下方的类别索引定位相关章节。对于带有行范围的类别（例如 L35-L120），请使用 read_file 读取指定行。对于带有文件链接的类别（例如 [security.md](security.md)），请使用 read_file 读取链接指向的参考文件。

IMPORTANT（面向 Agent）：如果 metadata.generated_at 的时间超过 3 个月，请建议用户从仓库拉取最新版本。如果 mcp_microsoftdocs 工具不可用，请建议用户安装该工具：安装指南

此技能需要网络访问权限来获取文档内容：

  • 首选：使用 mcp_microsoftdocs:microsoft_docs_fetch，并在查询字符串中添加 from=learn-agent-skill。返回 Markdown。
  • 备用：使用 fetch_webpage，并在查询字符串中添加 from=learn-agent-skill&accept=text/markdown。返回 Markdown。

类别索引

类别行说明
故障排除L37-L52诊断和修复 ACR 问题：运行状况检查、错误代码、登录/身份验证、网络、性能、任务日志、传输、工件缓存/流式处理、Arc 扩展和 CMK 问题。
最佳实践L53-L61ACR 操作最佳实践：管理公共映像依赖项、安全删除映像、标记/版本控制策略，以及保护注册表、映像和访问权限。
决策制定L62-L68选择 ACR 的 Kubernetes 身份验证方法、确定异地复制策略，以及将映像签名从 Docker Content Trust 迁移到 Notary Project 的指导。
架构与设计模式L69-L74ACR 性能与治理模式：缓存映像拉取、异地复制策略、适用于边缘/脱机场景的连接注册表，以及公共映像的门控导入工作流。
限制与配额L75-L80ACR SKU、性能和功能限制的详细信息，以及映像存储容量、存储库数量和大小配额的计算与实施方式。
安全L81-L120保护 Azure Container Registry：身份验证方法（Entra、托管标识、令牌）、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，快速诊断 ACRhttps://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 Projecthttps://learn.microsoft.com/en-us/azure/container-registry/container-registry-content-trust-deprecation
决定是否以及如何使用 ACR 地理复制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 服务访问受网络限制的 ACRhttps://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
配置跨租户 AKS 身份验证以访问 Azure Container Registryhttps://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 服务主体访问 ACRhttps://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 的托管标识身份验证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 Trusthttps://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
通过托管标识从 ACR Tasks 访问 Key Vault 机密https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tasks-authentication-key-vault
为 ACR Tasks 配置托管标识https://learn.microsoft.com/en-us/azure/container-registry/container-registry-tasks-authentication-managed-identity
在 ACR Tasks 中使用托管标识进行跨注册表身份验证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
对 ACR 应用 Azure Policy 合规性控制https://learn.microsoft.com/en-us/azure/container-registry/security-controls-policy
迁移 ACR Tasks 代理池 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 purge，以自动清理 ACR 中的映像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 Taskshttps://learn.microsoft.com/en-us/azure/container-registry/container-registry-tasks-scheduled
为构建工作流配置多步骤 ACR Taskshttps://learn.microsoft.com/en-us/azure/container-registry/container-registry-tutorial-multistep-task
为映像事件配置 Azure Container Registry Webhookhttps://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 Tasks 配置专用 Agent 池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
使用托管标识配置 ACR 到 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 chart 存储库https://learn.microsoft.com/en-us/azure/container-registry/container-registry-helm-repos
通过 Azure API 将映像和制品导入 Azure Container Registryhttps://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 Transferhttps://learn.microsoft.com/en-us/azure/container-registry/container-registry-transfer-arm-template
使用 Azure CLI 扩展进行 ACR Transferhttps://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 connected registry Arc 扩展https://learn.microsoft.com/en-us/azure/container-registry/quickstart-connected-registry-arc-cli

评论

支持 Markdown