SuperAPI AI 工具集

azure-container-registry-cli

设计与创作

查看项目

更新于 10-15 21:52

技能介绍

用途:使用 Azure CLI 的 az acr 命令组管理 Azure 容器注册表(ACR)资源,包括注册表生命周期、镜像与制品、云端构建、ACR Tasks、身份验证、令牌、异地复制等。az acr 随核心 Azure CLI 提供,无需扩展;仅导出/导入流水线需要 acrtransfer 扩展。

主要能力:注册表创建/删除/列表/查看/更新;az acr login 为 Docker/Podman 提供凭据;az acr build 在云端构建并推送镜像,无需本地 Docker;az acr import 在服务端复制镜像;repository 与 manifest 命令管理仓库、标签、清单、锁定镜像;task/run 支持 ACR Tasks 触发器、定时器与日志;token/scope-map 提供仓库范围令牌;replication 支持异地复制;network-rule、private-endpoint-connection 管理网络访问;config 管理内容信任、保留策略、软删除;cache/credential-set 配置拉取缓存;webhook 处理推送/删除事件;connected-registry 支持本地与 IoT 场景。

使用方式:先安装 Azure CLI(macOS 用 brew install azure-cli,Linux 用 curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash,Windows 用 winget install Microsoft.AzureCLI),执行 az login 并用 az account set --subscription {subscription-id} 选择订阅。创建注册表:az acr create --resource-group {rg} --name {registry} --sku Standard;登录:az acr login --name {registry};云端构建:az acr build --registry {registry} --image app:v1 .;导入镜像:az acr import --name {registry} --source mcr.microsoft.com/hello-world:latest;列出仓库与标签:az acr repository list --name {registry} --output table、az acr repository show-tags --name {registry} --repository app --orderby time_desc;诊断:az acr check-health --name {registry} --yes。

适用场景:镜像云端构建与自动化、CI/CD 与 AKS 拉取权限、仓库与标签清理、多区域与私有访问、边缘与本地注册表。

限制:生产环境不应启用管理员用户,应使用 Microsoft Entra 身份(AcrPull/AcrPush 等 RBAC 角色)、仓库范围令牌或托管标识;异地复制、专用终结点、保留策略、连接注册表、代理池为 Premium 专属;仓库范围令牌在所有层级可用;支持区域中所有层级的区域冗余自动启用。具体命令语法与示例可参考 auth-and-security、build-and-tasks、images-and-artifacts、networking-and-geo 等参考文件。