用途:部署私有 Docker 镜像仓库,配置认证与 TLS,并跨多个镜像仓库管理、推送和同步镜像。
主要能力:支持 docker/ecr/gcr/acr 等仓库类型;参数包括 registry_type(默认 docker)、auth(默认 true,启用认证)、tls(默认 true,启用 TLS)。支持私有 registry 搭建(通过 Docker Compose 运行 registry:2 并挂载 registry_data、auth、certs 卷,设置 htpasswd 认证和 TLS 证书)、认证文件生成、登录、打标签、推送、拉取、列出仓库目录与标签、按 digest 删除镜像,以及用 skopeo 在两个 registry 之间复制或同步标签。同时覆盖 Docker Hub、GHCR、ECR、GCR、ACR 的认证方式。
使用方式:调用 Skill("docker-registry")。生成认证文件示例:docker run --rm --entrypoint htpasswd httpd:alpine -Bbn admin password > auth/htpasswd。登录示例:docker login;echo $GITHUB_TOKEN | docker login ghcr.io -u USERNAME --password-stdin;aws ecr get-login-password | docker login --username AWS --password-stdin <account>.dkr.ecr.<region>.amazonaws.com。推送示例:docker tag myapp:latest registry.example.com/myapp:latest 与 docker push registry.example.com/myapp:latest。同步示例:skopeo copy docker://source-registry/image:tag docker://dest-registry/image:tag;skopeo sync --src docker --dest docker source-registry/image dest-registry/。资源包括 assets/docker-compose-registry.yaml 与 scripts/registry-setup.sh。
适用场景:需要私有镜像分发、多云仓库统一管理、镜像跨仓库迁移或同步的团队。
限制:官方资料未提供价格、平台支持范围、性能数据或具体效果;错误处理表将 unauthorized、manifest unknown、denied: access、TLS handshake 分别对应为凭据错误、镜像不存在、权限不足、证书问题。