关于Docker Registry v2的搭建

新版 registry v2对镜像存储格式进行了重新设计，并且和旧版还不兼容。registry v2是由go语言开发，docker从1.6版本开始支持registry v2，之前python开发的老版registry在网上已被标为废弃了（没有维护更新，但也可以用）。

之前在测试环境搭建了一个老版的registry，用了也比较久了。为了跟上技术的脚步，也准备今后使用新版registry v2。由于对旧版是不兼容的，所以之前仓库的数据目录还不能直接拿来挂载，只好重新做个新的，镜像只好等以后慢慢再放上去了。下面对我这次配置的步骤简单的介绍一下。

0. 服务器环境
本次使用centos7.1的操作系统，服务器IP假设为：192.168.0.100
预先装好docker服务，操作如下：

[plain]  view plain  copy

1. yum install docker -y  
2. systemctl enable docker  
3. systemctl start docker  

1. 获取最新的registry的容器
了解到目前最新版为2.4.1，于是直接使用docker pull命令从公用仓库去拉即可

[plain]  view plain  copy

1. docker pull registry:2.4.1  

2. 运行registry:2.4.1容器
这里需要注意的是新registry仓库数据目录的位置。之前老版的位置是/tmp/registry，hub.docker.com上的演示 命令里写的是 /tmp/registry -dev，其实这个不对。试验证明，新registry的仓库目录是在/var/lib/registry，所以运行时挂载目录需要注意。

[plain]  view plain  copy

1. docker run -d -p 5000:5000 --restart=always \  
2.   -v /opt/registry-var/:/var/lib/registry/ \  
3.   registry:2.4.1  

-v选项指定将/opt/registry-var/目录挂载给/var/lib/registry/
当使用curl http://192.168.0.100:5000/v2/_catalog能看到json格式的返回值时，说明registry已经运行起来了。

3. 修改配置文件以指定registry地址
上面registry虽然已经运行起来了，但是如果想用push命令上传镜像是会报错的，需要在配置文件中指定registry的地址。在/etc/sysconfig/docker文件中添加一下配置：

[plain]  view plain  copy

1. ADD_REGISTRY='--insecure-registry 192.168.0.100:5000'  

为了配置简单，省去安全相关的配置，这里使用--insecure-registry选项。
修改配置文件后，一定要重启docker服务才能生效，所以：

[plain]  view plain  copy

1. systemctl restart docker  

这时再push就可以上传镜像到所搭建的registry仓库了。需要注意的是，上传前要先给镜像tag一个192.168.0.100:5000/为前缀的名字，这样才能在push的时候存到私库。

[plain]  view plain  copy

1. docker tag docker.io/registry:2.4.1 192.168.0.100:5000/registry:2.4.1  
2. docker push 192.168.0.100:5000/registry:2.4.1  

4. 配置带用户权限的registry
到上面为止，registry已经可以使用了。如果想要控制registry的使用权限，使其只有在登录用户名和密码之后才能使用的话，还需要做额外的设置。
registry的用户名密码文件可以通过htpasswd来生成：

[plain]  view plain  copy

1. mkdir /opt/registry-var/auth/  
2. docker run --entrypoint htpasswd registry:2.4.1 -Bbn felix felix  >> /opt/registry-var/auth/htpasswd  

上面这条命令是为felix用户名生成密码为felix的一条用户信息，存在/opt/registry-var/auth/htpasswd文件里面，文件中存的密码是被加密过的。
使用带用户权限的registry时候，容器的启动命令就跟上面不一样了，将之前的容器停掉并删除，然后执行下面的命令：

[plain]  view plain  copy

1. docker run -d -p 5000:5000 --restart=always \  
2.   -v /opt/registry-var/auth/:/auth/ \  
3.   -e "REGISTRY_AUTH=htpasswd" \  
4.   -e "REGISTRY_AUTH_HTPASSWD_REALM=Registry Realm" \  
5.   -e REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd \  
6.   -v /opt/registry-var/:/var/lib/registry/ \  
7.   registry:2.4.1  

这时，如果直接想查看仓库信息、pull或push都会出现权限报错。必须先使用docker login 命令来登录私有仓库：

[plain]  view plain  copy

1. docker login 192.168.0.100:5000  

根据提示，输入用户名和密码即可。如果登录成功，会在/root/.docker/config.json文件中保存账户信息，这样就可以继续使用了