您的位置:首页 > 运维架构 > Docker

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

2015-03-18 16:36 615 查看

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

原文地址:https://www.digitalocean.com/community/tutorials/how-to-set-up-a-private-docker-registry-on-ubuntu-14-04

作者:Nik van der Ploeg

译者:陈正文(awenchen)

简介

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 update

sudo 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: &local
storage: local
storage_path: _env:STORAGE_PATH:/tmp/registry


为:

local: &local
storage: local
storage_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.0
2014-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: gevent
2014-07-27 07:12:24 [29349] [INFO] Booting worker with pid: 29349
2014-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]

respawn
respawn limit 10 5

script
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:application
end script


更多关于
Upstart
脚本的内容,请阅读该教程

此时,执行如下命令:

sudo service docker-registry start


将看到下面的输出:

docker-registry start/running, process 25303


当然,你也可以通过运行下面的命令查看
server.log
日志文件,验证
docker-registry
服务是否正在运行:

tail /var/log/docker-registry/server.log


如果一切正常的话,你会看到像之前执行
gunicorn
命令时输出的文本信息。

既然
docker-registry
服务器已在后台运行,那么下面我们来配置
Nginx
,以使
registry
更加安全。

第四步——通过
Nginx
来保障
docker registry
的安全性

为了避免任何人都能登陆我们的
docker registy
服务器,首先要做的就是建立认证机制。

下面安装
Nginx
apache2-utils
包(通过该包,可以轻松创建
Nginx
能够读取的权限文件)。

sudo apt-get -y install nginx apache2-utils


现在来创建
docker
用户。

通过下面的命令来创建第一个用户:

sudo htpasswd -c /etc/nginx/docker-registry.htpasswd USERNAME


当跳出命令行时,轻给出该用户的密码。

如果将来想添加更多的用户,只需要在去除可选参数
c
的前提下,重新运行上述命令:

sudo htpasswd /etc/nginx/docker-registry.htpasswd USERNAME_2


现在,我们拥有了一个创建用户的文件
dokcer-registry.htpasswd
,以及可用的
docker registry
服务器。如果你想了解你的用户的话你可以随意查看该文件(如果想收回权限的话可以删除掉该用户)。

下面,我们需要告诉
Nginx
去利用权限文件,并且将请求转发给
docker registry


那么,我们来创建一个
Nginx
的配置文件。创建一个新的
docker-registry
文件,必要时可能需要输入执行
sudo
命令的密码:

sudo nano /etc/nginx/sites-available/docker-registry


将如下内容添加到该文件中。注释也包含在其中。更多关于
Nginx
虚拟主机配置文件的内容,可查阅该教程

# For versions of Nginx > 1.3.9 that include chunked transfer encoding support
# Replace with appropriate values where necessary

upstream docker-registry {
server localhost:5000;
}

server {
listen 8080;
server_name my.docker.registry.com;

# ssl on;
# ssl_certificate /etc/ssl/certs/docker-registry;
# ssl_certificate_key /etc/ssl/private/docker-registry;

proxy_set_header Host       $http_host;   # required for Docker client sake
proxy_set_header X-Real-IP  $remote_addr; # pass on real client IP

client_max_body_size 0; # disable any limits to avoid HTTP 413 for large image uploads

# required to avoid HTTP 411: see Issue #1486 (https://github.com/dotcloud/docker/issues/1486)
chunked_transfer_encoding on;

location / {
# let Nginx know about our auth file
auth_basic              "Restricted";
auth_basic_user_file    docker-registry.htpasswd;

proxy_pass http://docker-registry; }
location /_ping {
auth_basic off;
proxy_pass http://docker-registry; }
location /v1/_ping {
auth_basic off;
proxy_pass http://docker-registry; }
}


对该文件建立链接,这样
Nginx
就可以使用该配置文件:

sudo ln -s /etc/nginx/sites-available/docker-registry /etc/nginx/sites-enabled/docker-registry


然后,重启
Nginx
以激活虚拟主机配置:

sudo service nginx restart


让我们确保每一环节都准确无误。
Nginx
服务器监听端口8080,而初始的
docker-registry
服务器监听本地端口5000

我们可以通过
curl
命令来测试整个环节的准确性:

curl localhost:5000


你应当看到下述输出:

"docker-registry server (dev) (v0.8.1)"


不错,
docker-registry
正在运行。现在检查
Nginx
是否工作:

curl localhost:8080


这次,你将得到
HTML
格式的无权限访问的消息:

<html>
<head><title>401 Authorization Required</title></head>
<body bgcolor="white">
<center><h1>401 Authorization Required</h1></center>
<hr><center>nginx/1.4.6 (Ubuntu)</center>
</body>
</html>


同样的,也可以通过远端的机器运行上述两个测试命令来验证端口是否正确设置,不过需要将
localhost
更改为主机的
IP
地址。

Upstart
配置文件中,我们设置
docker-registry
仅仅监听来自
localhost
的请求,这意味着外网将无法通过端口
5000
来访问
docker-registry
。另一方面,
Nginx
监听来自端口
8080
的请求,并且对外网开放。如果并非如此,你需要调整你的防火墙权限设置。

好了,权限设置已建立起来。那么,现在我们尝试使用先前创建的某个用户名来登陆
Nginx


curl USERNAME:PASSWORD@localhost:8080


如果正确运行,你将看到如下信息:

"docker-registry server (dev) (0.8.1)"


第五步——建立SSL

到目前为止,我们已经搭建起了
registry
服务,并且运行在
Nginx
后面,通过
HTTP
基础认证机制连接二者。然而,由于连接是未加密的,所以该服务仍然是不安全的。也许你已经主要到了先前创建的
Nginx
配置文件中被注释掉的关于
SSL
的部分。

激活
SSL
。首先,打开
Nginx
文件以备编辑:

sudo nano /etc/nginx/sites-available/docker-registry


找到下述内容:

server {
listen 8080;
server_name my.docker.registry.com;

# ssl on;
# ssl_certificate /etc/ssl/certs/docker-registry;
# ssl_certificate_key /etc/ssl/private/docker-registry;


删除
SSL
行首的
#
。如果你的服务器有自己的域名的话,将
server_name
更改为你的域名。完成后应当如下所示:

server {
listen 8080;
server_name yourdomain.com;

ssl on;
ssl_certificate /etc/ssl/certs/docker-registry;
ssl_certificate_key /etc/ssl/private/docker-registry;


保存该文件。现在,
Nginx
已经被配置使用
SSL
,下面将会分别从
/etc/ssl/certs/docker-registry
/etc/ssl/private/docker-registry
文件中搜索
SSL
证书和秘钥。

如果你已经拥有了一个
SSL
证书或者正准备去购买一个的话,你仅需要将证书和秘钥拷贝到上述所列的路径下(
ssl_certificate
ssl_certficate_key


也可以免费获得一个签名
SSL
证书


或者,使用一个自签名的
SSL
证书。由于docker当前不允许使用自签名的
SSL
证书,这将带来加倍的复杂度,因为我们必须去搭建系统来充当我们已具有签名权限的证书。

建立签名证书

首先,创建存放证书的目录并进入该目录:

mkdir ~/certs
cd ~/certs


生成一个新的根秘钥:

openssl genrsa -out devdockerCA.key 2048


生成一个根证书(跳入命令行时可输入任何内容):

openssl req -x509 -new -nodes -key devdockerCA.key -days 10000 -out devdockerCA.crt


然后,为服务器生成一个秘钥(稍后会将该文件拷贝到
/etc/ssl/private/docker-registry
Nginx
使用):

openssl genrsa -out dev-docker-registry.com.key 2048


现在,我们必须生成证书签名请求。

在输入下面的
OpenSSL
命令后,将会跳入命令行模式,需要你输入一些问题的答案。对于前面的一些问题,可随意编辑,但是当要求你键入“Common Name”时,确保输入的是你的服务器的域名

openssl req -new -key dev-docker-registry.com.key -out dev-docker-registry.com.csr


例如,你的
docker-registry
将以
www.ilovedocker.com
为域名运行,然后你的输入应当如下所示:

Country Name (2 letter code) [AU]:
State or Province Name (full name) [Some-State]:
Locality Name (eg, city) []:
Organization Name (eg, company) [Internet Widgits Pty Ltd]:
Organizational Unit Name (eg, section) []:
Common Name (e.g. server FQDN or YOUR name) []:www.ilovedocker.com
Email Address []:

Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password []:
An optional company name []:


切勿输入挑战码。然后,我们需要对证书的请求进行签名:

openssl x509 -req -in dev-docker-registry.com.csr -CA devdockerCA.crt -CAkey devdockerCA.key -CAcreateserial -out dev-docker-registry.com.crt -days 10000


既然我们已生成了所需的证书文件,下面就将它们拷贝到正确的位置。

首先,将证书和秘钥拷贝到
Nginx
预期的路径:

sudo cp dev-docker-registry.com.crt /etc/ssl/certs/docker-registry
sudo cp dev-docker-registry.com.key /etc/ssl/private/docker-registry


由于生成的这些证书并没有得到任何一个著名的证书认证机构(例如,
VeriSign
)验证,我们需要告诉那些即将连接该
docker-registry
的客户机,该证书是合法的。我们本地做出上述认证,以便可以在
docker-registry
服务器上使用
docker


sudo mkdir /usr/local/share/ca-certificates/docker-dev-cert
sudo cp devdockerCA.crt /usr/local/share/ca-certificates/docker-dev-cert
sudo update-ca-certificates


你可能必须在每一台想要连接该
docker-registry
的主机上执行上述操作
。否则,你将得到
SSL
错误并且无法取得连接,这些步骤将在客户端测试小节中再次出现。

SSL
测试

重启
Nginx
以重新载入配置文件和
SSL
秘钥:

sudo service nginx restart


再次执行
curl
测试(仅此次使用
https
)以验证
SSL
正确工作。必须记住的是,为了让
SSL
能够正确运行,你必须使用在创建
SSL
证书的之前,在
Common Name
域输入的域名。

curl https://USERNAME:PASSWORD@YOUR-DOMAIN:8080


例如,若用户名和密码分别为
nik
test
,并且
SSL
证书是为域名
www.ilovedocker.com
,那么,你将输入如下的命令:

curl https://nik:test@www.ilovedocker.com:8080


如果一切顺利的话,你会看到熟悉的内容:

"docker-registry server (dev) (v0.8.1)"


否则,重新检查建立
SSL
的相关步骤,以及
Nginx
配置文件,以确保一切正常。

到目前为止,我们已经建立了运行在
Nginx
服务器后面的
docker regsitry
,而
Nginx
通过
SSL
可以提供权限认证和加密。

第六步——通过其他主机访问docker registry

为了能够访问
docker registry
,首先要将先前创建的
SSL
证书添加到新的主机中。该证书文件位于
~/certs/devdockerCA.crt
。可以选择直接将其复制到新的机器中,或者根据以下说明来进行拷贝粘贴:

registry
服务器
上,查看证书:

cat ~/certs/devdockerCA.crt


可得到类似如下的输出:

-----BEGIN CERTIFICATE-----
MIIDXTCCAkWgAwIBAgIJANiXy7fHSPrmMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNV
BAYTAkFVMRMwEQYDVQQIDApTb21lLVN0YXRlMSEwHwYDVQQKDBhJbnRlcm5ldCBX
aWRnaXRzIFB0eSBMdGQwHhcNMTQwOTIxMDYwODE2WhcNNDIwMjA2MDYwODE2WjBF
MQswCQYDVQQGEwJBVTETMBEGA1UECAwKU29tZS1TdGF0ZTEhMB8GA1UECgwYSW50
ZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
CgKCAQEAuK4kNFaY3k/0RdKRK1XLj9+IrpR7WW5lrNaFB0OIiItHV9FjyuSWK2mj
ObR1IWJNrVSqWvfZ/CLGay6Lp9DJvBbpT68dhuS5xbVw3bs3ghB24TntDYhHMAc8
GWor/ZQTzjccHUd1SJxt5mGXalNHUharkLd8mv4fAb7Mh/7AFP32W4X+scPE2bVH
OJ1qH8ACo7pSVl1Ohcri6sMp01GoELyykpXu5azhuCnfXLRyuOvQb7llV5WyKhq+
SjcE3c2C+hCCC5g6IzRcMEg336Ktn5su+kK6c0hoD0PR/W0PtwgH4XlNdpVFqMST
vthEG+Hv6xVGGH+nTszN7F9ugVMxewIDAQABo1AwTjAdBgNVHQ4EFgQULek+WVyK
dJk3JIHoI4iVi0FPtdwwHwYDVR0jBBgwFoAULek+WVyKdJk3JIHoI4iVi0FPtdww
DAYDVR0TBAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAQEAkignESZcgr4dBmVZqDwh
YsrKeWSkj+5p9eW5hCHJ5Eg2X8oGTgItuLaLfyFWPS3MYWWMzggxgKMOQM+9o3+k
oH5sUmraNzI3TmAtkqd/8isXzBUV661BbSV0obAgF/ul5v3Tl5uBbCXObC+NUikM
O0C3fDmmeK799AM/hP5CTDehNaFXABGoVRMSlGYe8hZqap/Jm6AaKThV4g6n4F7M
u5wYtI9YDMsxeVW6OP9ZfvpGZW/n/88MSFjMlBjFfFsorfRd6P5WADhdfA6CBECG
LP83r7/MhqO06EOpsv4n2CJ3yoyqIr1L1+6C7Erl2em/jfOb/24y63dj/ATytt2H
6g==
-----END CERTIFICATE-----


拷贝该输出到粘贴板,并且连接到客户机。

客户机上,创建证书目录:

sudo mkdir /usr/local/share/ca-certificates/docker-dev-cert


打开证书文件以备编辑:

nano /usr/local/share/ca-certificates/docker-dev-cert/devdockerCA.crt


粘贴证书内容[已在粘贴板上,译者注]。

通过查看给文件来验证证书已保存到客户机上:

cat /usr/local/share/ca-certificates/docker-dev-cert/devdockerCA.crt


如果一切顺利的话,你会看到和之前一样的输出文本:

-----BEGIN CERTIFICATE-----
MIIDXTCCAkWgAwIBAgIJANiXy7fHSPrmMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNV
...
...
LP83r7/MhqO06EOpsv4n2CJ3yoyqIr1L1+6C7Erl2em/jfOb/24y63dj/ATytt2H
6g==
-----END CERTIFICATE-----


现在,更新证书:

sudo update-ca-certificates


会得到形如下文的输出(主要这里的”1 added”)

Updating certificates in /etc/ssl/certs... 1 added, 0 removed; done.
Running hooks in /etc/ca-certificates/update.d....done.


如果你到现在还没有安装
docker
在这台客户机上的,马上安装吧。

Ubuntu
的大多数版本中,你仅需下面这几个命令就能够快速安装最新版的
docker
。如果你的是其他的发布或者遇到了一些难题,那么你可以查看
docker
安装指南
,以寻其他出路。

添加仓库秘钥:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 36A1D7869245C8950F966E92D8576A8BA88D21E9;


创建一个文件来罗列
docker
仓库:

sudo nano /etc/apt/sources.list.d/docker.list


将以下内容添加到该文件中:

deb https://get.docker.io/ubuntu docker main


更新包列表:

sudo apt-get update


安装
docker


sudo apt-get install -y --force-yes lxc-docker


为了使
docker
能更快的工作起来,将当前用户加入到
docker
组中,并且重开一个新的命令行模式:

sudo gpasswd -a ${USER} docker
sudo su -l $USER #(必要时需键入密码)


重启
docker
以确保其重新载入系统的
CA
证书。

sudo service docker restart


此时,你应当能够从该客户机登陆
docker registry
服务器:

docker login https://YOUR-HOSTNAME:8080


注意,此时应当使用
https://
以及端口
8080
。输入先前设置的用户名和密码(邮件地址可随意输入)。这时,你应当看到
Login Succeeded
的成功登陆消息。

此时,
docker registry
以构建并运行起来。让我们来做个测试的镜像推送到
registry
上。

第七步——发布到
docker registry

在客户机上,创建一个小的、空的镜像,然后推送到
registry
上。

docker run -t -i ubuntu /bin/bash


在完成下载之后,你就进入
docker
命令行模式。对该文件系统做一些小的改变:

touch /SUCCESS


docker
容器中退出:

exit


将所做的更改提交:

docker commit $(docker ps -lq) test-image


如果此时执行
docker images
命令,你会在镜像列表里,看到已经拥有了一个新的
test-image
镜像。

# docker images

REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
test-image          latest              1f3ce8008165        9 seconds ago       192.7 MB
ubuntu              trusty              ba5877dc9bec        11 days ago         192.7 MB


此时,该镜像只存在于本地。那么我们将其推送到新建的
registry
上。

首先,从
docker
登陆
registry
。注意,你要用
https://
以及
8080
端口:

docker login https://<YOUR-DOMAIN>:8080


输入已设置的用户名和密码:

Username: USERNAME
Password: PASSWORD
Email:
Account created. Please see the documentation of the registry http://localhost:5000/v1/ for instructions how to activate it.


docker
有一个非同寻常的机制来明确将镜像推送的哪里的
registry
。必须将镜像打上私有
registry
路径标签才能实现将其推送上去。那么我们将该镜像打上我们私有
registry
的标签:

docker tag test-image YOUR-DOMAIN:8080/test-image


注意,先给出镜像的本地名称,然后给出想要将其打成的标签。该标签上不包含
https://
,仅有域名,端口和镜像名字。

现在可以将镜像推送到
registry
上了。此时,仅使用标签名:

docker push <YOUR-DOMAIN>:8080/test-image


该过程会花费一些时间将镜像上传到
registry
上。你也会看到包含
Image successfully pushed
输出消息。

第八步——从
docker registry
拉取镜像

为了确保一切运行正常,让我们回到初始的服务器上(安装
docker regsitry
的机器上),将从客户机推送上来的镜像拉取下来。你也可以从第三方的服务器上来测试这一步。

如果在即将测试拉取的服务器上还没有安装
docker
,回到第六步去参看安装说明(如果是第三方的服务器,那么参看
SSL
说明一节)。

使用之前创建的用户名和密码登陆:

docker login https://<YOUR-DOMAIN>:8080


现在来拉取镜像。仅需要使用打标签的镜像的名字,包括域名,端口号以及镜像名(而没有
https://
):

docker pull <YOUR-DOMAIN>:8080/test-image


docker
会执行一些下载任务并回退会命令行模式。如果你在这个新的机器上运行该镜像的话,你会看到之前创建的
SUCCESS
文件:

docker run -t -i <YOUR-DOMAIN>:8080/test-image /bin/bash


罗列文件:

ls


你会看到我们之前创建的
SUCCESS
文件:

SUCCESS  bin  boot  dev  etc  home  lib  lib64  media   mnt  opt  proc  root  run  sbin  srv  sys  tmp  usr  var


恭喜你!你已经使用私有的
docker registry
实现了推送和拉取镜像。
Happy Docker-ing!


译者注

以下内容为译者注。

在翻译这篇文章之前,译者按照作者的步骤去构建自己的
registry
,中间有过不少的曲折和坑,同时结合原文的评论以及译者自己搜集的资料,最终实现了私有
registry
的构建,因此,译者更想和大家分享以下这里面需要注意的地方。

安装
build-essential
包时可能会有问题,需要安装一些依赖包,并且由于包依赖的版本有问题,需要先卸载某个包,再重新一起安装。我用
ubuntu
deaktop
版就报了依赖包版本的问题,而
server
版顺利通过。依赖包版本问题也可依照下文第3点去解决,包后加发布的名字,指定包的版本。

在安装
registry
之前,通常需预先安装
swig


sudo apt-get -y install swig

关于安装
registry
过程中遇到
openssl
的问题解决:安装
libssl1.0.0
openssl
以及
libssl-dev


解决方案为如下,这儿的trusty是Ubuntu14.04LTS版本的名称。

sudo apt-get -y install libssl1.0.0/trusty libssl-dev/trusty openssl/trusty

译者的运行环境是:
registry
Ubuntu 14.04 VM
+测试的客户机在
boot2docker
,并且使用的自签名证书。为了使
boot2docker
有权限登陆
registry
,需要将
registry
服务器上的证书(在
~/certs/devdockerCA.crt
)内容拷贝到
boot2docker
/usr/local/etc/ssl/certs/ca-certificates.crt
文件中。
curl
测试时需要加
-k
参数。

为了能够解析你的域名,最好在
/etc/hosts
文件中注明一下(
Linux
);
windows
C:\Windows\System32\drivers\etc\hosts
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: