Docker 镜像仓库镜像同步如何做

镜像同步是将一个镜像仓库中的镜像自动、安全、可控地复制到另一仓库的过程，基于Registry协议迁移元数据与层数据，需保障完整性、权限及网络稳定性；常见方式包括docker pull/push脚本、skopeo copy、Harbor复制规则及云厂商原生同步，关键在于权限配置、标签对齐、TLS处理、范围控制及同步后digest校验与拉取验证。

镜像同步是把一个镜像仓库里的镜像自动、安全、可控地复制到另一个仓库的过程，常见于多环境部署、灾备、混合云或加速国内拉取等场景。它不是简单拷贝文件，而是基于 Registry 协议的元数据+层数据迁移，需兼顾完整性、权限和网络稳定性。

同步方式选择：按需求匹配方案

不同场景适用不同同步机制：

1. 跨 Registry 推送（手动/脚本）：适合少量镜像、一次性迁移或 CI/CD 流水线中触发同步。用 docker pull + docker tag + docker push 组合完成，依赖源仓库可读、目标仓库可写，且本地有足够磁盘空间暂存镜像。
2. skopeo copy（推荐轻量同步）：不依赖 Docker daemon，直接在 Registry 间传输，支持断点续传、压缩、平台过滤（如只同步 linux/amd64）。命令示例：

   skopeo copy docker://registry-a.example.com/app:v1.2 docker://registry-b.example.com/app:v1.2

3. Harbor 跨项目/跨实例复制（企业级首选）：通过 Web UI 或 API 配置“复制规则”，支持定时、事件触发（如镜像推送后自动同步）、过滤标签（如仅同步 v[0-9]+.[0-9]+.[0-9]+）、校验一致性。内置鉴权、重试、日志审计，适合生产环境。
4. 镜像仓库原生同步能力：AWS ECR 支持跨区域复制，Google Artifact Registry 支持跨地域镜像同步，阿里云 ACR 提供“镜像全球同步”功能——这些云服务内建同步管道，无需运维中间组件，但绑定厂商生态。

关键配置要点：确保同步可靠运行

无论选哪种方式，以下配置缺一不可：

1. 源与目标仓库的访问权限：源仓库需开放 pull 权限（如 Harbor 中为“访客”角色），目标仓库需配置对应 push 权限（如机器人账号或服务账户 token），避免硬编码密码，优先使用短期 token 或 OIDC 集成。
2. 镜像标签策略对齐：同步前确认源镜像是否带有效 tag（避免只同步 latest 导致不可追溯）；目标端建议保留原始 tag，也可按规则重写（如添加环境前缀：prod/app:v1.2）。
3. 网络与 TLS 处理：若涉及私有 Registry，确保同步节点能解析域名、访问端口（如 443 或自定义端口），并信任源/目标仓库的证书。对不安全 Registry（HTTP），skopeo 需加 --insecure-policy，Docker 需提前配置 insecure-registries。
4. 同步范围控制：避免全量同步造成带宽/存储压力。可通过 manifest 过滤（如只同步特定架构）、正则匹配 tag（如 ^v[0-9]+..*）、或限定 repository 名称（如仅同步 team/frontend）。

验证与监控：同步完成后必须做的事

同步成功 ≠ 镜像可用。务必执行验证：

1. 在目标仓库检查 manifest 是否存在：curl -X GET "https://registry-b.example.com/v2/app/manifests/v1.2" -H "Accept: application/vnd.docker.distribution.manifest.v2+json"
2. 比对源与目标镜像 digest（SHA256）是否一致：skopeo inspect docker://registry-a.example.com/app:v1.2 | jq .Digest 和 skopeo inspect docker://registry-b.example.com/app:v1.2 | jq .Digest
3. 尝试从目标仓库拉取并运行容器：docker pull registry-b.example.com/app:v1.2 && docker run --rm registry-b.example.com/app:v1.2
4. 设置基础监控：记录同步任务耗时、失败次数、镜像大小偏差。Harbor 自带复制任务日志；自建脚本可用 Prometheus + Pushgateway 上报指标。

不复杂但容易忽略——同步本质是可信通道上的精确搬运，重点不在“能不能通”，而在“搬得准不准、留不留痕、出错能不能回退”。