怎么搭建docker内网私服-亚博电竞手机版
这篇文章给大家分享的是有关怎么搭建docker内网私服的内容。小编觉得挺实用的,因此分享给大家做个参考,一起跟随小编过来看看吧。
搭建docker内网私服的方法,具体如下:
主要思路:
1. docker registry 说明
关于如何创建和使用本地仓库,其实已经有很多文章介绍了。因为docker技术正处于发展和完善阶段,所以有些文章要么内容已经过时,要么给出了错误的配置,导致无法正常创建仓库。本文记录的是个人完整的搭建过程,docker version
为1.1.2。
官方提供了docker hub网站来作为一个公开的集中仓库。然而,本地访问docker hub速度往往很慢,并且很多时候我们需要一个本地的私有仓库只供网内使用。
docker仓库实际上提供两方面的功能,一个是镜像管理,一个是认证。前者主要由docker-registry项目来实现,通过http服务来上传下载;后者可以通过docker-index(闭源)项目或者利用现成认证方案(如nginx)实现http请求管理。
docker-registry既然也是软件应用,自然最简单的方法就是使用官方提供的已经部署好的镜像registry。官方文档中也给出了建议,直接运行sudo docker run -p 5000:5000 registry
命令。这样确实能启动一个registry服务器,但是所有上传的镜像其实都是由docker容器管理,放在了/var/lib/docker/….某个目录下。而且一旦删除容器,镜像也会被删除。因此,我们需要想办法告诉docker容器镜像应该存放在哪里。registry镜像中启动后镜像默认位置是/tmp/registry
,因此直接映射这个位置即可,比如到本机的/opt/data/registry目录下。
2. 在centos上搭建docker私服
2.1 安装docker-registry
方法有多种,直接运行下面的命令:
复制代码 代码如下:
# docker run -d -e settings_flavor=dev -e storage_path=/tmp/registry -v /opt/data/registry:/tmp/registry -p 5000:5000 registry
如果本地没有拉取过docker-registry,则首次运行会pull registry,运行时会映射路径和端口,以后就可以从/opt/data/registry
下找到私有仓库都存在哪些镜像,通过主机的哪个端口可以访问。
你也可以把项目 https://github.com/docker/docker-registry.git 克隆到本地,然后使用dockerfile来build镜像:
#gitclonehttps://github.com/docker/docker-registry.git #cddocker-registry&&mkdir-p/opt/data/registry #dockerbuild-t"local-sean".
build完成后,就可以运行这个docker-registry
我们先配置自己的config.yml文件,第一种方法是直接在run的时候指定变量
#cpconfig/config_sample.yml/opt/data/registry/config.yml #vi/opt/data/registry/config.yml ##这里可以设置本地存储settings_flavor=dev,localstorage_path:/tmp/registry等待 #dockerrun-d-v/opt/data/registry:/tmp/registry-p5000:5000-edocker_registry_config=/tmp/registry/config.ymlregistry 或 dockerrun-d-esettings_flavor=dev-estorage_path=/tmp/registry-v/db/docker-images:/tmp/registry-p5000:5000registry
2.2 客户端使用
要从私服上获取镜像或向私服提交镜像,现在变得非常简单,只需要在仓库前面加上私服的地址和端口,形如172.29.88.222:5000/centos6
。注意,这里可以选择不使用ip,而是用hostname,如registry.domain.com:5000,但不能仅用不带.的主机名registry,docker会认为registry是用户名,建议使用带域名的hostname加port来表示。
于是在另外一台要使用docker的主机上就可以通过这台私服拉取和推送镜像了:
从私服上搜索存在哪些可用镜像
复制代码 代码如下:
# curl -x get http://sean.domain.com:5000/v1/search{"num_results": 2, "query": "", "results": [{"description": "", "name": "library/centos6"}, {"description": "", "name": "library/nginx"}]}
按条件搜索nginx
#curl-xgethttp://sean.domain.com:5000/v1/search?q=centos6
拉取image到本地
dockerpulllibrary/centos6 ##本地对份镜像启动起来,形成container ##给container去另外一个名字 #dockertag68edf809afe7registry.domain.com:5000/centos6-test ##最后将新的dockerimages推送到私服上 dockerpushregistry.domain.com:5000/centos6-test
第一次push到私服上时会提示用户名、密码和邮箱,创建即可。也可以在docker私服端加入认证机制。
3. 加入nginx认证
(请在实际操作以前,先阅读完本节,再确定是否在前端加入nginx)
3.1 安装及配置nginx
从上面的过程可以看到,除非防火墙限制,否则任何主机可以创建账号并想私服推送镜像,更安全的做法是在外层加入登录认证机制。
最好安装1.4.x版本,不然下面的有些配置可能会不兼容
#yuminstallnginx
创建两个登录用户
#htpasswd-c/etc/nginx/docker-registry.htpasswdsean newpassword: re-typenewpassword: addingpasswordforusersean #htpasswd/etc/nginx/docker-registry.htpasswditsection
为了让nginx使用这个密码文件,并且转发8080端口的请求到docker registry,新增nginx配置文件vi /etc/nginx/sites-enabled/docker-registry:
#forversionsofnginx>1.3.9thatincludechunkedtransferencodingsupport #replacewithappropriatevalueswherenecessary upstreamdocker-registry{ serverlocalhost:5000; } server{ listen8080; server_namesean.domain.com;--yourregistryserver_name #sslon; #ssl_certificate/etc/ssl/certs/docker-registry; #ssl_certificate_key/etc/ssl/private/docker-registry; proxy_set_headerhost$http_host;#requiredfordockerclientsake proxy_set_headerx-real-ip$remote_addr;#passonrealclientip client_max_body_size0;#disableanylimitstoavoidhttp413forlargeimageuploads #requiredtoavoidhttp411:seeissue#1486(https://github.com/dotcloud/docker/issues/1486) chunked_transfer_encodingon; location/{ #letnginxknowaboutourauthfile auth_basic"restricted"; auth_basic_user_filedocker-registry.htpasswd; proxy_passhttp://docker-registry; } location/_ping{ auth_basicoff; proxy_passhttp://docker-registry; } location/v1/_ping{ auth_basicoff; proxy_passhttp://docker-registry; } }
让nginx来使用这个virtual-host
#ln-s/etc/nginx/sites-enabled/docker-registry/etc/nginx/conf.d/docker-registry.conf
重启nginx来激活虚拟主机的配置
#servicenginxrestart
3.2 加入认证后使用docker-registry
此时主机的5000端口应该通过防火墙禁止访问(或者在docker run端口映射时只监听回环接口的ip -p 127.0.0.1:5000:5000
)。
#curllocalhost:5000 "docker-registryserver(dev)(v0.8.1)"
如果直接访问访问将得到未授权的信息:
#curllocalhost:8080401authorizationrequired 401authorizationrequired
nginx/1.4.7
带用户认证的docker-registry:
#curlhttp://sean:sean@sean.domain.com:8080/v1/search {"num_results":2,"query":"","results":[{"description":"","name":"library/centos6"},{"description":"","name":"library/nginx"}]} #dockerloginregistry.domain.com:8080 username:sean password: email:zhouxiao@domain.com loginsucceeded #dockerpullregistry.domain.com:8080/library/centos6
不出意外的话,上面的docker pull会失败:
#dockerpullregistry.domain.com:8080/library/centos6 pullingrepositoryregistry.domain.com:8080/library/centos6 2014/11/1121:00:25couldnotreachanyregistryendpoint #dockerpushregistry.domain.com:8080/ubuntu:sean thepushreferstoarepository[registry.domain.com:8080/ubuntu](len:1) sendingimagelist pushingrepositoryregistry.domain.com:8080/ubuntu(1tags) 2014/11/1208:11:32httpcode401,dockerwillnotsendauthheadersoverhttp. nginx日志 2014/11/1207:03:49[error]14898#0:*193nouser/passwordwasprovidedforbasic authenticatget/v1/repositories/library/centos6/tagshttp/1.1",host:"registry.domain.com:8080"
本文后的第1篇参考文档没有出现这个问题,但评论中有提及。
有人说是backend storage
的问题,这里是本地存储镜像,不应该。经过查阅大量资料,并反复操作验证,是docker-registry版本的问题。从v0.10.0
开始,docker login
虽然succeeded,但pull或push的时候,~/.dockercfg下的用户登录信息将不允许通过http明文传输。(如果你愿意可以查看v0.10.0
的源码 registry.go
,在分支v0.9.1及以前是没有http code 401, docker will not send auth headers over http
的)
目前的办法三个:
撤退,这就是为什么先说明在操作前线查看到这的原因了
换成
v0.9.1
及以下版本。现在都v1.3.1
了,我猜你不会这么做修改源码session.go,去掉相应的判断行,然后git下来重新安装。我猜你更不会这么做
安装ssl证书,使用https传输。这是明智的选择,新版本docker也推荐我们这么做,往下看。
3.3 为nginx安装ssl证书
首先打开nginx配置文件中ssl的三行注释
#vi/etc/nginx/conf.d/docker-registry.conf ... server{ listen8000; server_nameregistry.domain.com; sslon; ssl_certificate/etc/nginx/ssl/nginx.crt; ssl_certificate_key/etc/nginx/ssl/nginx.key; ...
保存之后,nginx会分别从/etc/nginx/ssl/nginx.crt和/etc/nginx/ssl/nginx.key
读取ssl证书和私钥。如果你自己愿意花钱买一个ssl证书,那就会变得非常简单,把证书和私钥拷贝成上面一样即可。关于ssl以及签署ssl证书,请参考其他文章。
这里我们自签署一个ssl证书,把当前系统作为(私有)证书颁发中心(ca)。
创建存放证书的目录
#mkdir/etc/nginx/ssl 确认ca的一些配置文件 #vi/etc/pki/tls/openssl.cnf ... [ca_default] dir=/etc/pki/ca#whereeverythingiskept certs=$dir/certs#wheretheissuedcertsarekept crl_dir=$dir/crl#wheretheissuedcrlarekept database=$dir/index.txt#databaseindexfile. #unique_subject=no#setto'no'toallowcreationof #severalctificateswithsamesubject. new_certs_dir=$dir/newcerts#defaultplacefornewcerts. certificate=$dir/cacert.pem#thecacertificate serial=$dir/serial#thecurrentserialnumber crlnumber=$dir/crlnumber#thecurrentcrlnumber #mustbecommentedouttoleaveav1crl crl=$dir/crl.pem#thecurrentcrl private_key=$dir/private/cakey.pem#theprivatekey randfile=$dir/private/.rand#privaterandomnumberfile ... default_days=3650#howlongtocertifyfor ... [req_distinguished_name] countryname=countryname(2lettercode) countryname_default=cn countryname_min=2 countryname_max=2 stateorprovincename=stateorprovincename(fullname) stateorprovincename_default=gd ...[req_distinguished_name]部分主要是颁证时一些默认的值,可以不动
(1) 生成根密钥
#cd/etc/pki/ca/ #opensslgenrsa-outprivate/cakey.pem2048
为了安全起见,修改cakey.pem私钥文件权限为600或400,也可以使用子shell生成( umask 077; openssl genrsa -out private/cakey.pem 2048
),下面不再重复。
(2) 生成根证书
#opensslreq-new-x509-keyprivate/cakey.pem-outcacert.pem
会提示输入一些内容,因为是私有的,所以可以随便输入,最好记住能与后面保持一致。上面的自签证书cacert.pem
应该生成在/etc/pki/ca
下。
(3) 为我们的nginx web服务器生成ssl密钥
#cd/etc/nginx/ssl #opensslgenrsa-outnginx.key2048
我们的ca中心与要申请证书的服务器是同一个,否则应该是在另一台需要用到证书的服务器上生成。
(4) 为nginx生成证书签署请求
#opensslreq-new-keynginx.key-outnginx.csr ... countryname(2lettercode)[au]:cn stateorprovincename(fullname)[some-state]:gd localityname(eg,city)[]:sz organizationname(eg,company)[internetwidgitsptyltd]:company organizationalunitname(eg,section)[]:it_section commonname(e.g.serverfqdnoryourname)[]:your.domain.com emailaddress[]: pleaseenterthefollowing'extra'attributes tobesentwithyourcertificaterequest achallengepassword[]: anoptionalcompanyname[]: ...
同样会提示输入一些内容,其它随便,除了commone name
一定要是你要授予证书的服务器域名或主机名,challenge password不填。
(5) 私有ca根据请求来签发证书
#opensslca-innginx.csr-outnginx.crt
上面签发过程其实默认使用了-cert cacert.pem -keyfile cakey.pem
,这两个文件就是前两步生成的位于/etc/pki/ca
下的根密钥和根证书。
到此我们已经拥有了建立ssl安全连接所需要的所有文件,并且服务器的crt和key都位于配置的目录下,唯有根证书cacert.pem
位置不确定放在centos6下的哪个地方。
经验证以下几个位置不行:(adding trusted root certificates to the server)/etc/pki/ca-trust/source/anchors、/etc/pki/ca-trust/source、/etc/pki/ca-trust/extracted、/etc/pki/ca-trust/extracted/pem/、/etc/pki/tls/certs/cacert.crt
都会报错:
#dockerloginhttps://registry.domain.com:8000 username(sean):sean 2014/11/1402:32:48errorresponsefromdaemon:invalidregistryendpoint:gethttps://registry.domain.com:8000/v1/_ping:x509:certificatesignedbyunknownauthority #curlhttps://sean:sean@registry.domain.com:8000/ curl:(60)peercertificatecannotbeauthenticatedwithknowncacertificates moredetailshere:http://curl.haxx.se/docs/sslcerts.html curlperformssslcertificateverificationbydefault,usinga"bundle" ofcertificateauthority(ca)publickeys(cacerts).ifthedefault bundlefileisn'tadequate,youcanspecifyanalternatefile usingthe--cacertoption. ifthishttpsserverusesacertificatesignedbyacarepresentedin thebundle,thecertificateverificationprobablyfailedduetoa problemwiththecertificate(itmightbeexpired,orthenamemight notmatchthedomainnameintheurl). ifyou'dliketoturnoffcurl'sverificationofthecertificate,use the-k(or--insecure)option.
(6) 目前让根证书起作用的只发现一个办法:
#cp/etc/pki/tls/certs/ca-bundle.crt{,.bak}备份以防出错 #cat/etc/pki/ca/cacert.pem>>/etc/pki/tls/certs/ca-bundle.crt #curlhttps://sean:sean@registry.domain.com:8000 "docker-registryserver(dev)(v0.8.1)"
将cacert.pem
根证书追加到ca-bundle.crt
后一定要重启docker后台进程才行。
如果docker login依然报错certificate signed by unknown authority
,参考running docker with https,启动docker后台进程时指定信任的ca根证书:
#docker-d--tlsverify--tlscacert/etc/pki/ca/cacert.pem 或者将cacert.pem拷贝到~/.docker/ca.pem #mkdir~/.docker&&cp/etc/pki/ca/cacert.pem~/.docker/ca.pem #docker-d 最好重启一下registry #dockerrestart
上面用“如果”是因为一开始总提示certificate signed by unknown authority
,有人说将根证书放在/etc/docker/certs.d
下,还有人说启动docker daemon收加入--insecure-registry
.. 但终究是因为版本差异不成功。但后来又奇迹般的不需要--tlscacert
就好了。这个地方挣扎了很久,重点关注一下这个下面几个issue:
https://github.com/docker/docker-registry/issues/82
https://github.com/docker/docker/pull/2687
https://github.com/docker/docker/pull/2339
(7) 最终搞定:
#dockerloginhttps://registry.domain.com:8000 username:sean password: email:zhouxiao@domain.com loginsucceeded #curlhttps://sean:sean@registry.domain.com:8000 "docker-registryserver(dev)(v0.8.1)" #dockerpushregistry.domain.com:8000/centos6:test_priv thepushreferstoarepository[registry.domain.com:8000/centos6](len:1) sendingimagelist pushingrepositoryregistry.domain.com:8000/centos6(1tags) 511136ea3c5a:imagesuccessfullypushed 5b12ef8fd570:imagesuccessfullypushed 68edf809afe7:imagesuccessfullypushed 40627956f44c:imagesuccessfullypushed pushingtagforrev[40627956f44c]on{https://registry.domain.com:8000/v1/repositories/centos6/tags/test_priv}
但还有一个小问题没解决,虽然已经可以正常使用,但每次请求在nginx的error.log中还是会有[error] 8299#0: *27 no user/password was provided for basic authentication
,应该是这个版本docker暂未解决的bug。
3.3 其它问题
(1) docker后台进程意外中断后,重新docker start
报错
#dockerstartb36bd796bd3d error:cannotstartcontainerb36bd796bd3d:errorgettingcontainerb36bd796bd3d463c4fedb70d98621e7318ec3d5cd14b2f60b1d182ad3cbcc652 fromdriverdevicemapper:errormounting'/dev/mapper/docker-253:0-787676-b36bd796bd3d463c4fedb70d98621e7318ec3d5cd14b2f60b1d182ad3cbcc652' on'/var/lib/docker/devicemapper/mnt/b36bd796bd3d463c4fedb70d98621e7318ec3d5cd14b2f60b1d182ad3cbcc652':deviceorresourcebusy 2014/11/0815:14:57error:failedtostartoneormorecontainers
经分析产生这个问题的原因是做了一个操作:在docker后台进程启动的终端,继续回车后会临时退出后台进程的日志输出,我就在这个shell下使用yum安装软件包,但由于网络原因yum卡住不动,于是我就另起了一个终端kill了这个yum进程,不知为何会影响到表面已经退出前台输出的docker。解决办法是umount容器的挂载点:(见这里)
#umount/var/lib/docker/devicemapper/mnt/b36bd796bd3d463c4fedb70d98621e7318ec3d5cd14b2f60b1d182ad3cbcc652 #servicedockerstart正常
能想到的另外一个办法是,启动docker后台进程时,重定向输出docker -d > /dev/null 2>&1(/var/log/docker已自动记录了一份日志)。
(2) 配置完nginx的docker-registry.conf后启动报错
#servicenginxstart [emerg]14714#0:unknowndirective"upstream"in/etc/nginx/conf.d/docker-registry.conf:4
原因是nginx版本太低,一些配置指令不兼容,使用yum install nginx默认安装了1.0.x,卸载重新下载nginx-1.4.7-1.el6.ngx.x86_64.rpm
安装解决。
(3) 网络设置代理问题
pull, push亚博电竞手机版官网的镜像时由于gfw的原因需要设置代理,但不是http_proxy而是http_proxy,对于docker来说同时设置这两个值就会出问题,有时出于安装软件包的需要设置http_proxy,就会导致冲突。在docker-registry中如果忘记了当前哪一个在起作用,找遍所有问题都发现不了原因,而docker返回给我们的错误也难以判断。切记~
to-do如何删除docker-registry的里的镜像
感谢各位的阅读!关于“怎么搭建docker内网私服”这篇文章就分享到这里了,希望以上内容可以对大家有一定的帮助,让大家可以学到更多知识,如果觉得文章不错,可以把它分享出去让更多的人看到吧!