如何在Ubuntu14.04上搭建私有docker registry

Posted 2023-04-27

参考技术A docker是一款部署服务器的强有力工具。docker.io免费为用户提供上传镜像资源到官方registry的服务，然而，该registry对任何人均开放权限。也许对于一个非开源的项目，你并不情愿如此。
本文将指导你如何搭建私有docker registry，并确保其安全性。在本教程的最后，你将亲身体验上传自制的docker镜像到私有registry，并在不同的机器上安全的将该其拉去下来。
本教程不包含如何容器化应用服务的内容，而是旨在引导你去创建registry来存储你要部署的服务资源。如果你想要docker的入门教程，也许这儿可以帮到你。
基于Ubuntu14.04系统的单registry和单客户机模式，本教程已经通过测试，也许在其他基于debian的发布上仍可以运行。
docker概念
如果在此之前你尚未接触过docker，这需要花费你几分钟的时间来熟悉docker的关键概念。如果你对docker已得心应手，只是想了解如何构建私有registry的话，那么，你可以直接进入下一小节。
对于一个新手该如何使用docker，不妨试试这里优秀的docker笔记。
docker的核心就是要对应用以及应用的依赖与操作系统分离。为了达到上述目的，docker采用容器与镜像机制。一个docker镜像基本上是一个文件系统的模板。当你通过docker run命令运行一个docker镜像时，该文件系统的一个实例即被激活，并且运行在系统内的docker容器之中。默认的，该容器无法触及原始镜像以及docker本身所运行在的主机的文件系统。这是一个独立的环境。
对容器所做的任何改动都将保存在容器本身之内，并不会影响原始的镜像。如果想保留这些改动，那么，可以通过docker commit命令将容器保存为镜像。这意味你可以通过原有的容器来衍生出新的容器，而不会对原始容器（或镜像）造成任何影响。如果你熟悉git，那么你会觉得该流程十分眼熟：从任意的容器上去创建新的分支（这里，分支的意思即为docker中的镜像）。运行镜像类似于执行git checkout操作。
更进一步形容，运行私有docker registry，就好比为docker镜像运行私有git仓库。
第一步——安装必要的软件
在docker registry服务器上，应当创建一个拥有sudo权限的用户（如果可以，在客户机上也如此）。
docker registry软件是一款python应用，因此为了使其能够运行起来，需要安装python开发环境以及必要的库：
sudo apt-get updatesudo apt-get -y install build-essential python-dev libevent-dev python-pip liblzma-dev

第二步——安装并配置docker registry
为了安装最新的稳定的docker registry发行版（作者撰文时为0.7.3，译者译时为0.9.1），我们将使用python包管理工具pip：
sudo pip install docker-registry

docker-registry需要配置文件。
默认地，pip将该配置文件放置在相当偏僻的地方，因系统中python的安装位置而异。因此，为了找到该路径，我们将尝试运行registry，以查看相关的输出：
gunicorn --access-logfile - --debug -k gevent -b 0.0.0.0:5000 -w 1 docker_registry.wsgi:application

由于配置文件不在正确的位置，上述尝试将会以失败而告终，并输出一条包含FileNotFoundError错误消息，如下所示[在某些版本中，无下述信息输出，译者注]：
FileNotFoundError: Heads-up! File is missing: /usr/local/lib/python2.7/dist-packages/docker_registry/lib/../../config/config.yml

registry在同样的路径上包含一个示例配置文件，该文件名为config_sample.yml，因此，我们可以通过上述给出的路径名来定位示例配置文件。
从错误消息中复制路径信息（此时为/usr/local/lib/python2.7/dist-packages/docker_registry/lib/../../config/config.yml），然后，将config.yml部分去除，这样我们可以切换到该路径下。
cd /usr/local/lib/python2.7/dist-packages/docker_registry/lib/../../config/

将config_sample.yml文件的内容复制到config.yml中：
sudo cp config_sample.yml config.yml

默认情况下，docker的数据文件存放在/tmp文件夹下，但是在许多的类Linux系统中，系统重启时该文件夹被清空，这并不是我们所希望的。那么，我们创建一个永久性的文件夹来存储数据：
sudo mkdir /var/docker-registry

好的，下面我们配置config.yml文件，将对文件夹/tmp的引用更改为/var/docker-registry。首先，首先找到以sqlalchemy_index_database为首的靠近文件首部的一行：
sqlalchemy_index_database:_env:SQLALCHEMY_INDEX_DATABASE:sqlite:////tmp/docker-registry.db

将其更改指向/var/docker-registry，如下所示：
sqlalchemy_index_database:_env:SQLALCHEMY_INDEX_DATABASE:sqlite:////var/docker-registry/docker-registry.db

向下一点，到local:部分，重复上述操作，更改如下内容：
local: &localstorage: localstorage_path: _env:STORAGE_PATH:/tmp/registry

为：
local: &localstorage: localstorage_path: _env:STORAGE_PATH:/var/docker-registry/registry

样例配置文件中的其他默认值均无需修改。一目十行即可。然而，如果你想要做一些复杂的配置，诸如采用扩展存储装置来存储docker数据，那么该文件正具有此功能。当然，这已超出本教程的范围，你可以查看docker-registry文档以获取更多的帮助。
既然配置文件已置于正确的位置，那么再一次尝试来测试docker registry服务器：
gunicorn --access-logfile - --debug -k gevent -b 0.0.0.0:5000 -w 1 docker_registry.wsgi:application

你会看到如下的输出：
2014-07-27 07:12:24 [29344] [INFO] Starting gunicorn 18.02014-07-27 07:12:24 [29344] [INFO] Listening at: http://0.0.0.0:5000 (29344)2014-07-27 07:12:24 [29344] [INFO] Using worker: gevent2014-07-27 07:12:24 [29349] [INFO] Booting worker with pid: 293492014-07-27 07:12:24,807 DEBUG: Will return docker-registry.drivers.file.Storage

棒极了！现在我们已经拥有一个运行着的docker registry。下面执行Ctrl+C终止该程序。
到目前为止，docker registry并不是那么有用。它并不会自行启动除非我们执行上述gunicorn命令。另外，docker registry不没有引入任何的内置的认证机制，因此，其当前状态下是不安全并且对外部完全开放的。
第三步——以服务的形式启动docker registry
通过创建Upstart脚本，设置docker registry在系统的启动程序中开始运行。
首先，创建日志文件目录：
sudo mkdir -p /var/log/docker-registry

然后，用一款你拿手的文本编辑器来创建Upstart脚本：
sudo nano /etc/init/docker-registry.conf

将如下内容写入上述脚本中：
description "Docker Registry"start on runlevel [2345]stop on runlevel [016]respawnrespawn limit 10 5script exec gunicorn --access-logfile /var/log/docker-registry/access.log --error-logfile /var/log/docker-registry/server.log -k gevent --max-requests 100 --graceful-timeout 3600 -t 3600 -b localhost:5000 -w 8 docker_registry.wsgi:applicationend script

更多关于Upstart脚本的内容，请阅读该教程。
此时，执行如下命令：
sudo service docker-registry start

将看到下面的输出：
docker-registry start/running, process 2

ubuntu16.04搭建docker_1.13.1私有仓库

1、配置docker的国内加速器

docker版本为1.13.1需要配置一下daemon.json

配置阿里云的docker加速器：

[email protected]:~$ sudo vim /etc/docker/daemon.json 
{
   "registry-mirrors": [
      "https://kv3qfp85.mirror.aliyuncs.com"
    ]
}

2、拉取registry仓库docker镜像

[email protected]:~$ sudo docker pull registry

3、创建registry docker进程

[email protected]:~$ sudo docker run -d --name registry --restart=always -v /myregistry:/var/lib/registry registry
[email protected]:~$ sudo docker ps
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                    NAMES
d8f77abe36a7        registry            "/entrypoint.sh /e..."   2 hours ago         Up 2 hours          0.0.0.0:5000->5000/tcp   registry

4、测试上传一个镜像

下载一个测试镜像

[email protected]:~$ sudo docker pull busybox

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

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

[email protected]:~$ sudo docker tag busybox 192.168.56.101:5000/wangpeng/test:v1.0

5、使用docker push命令上传镜像

[email protected]:~$ sudo docker push 192.168.56.101:5000/wangpeng/test:v1.0

查看镜像

[email protected]:~$ curl http://192.168.56.101:5000/v2/_catalog 
{"repositories":["wangpeng/my-image","wangpeng/test"]}

在此需要配置daemon.json的insecure-registries，为了解决https的报错，因为docker默认使用https协议，但是本地现在只支持http协议

不配置daemon.json的话会出现一下错误：

Get https://192.168.56.101:5000/v1/_ping: http: server gave HTTP response to HTTPS clie

配置如下：

[email protected]:~$ sudo vim /etc/docker/daemon.json 
{
   "registry-mirrors": [
      "https://kv3qfp85.mirror.aliyuncs.com"
   ],
   "insecure-registries": [
      "192.168.56.101:5000"
    ]
}

重启docker进程

[email protected]:~$ sudo systemctl restart docker

上传报错的问题就此解决

6、下载镜像测试一下

[email protected]:~$ sudo docker pull 192.168.56.101:5000/wangpeng/test:v1.0
v1.0: Pulling from wangpeng/test
Digest: sha256:73a74253ed45caebc619d95b1d84e4d67a64e5b6d81e31ac7c496b9c11128d74
Status: Image is up to date for 192.168.56.101:5000/wangpeng/test:v1.0