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。

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