配置Harbor私有Docker镜像服务使用HTTPS

原创
2016/11/09 21:05
阅读数 1.4W

配置Harbor私有Docker镜像服务使用HTTPS

在Harbor中使用HTTPS需要一下几个步骤:

  • 生成CA证书。
  • 修改Harbor.cfg文件及创建Registry服务。
  • 配置客户端使用CA证书。

原Harbor官方文档的修改Nginx的证书步骤已经不需要了,在运行prepare时会自动创建出Nginx的配置文件,检查一下是否正确即可。

这里是Harbor的HTTPS配置的快捷指南,更多详细操作参考:

1、生成CA证书

这里假定Registry服务器的IP地址是:192.168.1.8,主要介绍通过IP地址生成证书方法。

1.1. 建立CA证书发行站点

openssl req  -newkey rsa:4096 -nodes -sha256 -keyout ca.key -x509 -days 365 -out ca.crt

1.2. 创建CA证书生成请求

openssl req  -newkey rsa:4096 -nodes -sha256 -keyout 192.168.1.8.key -out 192.168.1.8.csr

1.3. 创建CA站点文件目录

demoCA是OpenSSL的证书存储依赖目录,建立在与上面的ca.crt的同级目录下。

mkdir demoCA
cd demoCA
touch index.txt
echo '01' > serial
cd ..

建完的目录结构:

.
..
ca.crt
ca.key
demoCA
...

1.4. 生成CA客户端证书

echo subjectAltName = IP:192.168.1.8 > extfile.cnf

openssl ca -in 192.168.1.8.csr -out 192.168.1.8.crt -cert ca.crt -keyfile ca.key \
-extfile extfile.cnf -outdir .

2、下载和安装

Harbor的运行时由多个Docker Container组成,包括:Nginx、MySQL、UI、Proxy、log、JobService六个主要组成部分。可以从源码构建安装,也可以下载*.tgz安装包进行安装。

2.1. 从源码安装

git clone https://github.com/vmware/harbor.git

下载源码后,修改./make/harbor.cfg的内容,然后运行make即可。

2.2 下载安装包

https://github.com/vmware/harbor/releases下载预先构建好的安装包,然后解压缩到目录,修改./make/harbor.cfg的内容,运行install.sh即可。

2.3 harbor.cfg修改

主要修改以下几个地方:

#配置Harbor服务的主机IP地址或主机名,注意要与CA证书的完全一致。
#hostname = reg.mydomain.com
hostname = 192.168.1.8

#配置Harbor使用https
#ui_url_protocol = http
ui_url_protocol = https

#改为上面生成的CA客户端证书,注意路径一致,可使用命令`pwd`获得。
#ssl_cert = /path/to/server.crt
ssl_cert = /home/supermap/docker/192.168.1.8.crt

#ssl_cert_key = /path/to/server.key
ssl_cert_key = /home/supermap/docker/192.168.1.8.key

3、客户端配置

如果不在客户端部署证书,docker pull会显示x509: certificate signed by unknown authority。原因在于docker engine对HTTP和未配置证书的https链接拒绝按照信任方式访问。

3.1. 使用非信任链接

如果不在客户端部署证书,docker pull会显示x509: certificate signed by unknown authority,在Docker启动时设置参数 "--insecure-registry IP"即可。客户端部署证书后,即可直接访问,不再报出错信息。

需要使用service docker restart重启服务,在Ubuntu 15.04以后版本,需要使用systemctl daemon-reload && systemctl restart docker重新载入服务参数并重启。

3.2. 在客户端部署证书

将ca.crt 复制到 docker 客户端的 /etc/docker/certs.d/yourdomain.com(registry服务器的IP)。例如:

#获取ca.crt文件,如果目录不存在,则需要预先手动创建之。 
sudo scp user@192.168.1.8:~/docker/ca.crt /etc/docker/certs.d/192.168.1.8/

** 注意:**

  • 每一个客户端都需要复制上面的ca.crt到Docker相应目录,然后重启Docker。
  • 浏览器需要添加“访问例外”,根据提示进行操作。
  • 如果Harbor部署服务器变化,即便IP地址不变,也需要将访问端的浏览器和/etc/docker/certs.d目录下的证书清除、更新,然后还要重启Docker。否则,对于同一个证书,因为重新生成后内容不同,将会被认为造假,被拒绝访问。

如果将nginx 端口 443 设到了其它端口, 则需要创建目录 /etc/docker/certs.d/yourdomain.com: port(registry IP:port),加上端口号即可,如:192.168.1.8:446

** Linux和MacOS系统需要对证书获得系统级的信任。可以参考:Adding trusted root certificates to the server**

  • Ubuntu系统使用下面的办法:
cp 192.168.1.8.crt /usr/local/share/ca-certificates/192.168.1.8.crt
update-ca-certificates
  • MacOS使用下面的办法:
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain 
/root/docker/192.168.1.8.crt

也可以到浏览器中,管理和设置CA证书。对于自签名的根证书,可以选择ca.crt文件直接导入。**然后重启Docker服务。 **

  • MacOS上,在文件管理器中选中ca.crt文件,鼠标右键选择“加入”,然后打开“钥匙串”工具,即可看到被加入的证书。然后即可正常使用docker login登陆到Harbor。

4、使用Harbor

在使用https的情况下,进行了访问控制,需要账号登录进去才能使用。

** 对于向上推送Docker镜像的账号,需要到Harbor管理页面开启该账号的“管理员”权限。**

4.1. 创建账号

到浏览器打开链接 https://192.168.1.8/,登录进去。初始账号是admin,密码Harbor12345。然后创建一个账户openthings。

4.2. login

docker login 192.168.1.8
#输入账号和设置的密码

4.3. tag

docker tag gispark/openrock 192.168.1.8/gispark/openrock:2016.10

4.4. push

将本机镜像192.168.1.8/gispark/openrock推送到Registry中。

docker push 192.168.1.8/gispark/openrock:2016.10

4.5. pull

在其它机器上将镜像拉取下来(也需要预先登录)。

docker pull 192.168.1.8/gispark/openrock:2016.10

然后就可以使用"Docker run ..."运行整个Docker镜像了。

默认Docker的镜像存储在/data目录下,如果根目录空间不够,需要移到其它磁盘,参考:

【Harbor的Docker镜像存储路径修改:https://my.oschina.net/u/2306127/blog/777863

** 根据本人测试,上面的方法在Docker 1.12.3和Ubuntu 16.04、MacOS Sierra和ARM上的Raspberry PI(树莓派)都可以运行。**

展开阅读全文
打赏
0
3 收藏
分享
加载中
更多评论
打赏
0 评论
3 收藏
0
分享
返回顶部
顶部