docker私有仓库搭建,证书认证,鉴权管理

Docker 是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中,然后发布到任何流行的 Linux 机器上,也可以实现虚拟化。

 

我们知道docker镜像可以托管到dockerhub中,跟代码库托管到github是一个道理。但如果我们不想把docker镜像公开放到dockerhub中,只想在部门或团队内部共享docker镜像,能不能像gitlab一样在搭建私有的仓库呢?答案是肯定的,docker也支持将镜像存到私有仓库。

 

这篇文章默认你的机器上已经安装了docker,并有了docker的一些基础知识,本文主要讲私有仓库搭建,证书认证,鉴权管理等内容,关于docker的内容请参考其他文章。

 

如果Docker还不会,可以在公众号回复“docker”,会有docker视频教程提供给你进行学习。

 

开始搭建私有仓库

 

假设我们有两台机器,一台是Client是平时工作用的,IP是192.168.1.100,一台是Server安装私有仓库的,IP是192.168.1.200。

 

我们在Server机器上搭建私有仓库,一条命令即可,非常简单

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

 

--name 用来设置容器的名字

-d 后台启动

-p 5000:5000 指定宿主机5000端口映射容器5000端口,

--restart=always Docker容器的重启策略

 

Docker容器的重启策略是面向生产环境的一个启动策略

 

 no,默认策略,在容器退出时不重启容器

    on-failure,在容器非正常退出时(退出状态非0),才会重启容器

    on-failure:3,在容器非正常退出时重启容器,最多重启3次

    always,在容器退出时总是重启容器

    unless-stopped,在容器退出时总是重启容器,但是不考虑在Docker守护进程启动时就已经停止了的容器

 

docker run的退出状态码如下:

 

0,表示正常退出

非0,表示异常退出(退出状态码采用chroot标准)

    125,Docker守护进程本身的错误

    126,容器启动后,要执行的默认命令无法调用

    127,容器启动后,要执行的默认命令不存在

    其他命令状态码,容器启动后正常执行命令,退出命令时该命令的返回状态码作为容器的退出状态码。

    

这条命令执行完成以后,如果是第一次执行,docker会从dockerhub中去下载这个registry镜像到本地。然后运行生成容器。

 640?wx_fmt=png

 

我们执行docker ps 看一下容器是否启动成功。

$ docker ps

 

640?wx_fmt=png

 

我们可以看到有一个name为docker-registry的容器已经启动成功。这就是我们私有仓库了。怎么样,简单吧。继续下一步,把客户端的镜像提交到服务端的仓库里。

 

提交镜像

 

我们现在切换到工作机器上进行提交镜像,也就是Client端,执行命令docker pull tomcat,从hub.docker.com下载最新版本的tomcat镜像.

 

$ docker pull tomcat

 

640?wx_fmt=png

 

执行命令docker images查看镜像列表。

 

$ docker images

 

640?wx_fmt=png

 

这个镜像的ID是dd6ff929584a,下面我们给这个镜像添加一个带有私有仓库IP的TAG,这样才能成功推送到私有仓库:

 

$ docker tag dd6ff929584a 192.168.1.200:5000/tomcat

 

640?wx_fmt=png

 

然后把这个镜像推送到私有仓库

$ docker push 192.168.1.200:5000/tomcat

 

但是当执行这条命令的时候报错了:

Get https://192.168.1.200:5000/v2/: http: server gave HTTP response to HTTPS client

 

原因是:Client与Registry交互,默认将采用https访问,但我们在install Registry时并未配置指定任何tls相关的key和crt文件,https访问定然失败。

 

解决:在Client端都要修改,“/etc/docker/”目录下,创建“daemon.json”文件,在文件中写入:

 

{ "insecure-registries": [ "192.168.1.200:5000" ] }

 

或者

 

vim /lib/systemd/system/docker.service 
添加 ExecStart=/usr/bin/dockerd --insecure-registry 192.168.1.200:5000

 

然后执行下面命令

 

刷新配置
$ systemctl daemon-reload
重启docker
$ systemctl restart docker

 

这么配置之后,Client将以http的方式推送镜像,然后再次push,OK,成功。

 

执行命令查看私有仓库里的镜像

 

$ curl http://192.168.1.200:5000/v2/_catalog 

返回

{"repositories":["tomcat"]}

 

curl http://192.168.1.200:5000/v2/tomcat/tags/list

返回

{"name":"tomcat","tags":["latest"]}

 

但是,这样操作会有个问题,如果有很多台Client的话,每一台Client都要这么配置,非常麻烦。怎么解决呢?我们给Server端加个证书吧。

 

Secure Registry

 

Docker官方是推荐你采用Secure Registry的工作模式的,即transport采用tls。这样我们就需要为Registry配置tls所需的key和crt文件了。

 

可以使用openssl生成自签名证书,在测试环境可以这么用,但是在生产环境我们还是用CA签发的认证证书吧。证书是收费的(按年),少则一两千,多则七八千。(网上有人说还有几十的,实际还没看到过)但有些公司就是不愿意花钱,还有一些个人网站更不愿意花钱了。

 

制作自签署证书

 

openssl是一个开源程序的套件、这个套件有三个部分组成:一是libcryto,这是一个具有通用功能的加密库,里面实现了众多的加密库;二是libssl,这个是实现ssl机制的,它是用于实现TLS/SSL的功能;三是openssl,是个多功能命令行工具,它可以实现加密解密,甚至还可以当CA来用,可以让你创建证书、吊销证书。

 

我们在Server端执行openssl命令

 

$ openssl req -newkey rsa:2048 -nodes -sha256 -keyout /certs/domain.key -x509 -days 365 -out /certs/domain.crt

 

这样证书就生成好了,在继续下一步之前,我们先讲讲如何生成CA认证的免费证书。

 

Certbot免费证书

 

那么当然我们要用免费证书了啊,而且可用于生产环境,具体怎么用,看这篇文章,生成免费可用于生产环境证书 非常详细。其实也就是一条命令而已。

 

$ certbot certonly --cert-name test.qq.com

 

test.qq.com是你们公司的域名,生产环境必须要有域名,替换成你们公司域名即可。

    

640?wx_fmt=png

输入命令后,会出现几个选择,第一个是如果你启动了ngxin的话,利用nginx插件的方式生成证书,如果没有就选择2,Certbot 会启动一个临时服务器来完成验证(会占用80端口或443端口,因此需要暂时关闭 Web 服务器),然后 Certbot 会把证书以文件的形式保存,包括完整的证书链文件和私钥文件。

 

640?wx_fmt=png

 

当然选择完1,继续输入test.qq.com域名的后发现报错了,因为我的真实域名不是test.qq.com,只是随便写了一个,但是Certbot会进行验证,发现验证不通过。所以如果你有实际真实域名请用真实域名,然后配置DNS域名服务器,把域名指向你机器的ip地址,这样才能验证通过。我用一个实际的域名继续配置,就能成功了。

 

注意:下面例子中用到的域名是我实际的真是域名,请更换你自己的域名才能成功执行

 

640?wx_fmt=png

 

我们能看到成功信息里有显示证书的生成路径。OK,我们到这个路径下查看

 

$ cd /etc/letsencrypt/live

 

就能看到这个目录下有一个我们域名命名的目录。继续进入这个目录

 

640?wx_fmt=png

 

里面就是我们需要的证书,这个地方要注意,这个目录下的文件都是L开头的,说明它是一个链接文件,就相当于我们windows里面的快捷方式,后面箭头指向的才是真正的文件路径。

 

$ cd ../../archive/test.leautolink.com 

 

这里才是实际的文件。但是这些文件都是pem文件,docker-registry要求是crt和key文件,所以我们要进行转换。

 

$ mkdir /certs
$ cat domain.crt fullchain1.pem > /certs/domain.crt
$ cat domain.key privkey1.pem > /certs/domain.key

 

执行完成以后,我们会看到/certs下有两个文件,一个是domain.crt,一个是domain.key

 

然后再执行 mkdir -p /docker-registry/data 这个目录用来挂载镜像数据,这样镜像上传到私有仓库后,当仓库被删除,这些镜像也不会丢失。

 

$ mkdir -p /docker-registry/data 

 

开始搭建Secure Registry私有仓库

 

$ docker run --name docker-registry 
-v /docker-registry/data:/var/lib/registry
-v /certs:/certs
-e REGISTRY_HTTP_TLS_CERTIFICATE=/certs/domain.crt
-e REGISTRY_HTTP_TLS_KEY=/certs/domain.key
-d -p 5000:5000 --restart=always registry:2

 

-v 是挂载数据的

-e 是设置环境变量的,通过两个环境变量设置了证书。

 

执行docker ps

$ docker ps

 

640?wx_fmt=png

 

当看到PORTS下有端口映射显示的时候,说明你已经搞定了。

 

现在我们切换到Client机器上

 

如果我们用的是openssl的话,需要修改一下/etc/hosts文件加入

 

192.168.1.200 test.leautolink.com

 

执行命令

$ docker tag dd6ff929584a test.leautolink.com:5000/tomcat

$ docker push test.leautolink.com:5000/tomcat

 

640?wx_fmt=png

已经显示push成功了。

 

curl https://test.leautolink.com:5000/v2/_catalog

返回

{"repositories":["tomcat"]}

 

curl https://test.leautolink.com:5000/v2/tomcat/tags/list

返回

{"name":"tomcat","tags":["latest"]}

 

说明我们push到私有仓库的tomcat已经查询到了。

 

注意,我们访问的是https不是http,因为我们加了证书只支持https,如果支持http访问的话,还是需要配置第一讲的内容。

 

这时可以随便再找一台机器进行下载这个进行,ok一切顺利。

 

$ docker pull test.leautolink.com:5000/tomcat

 

这样所有可以连接这台机器的电脑都可以下载和上传镜像了。

 

但是你有没有发现这样很不安全。那我们继续下一步,让它变的更安全一些,我们给他加上用户名密码登录,只有登录成功才能进行上传下载镜像操作。

 

Registry的鉴权管理

 

Registry提供了一种基础的鉴权方式,我们在Register server上,为Registry增加test用户,密码test123

 

生成鉴权密码文件

 

$ mkdir /auth
$ docker run --entrypoint htpasswd registry:2 -Bbn test test123 > /auth/htpasswd
$ ls auth
htpasswd

 

启动带鉴权功能的Registry

 

$ docker run  --name docker-registry 
-v /docker-registry/data:/var/lib/registry
-v /certs:/certs
-v /auth:/auth
-e "REGISTRY_AUTH=htpasswd"
-e "REGISTRY_AUTH_HTPASSWD_REALM=Registry Realm"
-e REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd
-e REGISTRY_HTTP_TLS_CERTIFICATE=/certs/domain.crt
-e REGISTRY_HTTP_TLS_KEY=/certs/domain.key
-d -p 5000:5000 --restart=always registry:2

 

这条命令比上一讲多一个挂载/auth目录以及多设置两个-e 的环境变量。执行docker ps 可以看到仓库已创建成功。

 

我们切换到Client端把刚才生成的tomcat镜像进行提交

 

$ docker push test.leautolink.com:5000/tomcat

 

640?wx_fmt=png

 

提示鉴权失败。

 

那么我们要做的就是先登陆到私有仓库,然后再进行提交。

 

$ docker login test.leautolink.com:5000

 

然后再输入用户名test,密码test123,回车,提示登陆成功

 

640?wx_fmt=png

 

我们再次push,可以看到这次就能push成功。上面虽然用了两台机器进行操作,是为了明显区分Client和Server,如果你机器有限,一台机器就够用了,你要理解什么时候是Client,什么时候是Server就行了。

 

大功告成,今天就到这里,如有疑问,请在下方留言,或者返回首页,点击菜单“互扯”,添加博主微信进行讨论。

 

如果Docker还不会,可以在公众号回复“docker”,会有docker视频教程提供给你进行学习。

 

陛下...看完奏折,点个赞再走吧!

 

推荐阅读

 

技术:如何成功抢到回家的火车票!

技术:Linux 命令行快捷键

技术:超详细黑苹果安装图文教程送EFI配置合集及系统

技术:恐怖的广告推送。其实,我们每天都在“裸奔”!

技术:如果我不说,你能看出这个主播不是真人吗?

技术:IaaS,PaaS和SaaS,QPS,RT和TPS,PV,UV和IP到底是什么意思?

技术:项目多环境切换——Maven Profile

 

posted @ 2021-02-23 14:37  ITer的运维人生  阅读(715)  评论(0编辑  收藏  举报