关于Docker Registry v2的搭建

转载

云原生总监 2022-10-20 23:00:52 博主文章分类：docker

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

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

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

1. 获取最新的registry的容器

[plain] 
   view plain
    copy
   
   
 
1. yum install docker -y
2. systemctl enable docker
3. systemctl start docker

了解到目前最新版为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

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

为了配置简单，省去安全相关的配置，这里使用--insecure-registry选项。

修改配置文件后，一定要重启docker服务才能生效，所以：

[plain] view plain copy

systemctl restart docker

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

[plain] view plain copy

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

4. 配置带用户权限的registry

到上面为止，registry已经可以使用了。如果想要控制registry的使用权限，使其只有在登录用户名和密码之后才能使用的话，还需要做额外的设置。

registry的用户名密码文件可以通过htpasswd来生成：

[plain] view plain copy

mkdir /opt/registry-var/auth/
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