Ubuntu 搭建docker registry 私有仓库

梦里梦外; 2022-02-02 08:21 621阅读 0赞

# [Ubuntu 搭建docker registry 私有仓库][Ubuntu _docker registry] #

# 一、为什么要搭建 docker 私有仓库 #

原因有几个：

1.  项目需要，不希望将项目放到 docker hub 上。
2.  环境需求，考虑网络、效率的问题，希望在私有服务器上建立自用的仓库，提高便利性和访问速度。
3.  可以做更多的个性化配置。

# 二、用什么搭建 docker 私有仓库 #

docker 官方提供了 registry 的镜像，可以使用它来建私有仓库。

# 三、搭建过程 #

## 环境介绍 ##

<table> 
 <tbody> 
  <tr> 
   <td>系统</td> 
   <td>IP</td> 
   <td>角色</td> 
  </tr> 
  <tr> 
   <td>ubuntu-16.04.5-server-amd64</td> 
   <td>192.168.91.129</td> 
   <td>docker 客户端服务器</td> 
  </tr> 
  <tr> 
   <td>ubuntu-16.04.5-server-amd64</td> 
   <td>192.168.91.131</td> 
   <td>docker 仓库服务器</td> 
  </tr> 
 </tbody> 
</table>

## 安装docker ##

2台服务器，都安装docker

apt-get install -y docker.io

## 配置阿里云docker加速器 ##

2台服务器都 编辑配置文件

vim /etc/docker/daemon.json

内容如下：

{
       "registry-mirrors": [
          "https://kv3qfp85.mirror.aliyuncs.com"
        ]
    }

2台服务器都 重启docker服务

systemctl restart docker

## 拉取registry仓库docker镜像 ##

在131服务器 拉取镜像

docker pull registry

默认会拉取最新版本，访问以下链接：

[https://hub.docker.com/\_/registry/][https_hub.docker.com_registry]

版本应该是2.6.2

## 创建registry docker进程 ##

docker run -d --name docker-registry --restart=always -p 5000:5000 registry

参加解释：

\-d 后台运行

\--name 镜像名称起别名

\--restart=always 在容器退出时总是重启容器，注意：在生产环境中，要启用这个参数

\-p 映射端口，规则是， 真实机端口：容器端口

# 四、测试上传镜像 #

## 下载测试镜像 ##

登录到129服务器，下载一个镜像，比如alpine

docker pull alpine

将alpine镜像重命名为本地镜像格式与本地registry相匹配。

镜像名称由registry和tag两部分组成，registry完整格式：\[registry\_ip\]:\[registry:port\]/\[user\]/\[image\_name:version\]

docker tag alpine 192.168.91.131:5000/alpine

## 上传测试镜像 ##

docker push 192.168.91.131:5000/alpine

输出：

The push refers to a repository [192.168.91.131:5000/alpine]
    Get https://192.168.91.131:5000/v1/_ping: http: server gave HTTP response to HTTPS client

因为Docker从1.3.X之后，与docker registry交互默认使用的是https，然而此处搭建的私有仓库只提供http服务，所以当与私有仓库交互时就会报上面的错误。

## 解决https错误 ##

关于解决https错误，众说纷纭。什么修改/etc/default/docker，修改/etc/init/docker.conf，修改/lib/systemd/system/docker.service...

我测试了一下，貌似没有成功！

下面说能成功的方法。

### 修改daemon.json ###

注意：2台服务器都需要修改！

vim /etc/docker/daemon.json

增加 insecure-registries，完整内容如下：

{
       "registry-mirrors": [
          "https://kv3qfp85.mirror.aliyuncs.com"
       ],
       "insecure-registries": [
          "192.168.91.131:5000" ]
    }

insecure-registries 是一个列表，你可以增加多个。

重启docker服务

systemctl restart docker

再次执行

root@jqb-node129:~# docker push 192.168.91.131:5000/alpine
    The push refers to a repository [192.168.91.131:5000/alpine]
    df64d3292fd6: Pushed 
    latest: digest: sha256:b6459ba7992adb5d76a7962e84909e1b3aaf029fbd8cb94131e8cbe464b6cd04 size: 528

登录到131服务器，查看镜像

注意：私有仓库中的镜像不是直接docker images查看的，而是访问url

比如：

curl -XGET http://registry地址:5000/v2/_catalog
    curl -XGET http://registry地址:5000/v2/镜像名/tags/list

先执行第一个，查看现有的镜像

root@jqb-node129:~# curl -XGET http://192.168.91.131:5000/v2/_catalog
    {
          "repositories":["alpine"]}

查看alpine镜像的信息

root@jqb-node129:~# curl -XGET http://192.168.91.131:5000/v2/alpine/tags/list
    {
          "name":"alpine","tags":["latest"]}

docker 官方的 registry 仓库，默认是不支持从其他客户端拉取服务器仓库的镜像文件的，不过简单的办法，就是设置insecure-registry 参数。

# 五、镜像删除 #

官方提供了删除镜像的API

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

name:镜像名称

reference: 镜像对应sha256值

重点是：镜像对应sha256值，计算非常麻烦。

所以这里使用第三方插件来删除

## 第三方插件删除 ##

插件github上的位置：

[https://github.com/burnettk/delete-docker-registry-image][https_github.com_burnettk_delete-docker-registry-image]

### 下载资源 ###

curl https://raw.githubusercontent.com/burnettk/delete-docker-registry-image/master/delete_docker_registry_image.py | sudo tee /usr/local/bin/delete_docker_registry_image >/dev/null

设置权限

chmod a+x /usr/local/bin/delete_docker_registry_image

### 设置相关环境变量 ###

先来搜索registry

root@jqb-node131:~# find / -name registry
    /usr/share/vim/registry
    /var/lib/docker/volumes/518c02aa36ce326f1dcc5cc397d21f621b28e690b864ca3d36e474a4d657ea13/_data/docker/registry
    /var/lib/docker/aufs/diff/d4f4fd0107a55fa3b608a4ff9b13a94b2246b0eb212714b8b61bf8e383a062e8/var/lib/registry
    /var/lib/docker/aufs/diff/bc0dbcfaf524ebed6a9957d3b7e81847f0f3eb3caee1936035f61bf734e82636/etc/docker/registry
    /var/lib/docker/aufs/diff/693c5a102cda676001a36d96b988a3967734123d788df90ffd5d90af43dfcff2/bin/registry
    /var/lib/docker/aufs/diff/d60ed6fa449324e4075ae7bbff41b31c36a80c4e5a5fa8fabbc4e07436ee8bf6/var/lib/registry
    /var/lib/docker/aufs/mnt/d60ed6fa449324e4075ae7bbff41b31c36a80c4e5a5fa8fabbc4e07436ee8bf6/var/lib/registry
    /var/lib/docker/aufs/mnt/d60ed6fa449324e4075ae7bbff41b31c36a80c4e5a5fa8fabbc4e07436ee8bf6/etc/docker/registry
    /var/lib/docker/aufs/mnt/d60ed6fa449324e4075ae7bbff41b31c36a80c4e5a5fa8fabbc4e07436ee8bf6/bin/registry
    /var/lib/ucf/registry

从上面搜索结果中，有很多。这么多目录，那一个才是真正的呢？

**末尾带有\_data/docker/registry才是真正的存储目录**

查看这个目录，进一步查看v2/repositories

root@jqb-node131:~# ll /var/lib/docker/volumes/518c02aa36ce326f1dcc5cc397d21f621b28e690b864ca3d36e474a4d657ea13/_data/docker/registry/v2/repositories/
    total 12
    drwxr-xr-x 3 root root 4096 Nov 12 15:46 ./
    drwxr-xr-x 4 root root 4096 Nov 12 15:46 ../
    drwxr-xr-x 5 root root 4096 Nov 12 15:46 alpine/

就可以发现 alpine了，就是客户端上传的镜像。

**设置环境变量**，**注意：要去掉上面路径中末尾的repositories**

export REGISTRY_DATA_DIR=/var/lib/docker/volumes/518c02aa36ce326f1dcc5cc397d21f621b28e690b864ca3d36e474a4d657ea13/_data/docker/registry/v2/

### 直接删除镜像 ###

先来查看一下镜像列表

root@jqb-node131:~# curl http://192.168.91.131:5000/v2/_catalog
    {
          "repositories":["alpine"]}

再查看alpine的tag

root@jqb-node131:~# curl http://192.168.91.131:5000/v2/alpine/tags/list
    {
          "name":"alpine","tags":["latest"]}

之后就可以直接删除：

语法：

delete_docker_registry_image --image 镜像名:版本

例如：

root@jqb-node131:~# delete_docker_registry_image --image alpine:latest

输出如下：

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][]

INFO     [2018-11-12 16:22:09,413]  Deleting /var/lib/docker/volumes/518c02aa36ce326f1dcc5cc397d21f621b28e690b864ca3d36e474a4d657ea13/_data/docker/registry/v2/blobs/sha256/b6/b6459ba7992adb5d76a7962e84909e1b3aaf029fbd8cb94131e8cbe464b6cd04
    INFO     [2018-11-12 16:22:09,418]  Deleting /var/lib/docker/volumes/518c02aa36ce326f1dcc5cc397d21f621b28e690b864ca3d36e474a4d657ea13/_data/docker/registry/v2/blobs/sha256/19/196d12cf6ab19273823e700516e98eb1910b03b17840f9d5509f03858484d321
    INFO     [2018-11-12 16:22:09,419]  Deleting /var/lib/docker/volumes/518c02aa36ce326f1dcc5cc397d21f621b28e690b864ca3d36e474a4d657ea13/_data/docker/registry/v2/blobs/sha256/2b/2bc1c5ee86055a39979b389170e9638262b2e11e1761403e5e0321101f96b427
    INFO     [2018-11-12 16:22:09,421]  Deleting /var/lib/docker/volumes/518c02aa36ce326f1dcc5cc397d21f621b28e690b864ca3d36e474a4d657ea13/_data/docker/registry/v2/repositories/alpine

再看一下本地仓库的镜像有几个

root@jqb-node131:~# curl http://192.168.91.131:5000/v2/_catalog
    {
          "repositories":[]}

发现已经为空了！

本文参考链接：

[http://blog.51cto.com/wangpengtai/2093613][http_blog.51cto.com_wangpengtai_2093613]

[https://blog.csdn.net/tototuzuoquan/article/details/82025954][https_blog.csdn.net_tototuzuoquan_article_details_82025954]

posted @ 2018-11-12 15:49 [肖祥][Link 1] 阅读( ...) 评论( ...) [编辑][Link 2] 收藏

[Ubuntu _docker registry]: https://www.cnblogs.com/xiao987334176/p/9946915.html
[https_hub.docker.com_registry]: https://hub.docker.com/_/registry/
[https_github.com_burnettk_delete-docker-registry-image]: https://github.com/burnettk/delete-docker-registry-image
[ContractedBlock.gif]: https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif
[ExpandedBlockStart.gif]: /images/20220202/e44a3b8238a84b30909ba978743addb1.png
[http_blog.51cto.com_wangpengtai_2093613]: http://blog.51cto.com/wangpengtai/2093613
[https_blog.csdn.net_tototuzuoquan_article_details_82025954]: https://blog.csdn.net/tototuzuoquan/article/details/82025954
[Link 1]: https://www.cnblogs.com/xiao987334176/
[Link 2]: https://i.cnblogs.com/EditPosts.aspx?postid=9946915