使用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。
说明:如无特殊需求,若磁盘不够,最好不要删除镜像,防止误操作。