/sync-docker-image

Sync docker image between registries.

Primary LanguageShellMIT LicenseMIT

同步DockerHub上的镜像仓库到阿里云容器镜像仓库

Docker 的一些服务所在域名被封杀，无法直接访问和拉取镜像。国内的镜像源又宣布停止服务，所以需要一个工具将DockerHub上的镜像同步到阿里云容器镜像仓库。

阿里云容器镜像仓库提供了个人实例服务，支持最多创建300个仓库，而且免费。个人使用完全够满足需求。

阿里云容器镜像仓库地址： https://cr.console.aliyun.com/

支持用命令行触发workflow运行，点此查看方法

Copy.yml 运行介绍

这个工具主要是将 DockerHub 上某个仓库下的某个标签同步到阿里云容器镜像仓库。

  1. 使用阿里云开通个人实例服务，并获取 登录用户名和固定密码

  2. 克隆本仓库，在仓库设置中配置阿里云密码，注意 Name 必须为 DESTINATION_CREDENTIAL 且内容格式必须为 <Username>:<Password> 即用户名和密码之间用冒号分隔。

配置密码页面

配置内容

  1. 在 Actions 页面上选择 copy.yml 点击 Run workflow 填写内容即可运行。

Run Copy workflow

填写说明：

如同步 DockerHub 上的 nginx:1.13 到 阿里云容器镜像仓库 registry.cn-beijing.aliyuncs.com/ikrong/nginx:1.13，则填写如下：

# 镜像源 (Registry)
source: docker.io
# 目标源 (Registry)
destination: registry.cn-beijing.aliyuncs.com
# 仓库及标签 (格式 repo:tag)
source_repo: nginx:1.13
# 目标仓库及标签 (格式 repo:tag)
destination_repo: ikrong/nginx:1.13

必须要填写仓库及标签

Sync.yml 运行介绍

这个工具主要是将 DockerHub 上某个仓库下的所有标签全部同步到阿里云容器镜像仓库。

  1. 配置密码同上

  2. 在 Actions 页面上选择 sync.yml 点击 Run workflow 填写内容即可运行。

RUN Sync workflow

填写说明：

如同步 DockerHub 上的 nginx 的所有标签到阿里云容器镜像仓库 registry.cn-beijing.aliyuncs.com/ikrong/nginx，则填写如下：

# 镜像源 (Registry)
source: docker.io
# 目标源 (Registry)
destination: registry.cn-beijing.aliyuncs.com
# 仓库 (格式 repo)
source_repo: nginx
# 目标Scope (格式 scope)
destination_scope: ikrong

只需要填写需要同步的仓库和目标仓库所在的scope

使用命令行直接同步镜像

现在提供脚本 exec.sh 可以在linux或者macos上运行，下面介绍运行方法：

  1. 命令行上基于 github-cli 实现的，所以需要先安装 github-cli 工具
# 快速安装方法
curl -sS https://webi.sh/gh | sh
# 或者可以查看 github-cli 文档自己下载安装
# https://github.com/cli/cli?#installation
  1. 安装 github-cli 后需要登陆
# 登陆命令
gh auth login

  1. fork本仓库，并且按照 上面copy.yml中密码相关配置 进行配置

  2. 使用git clone你fork后的仓库，然后开始执行根目录下的 exec.sh 文件，注意文件的执行权限

  3. 命令行运行 copy.yml workflow

以将 nginx:1.13 复制到 registry.cn-beijing.aliyuncs.com/ikrong/nginx:1.13 仓库为例

# 命令行如下：
./exec.sh trigger -w copy.yml destination=registry.cn-beijing.aliyuncs.com source_repo=nginx:1.13 destination_repo=ikrong/nginx:1.13
# 可以省略等号前面的，但是顺序不能变
./exec.sh trigger -w copy.yml registry.cn-beijing.aliyuncs.com nginx:1.13 ikrong/nginx:1.13
# 由于脚本默认 registry.cn-beijing.aliyuncs.com ，所以这个也可以省略
./exec.sh trigger -w copy.yml nginx:1.13 ikrong/nginx:1.13
# 另外 trigger -w copy.yml 可以简写为 copy，所以命令可以改为
./exec.sh copy nginx:1.13 ikrong/nginx:1.13

# 查看运行状态，不过上面的 trigger 命令执行时会自动输出 status，下面的命令一般不需要执行
./exec.sh status -w copy.yml
  1. 命令行运行 sync.yml workflow

以将 nginx 同步到 registry.cn-beijing.aliyuncs.com/ikrong/nginx 仓库为例

# 命令行如下
./exec.sh trigger -w sync.yml destination=registry.cn-beijing.aliyuncs.com source_repo=nginx destination_scope=ikrong
# 仍然可以省略等号前面的
./exec.sh trigger -w sync.yml nginx ikrong
# 另外 trigger -w sync.yml 可以简写为 sync，所以命令可以改为
./exec.sh sync nginx ikrong
  1. 推荐使用命令
# 如果想要复制1个标签，如 nginx:1.13 到 registry.cn-beijing.aliyuncs.com/ikrong/nginx:1.13
# 则可以使用命令
./exec.sh copy nginx:1.13 ikrong/nginx:1.13

# 如果想要同步某个仓库，如 nginx 到 registry.cn-beijing.aliyuncs.com/ikrong/nginx 仓库
# 则可以使用命令
./exec.sh sync nginx ikrong

镜像同步之后如何使用

当使用上面办法将镜像同步到阿里云容器镜像仓库后，就可以直接使用阿里云容器镜像仓库的镜像了。

以 nginx:1.13 为例:

  1. 使用命令拉取
docker pull registry.cn-beijing.aliyuncs.com/ikrong/nginx:1.13
  1. 在 Dockerfile 中使用：
FROM registry.cn-beijing.aliyuncs.com/ikrong/nginx:1.13

# 其他内容