azure-container-registry
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAzure Container Registry Skill
Azure Container Registry 技能
This skill provides expert guidance for Azure Container Registry. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
本技能为Azure Container Registry提供专业指导,涵盖故障排除、最佳实践、决策制定、架构与设计模式、限制与配额、安全、配置、集成与编码模式以及部署。它结合了本地快速参考内容与远程文档获取能力。
How to Use This Skill
如何使用本技能
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,), useL35-L120with the specified lines. For categories with file links (e.g.,read_file), use[security.md](security.md)on the linked reference fileread_file
IMPORTANT for Agent: Ifis more than 3 months old, suggest the user pull the latest version from the repository. Ifmetadata.generated_attools are not available, suggest the user install it: Installation Guidemcp_microsoftdocs
This skill requires network access to fetch documentation content:
- Preferred: Use with query string
mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.from=learn-agent-skill - Fallback: Use with query string
fetch_webpage. Returns Markdown.from=learn-agent-skill&accept=text/markdown
Agent 重要提示:使用下方的分类索引定位相关章节。对于带有行范围的分类(如),使用L35-L120读取指定行。对于带有文件链接的分类(如read_file),使用[security.md](security.md)读取链接的参考文件read_file
本技能需要网络访问权限来获取文档内容:
- 首选方式:使用,查询字符串为
mcp_microsoftdocs:microsoft_docs_fetch,返回Markdown格式内容。from=learn-agent-skill - 备用方式:使用,查询字符串为
fetch_webpage,返回Markdown格式内容。from=learn-agent-skill&accept=text/markdown
Category Index
分类索引
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L52 | Diagnosing and fixing ACR issues: health checks, error codes, login/auth, network and performance problems, transfer/streaming/cache failures, logs, Arc/connected registry, and CMK encryption. |
| Best Practices | L53-L60 | Best practices for ACR operations: managing public image dependencies, safe image deletion and storage cleanup, and robust image tagging/versioning strategies. |
| Decision Making | L61-L66 | Guidance on choosing Kubernetes auth methods (managed identity, service principals, workload identity) for ACR and migrating image signing from Docker Content Trust to Notary Project. |
| Architecture & Design Patterns | L67-L74 | Patterns for ACR performance and governance: caching image pulls, geo-replication strategies, connected registries for edge/offline, and gated import workflows for public images. |
| Limits & Quotas | L75-L80 | ACR SKU comparisons, throughput and request limits, and how image/storage capacity, retention, and performance quotas work across registry tiers. |
| Security | L81-L120 | Securing ACR with auth, RBAC/ABAC, network controls, encryption, image signing/verification, policies, Defender scans, and managed identity/Key Vault integration. |
| Configuration | L121-L138 | Configuring ACR behavior: caching, purge/retention/soft delete, delete locks, webhooks, metrics/logs, and defining/scheduling multi-step ACR Tasks with YAML and agent pools. |
| Integrations & Coding Patterns | L139-L154 | How to integrate ACR with ACI, AKS, Helm, ORAS, Buildpacks, ACR Transfer, GitHub Actions, Notation, Key Vault, and webhooks for image access, builds, signing, and automation |
| Deployment | L155-L160 | Using ARM templates to automate ACR quick tasks and data transfer, and deploying/managing ACR connected registries via Azure Arc extension |
| 分类 | 行号 | 描述 |
|---|---|---|
| 故障排除 | L37-L52 | 诊断并修复ACR问题:健康检查、错误代码、登录/认证、网络与性能问题、传输/流式处理/缓存故障、日志、Arc/连接注册表以及CMK加密。 |
| 最佳实践 | L53-L60 | ACR操作的最佳实践:管理公共镜像依赖项、安全删除镜像与清理存储、以及可靠的镜像标记/版本控制策略。 |
| 决策制定 | L61-L66 | 为ACR选择Kubernetes认证方法(托管身份、服务主体、工作负载身份),以及将镜像签名从Docker Content Trust迁移到Notary Project的指导。 |
| 架构与设计模式 | L67-L74 | 提升ACR性能与治理的模式:缓存镜像拉取、异地复制策略、边缘/离线场景的连接注册表、以及公共镜像的 gated 导入工作流。 |
| 限制与配额 | L75-L80 | ACR SKU对比、吞吐量与请求限制,以及不同注册表层级下镜像/存储容量、保留期和性能配额的工作机制。 |
| 安全 | L81-L120 | 通过认证、RBAC/ABAC、网络控制、加密、镜像签名/验证、策略、Defender扫描以及托管身份/Key Vault集成来保护ACR。 |
| 配置 | L121-L138 | 配置ACR行为:缓存、清理/保留/软删除、删除锁定、Webhook、指标/日志,以及使用YAML和代理池定义与调度多步骤ACR Tasks。 |
| 集成与编码模式 | L139-L154 | 如何将ACR与ACI、AKS、Helm、ORAS、Buildpacks、ACR Transfer、GitHub Actions、Notation、Key Vault和Webhook集成,以实现镜像访问、构建、签名与自动化 |
| 部署 | L155-L160 | 使用ARM模板自动化ACR快速任务与数据传输,以及通过Azure Arc扩展部署/管理ACR连接注册表 |
Troubleshooting
故障排除
Best Practices
最佳实践
| Topic | URL |
|---|---|
| Manage public image dependencies using ACR | https://learn.microsoft.com/en-us/azure/container-registry/buffer-gate-public-content |
| Follow operational best practices for Azure Container Registry | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-best-practices |
| Delete ACR images safely to manage registry storage | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-delete |
| Apply image tagging and versioning best practices in ACR | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-image-tag-version |
| 主题 | 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 |
Decision Making
决策制定
| Topic | URL |
|---|---|
| Select Kubernetes authentication options for Azure Container Registry | https://learn.microsoft.com/en-us/azure/container-registry/authenticate-kubernetes-options |
| Migrate ACR signing from DCT to Notary Project | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-content-trust-deprecation |
| 主题 | 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 |
Architecture & Design Patterns
架构与设计模式
| Topic | URL |
|---|---|
| Optimize image pulls with ACR artifact cache | https://learn.microsoft.com/en-us/azure/container-registry/artifact-cache-overview |
| Use geo-replication patterns with Azure Container Registry | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-geo-replication |
| Design and use connected registries with ACR | https://learn.microsoft.com/en-us/azure/container-registry/intro-connected-registry |
| Implement gated import workflow for public images in ACR | https://learn.microsoft.com/en-us/azure/container-registry/tasks-consume-public-content |
| 主题 | URL |
|---|---|
| 使用ACR制品缓存优化镜像拉取 | https://learn.microsoft.com/en-us/azure/container-registry/artifact-cache-overview |
| 使用Azure Container Registry的异地复制模式 | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-geo-replication |
| 设计并使用ACR的连接注册表 | https://learn.microsoft.com/en-us/azure/container-registry/intro-connected-registry |
| 在ACR中实现公共镜像的 gated 导入工作流 | https://learn.microsoft.com/en-us/azure/container-registry/tasks-consume-public-content |
Limits & Quotas
限制与配额
| Topic | URL |
|---|---|
| Compare Azure Container Registry SKUs and limits | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-skus |
| Understand storage features and limits in ACR | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-storage |
| 主题 | URL |
|---|---|
| 对比Azure Container Registry的SKU与限制 | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-skus |
| 了解ACR中的存储功能与限制 | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-storage |
Security
安全
Configuration
配置
Integrations & Coding Patterns
集成与编码模式
Deployment
部署
| Topic | URL |
|---|---|
| Queue ACR quick task runs with ARM templates | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-task-run-template |
| Automate ACR Transfer using ARM templates | https://learn.microsoft.com/en-us/azure/container-registry/container-registry-transfer-arm-template |
| Deploy the ACR connected registry Arc extension | https://learn.microsoft.com/en-us/azure/container-registry/quickstart-connected-registry-arc-cli |