CentOS 7上用Docker Registry镜像构建本地私有仓库

使用registry搭建本地私有仓库，可以节省网络带宽、加快下载速度，同时也可以针对于公司内部使用的镜像，推送到本地的私有仓库中，以供公司内部相关人员使用。

1 安装docker服务

yum install -y docker
systemctl enable docker
systemctl start docker

若docker daemon启动失败，执行docker ps会显示如下错误：

[root@localhost ~]# docker ps
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. \ 
Is the docker daemon running?

否则显示如下：

2 下载docker registry镜像

本文使用的registry的版本是v2.6.2，registry宿主机的ip地址为，192.168.2.155。

2.1 设置Docker代理

由于Docker官网是被墙了的，所以国内下载docker.io仓库中的镜像时，需要配置Docker代理。目前Docker Daemon使用代理有三种方法，

• 方法1： 直接在Docker Daemon启动参数中，通过-H参数指定，不太方便，不推荐，参考:Daemon Socket Option
• 方法2： 在配置文件中导出代理设置，/etc/sysconfig/docker，如:

HTTP_PROXY="http://[proxy-addr]:[proxy-port]/"
HTTPS_PROXY="https://[proxy-addr]:[proxy-port]/"
export HTTP_PROXY HTTPS_PROXY

• 方法3【推荐】： 通过为docker服务创建一个内嵌的systemd目录实现docker代理，具体操作步骤如下：

  • Ⅰ、创建目录：mkdir -p /etc/systemd/system/docker.service.d
  • Ⅱ、创建/etc/systemd/system/docker.service.d/http-proxy.conf文件，并添加HTTP_PROXY环境变量。其中[proxy-addr]和[proxy-port]分别改成实际情况的代理地址和端口。这种配置的好处是可以方便的设置Docker代理地址和不需要走代理的地址。配置内容如下，

  [Service]
  Environment="HTTP_PROXY=http://[proxy-addr]:[proxy-port]/"   "HTTPS_PROXY=https://[proxy-addr]:[proxy-port]/"  "NO_PROXY=localhost,127.0.0.1,192.168.2.155"

  • Ⅲ、重新加载Docker配置：systemctl daemon-reload
  • Ⅳ、重启Docker 服务： systemctl restart docker

2.2 下载镜像、创建容器

下载Registry镜像：

docker pull docker.io/library/registry:latest

创建Registry容器:

docker run -d -p 5000:5000 --privileged=true \
-v /opt/registry:/tmp/registry docker.io/registry(V1放在/tmp/registry)

docker run -d -p 5000:5000 --privileged=true \
-v /opt/registry:/var/lib/registry docker.io/registry(之后放在/var/lib/registry)

参数说明：

• -v /opt/registry:/var/lib/registry registry :默认情况下，会将仓库存放于容器内的/var/lib/registry registry目录下，指定本地目录挂载到容器;
• –privileged=true ：CentOS7中的安全模块selinux把权限禁掉了，参数给容器加特权，不加上传镜像会报权限错误(OSError:[Errno 13] Permission denied: ‘/tmp/registry/repositories/liibrary’)或者（Received unexpected HTTP status: 500 Internal Server Error）错误;

测试仓库是否启动成功:

v1版本的测试方式：curl 127.0.0.1:5000/v1/search，若不是v1版本，执行上述命令之后会返回：404 page not found。

v1之后版本的测试方式：curl -X GET http://127.0.0.1:5000/v2/_catalog
参考：Docker Registry HTTP API V2

3 使用私有仓库

3.1 push镜像

上传本registry镜像到仓库，首先给要上传的镜像设置tag，其中a8a59477268d 是docker.io/registry的镜像ID

docker tag a8a59477268d 192.168.2.155:5000/registry

再push镜像到仓库

docker push 192.168.2.155:5000/registry

3.2 pull镜像

docker pull192.168.2.155:5000/registry

3.3 删除registry中的镜像

registry镜像的删除比较麻烦，大概需要下面几个步骤，

• Ⅰ、启动容器时带上config.yml，并在config.yml中添加delete=true(registry的配置默认是不能删除镜像的)。yml文件配置如下:

  version: 0.1
  log:
    fields:
      service: registry
  storage:
    delete:
      enabled: true
    cache:
      blobdescriptor: inmemory
    filesystem:
      rootdirectory: /var/lib/registry
  http:
    addr: :5000
    headers:
      X-Content-Type-Options: [nosniff]
  health:
    storagedriver:
      enabled: true
      interval: 10s
      threshold: 3

  启动容器命令：

  docker run -d -p 5000:5000 --privileged=true  \
      -v /root/config.yml:/etc/docker/registry/config.yml \
      -v /opt/registry:/var/lib/registry docker.io/registry

• Ⅱ、通过REST API删除镜像
  命令格式：

  DELETE /v2/<name>/manifests/<reference>

  • name为Repository的名称；
  • reference为Content Digests，如：sha256:7a33a8bd719ff0fed4f75ba9f0b6e4963c88f6547039a92070ca5ff4ddc4289f

  具体操作（以删除mysql镜像为例）:

  curl -X DELETE http://192.168.2.155:5000/v2/mysql/manifests/sha256:7a33a8bd719ff0fed4f75ba9f0b6e4963c88f6547039a92070ca5ff4ddc4289f

• Ⅲ、使用registry garbage-collect 清除数据
  在步骤Ⅱ中，只是删除了元数据，彻底删除需要登录registry容器执行registry garbage-collect /etc/docker/registry/config.yml 进行数据删除。具体操作如下：

  docker exec -it REGISTRY_CONTAINER_ID sh
  registry garbage-collect /etc/docker/registry/config.yml
  rm -rf /var/lib/registry/docker/registry/v2/repositories/mysql

• Ⅳ、停止并删除registry容器，重建容器

  docker run -d -p 5000:5000 --privileged=true  \
      -v /root/config.yml:/etc/docker/registry/config.yml \
      -v /opt/registry:/var/lib/registry docker.io/registry

  若不重启，可能会有缓存，再次push删除的镜像时会提示Layer already exists。

• 说明：如无特殊需求，若磁盘不够，最好不要删除镜像，防止误操作。

参考

• Docker搭建本地私有仓库`
• Docker网络代理设置
• Docker Registry HTTP API V2