如何使用 Docker 开源仓库建立代理缓存仓库

开源 Docker 仓库 v2的其中一个最新特性:能够被用作代理缓存仓库,以缓存 Docker Hub 上的镜像。运行一个缓存仓库允许你在本地储存镜像,减少过多的通过互联网从 Docker Hub 拉取镜像,这个特性对于一些在他们环境中拥有数量庞大的 Docker 引擎的用户来说很有用。跟着本篇教程,你可以让 Docker 引擎从本地代理缓存仓库拉取镜像,而不是让每个引擎总是从 Docker Hub 拉取,从而节省时间和带宽。

你可以这样开始:

要求:

Docker 引擎 1.8.3

Docker 仓库 v2

足够储存 Docker 镜像的磁盘空间

TLS 证书和密钥

持久化数据

在这个例子中,我们会假设你会储存所有持久化数据在本地文件系统的/data路径下,这个路径下包含 TLS 证书和密钥文件,配置文件和镜像缓存文件。我们之后会用卷挂载这个目录进运行仓库的容器。

保护你的代理缓存仓库安全

代理缓存仓库需要一个 TLS 证书来保证 Docker 引擎和缓存仓库之间的连接安全,在这个例子中,我们会放置我们证书文件(domain.crt)和密钥文件(domain.key)在主机的/data 目录。

更多关于使用 TLS 加强仓库安全的信息,请参照Docker仓库2.0文档

创建代理缓存仓库配置文件

下一步你需要创建一个配置文件,来把这个仓库用作代理缓存。你可以用 cat 命令把registry:2镜像中的缺省配置文件重定向输出到一个文件中:

sh

$ docker run -it --rm --entrypoint cat registry:2 \

/etc/docker/registry/config.yml > /data/config.yml

我强烈建议从 Docker 镜像中获得这个默认配置,而不是使用例子中的配置,因为将来这个默认配置可能会有更新。

默认的 config.yml 例子:

yaml

version: 0.1

log:

fields

service: registry

storage:

cache:

layerinfo: inmemory

filesystem:

rootdirectory: /var/lib/registry

http:

addr: :5000

修改 'http' 这节配置上 TLS:

yaml

http:

addr: :5000

tls:

certificate: /var/lib/registry/domain.crt

key: /var/lib/registry/domain.key

在配置文件中新加一节 'proxy' 来开启缓存:

yaml

proxy:

remoteurl: https://registry-1.docker.io

username: [username]

password: [password]

'username'和'password'这两个选项是可选的,这是 Docker Hub 账号的用户名和密码,设置上这两个选项,会使代理缓存仓库获取到这个账号的同等权限,也就是说,这个用户有权限获取的镜像,这个缓存仓库同样有权限获取。

请确保完全理解设置这个Docker Hub账号背后意味着什么,并且确保你镜像的安全还有严格的访问权限!如果你不确定,请不要再配置包含用户名和密码,那么你的代理缓存仓库就只会缓存公共镜像。

启动代理缓存仓库的容器:

sh

$ docker run -d --restart=always -p 5000:5000 --name v2-mirror \

-v /data:/var/lib/registry registry:2 /var/lib/registry/config.yml

以上命令使用一个卷把宿主机上的 /data 挂载进了容器中,使容器能使用持久储存镜像缓存, TLS 证书和密钥,还有自定义的仓库配置文件。

验证你的代理缓存仓库已经启动并正常运行:

sh

$ curl -I https://mycache.example.com:5000/v2/

HTTP/1.1 200 OK

Content-Length: 2

Content-Type: application/json; charset=utf-8

Docker-Distribution-Api-Version: registry/2.0

Date: Thu, 17 Sep 2015 21:42:02 GMT

配置你的 Docker 引擎使用代理缓存仓库

修改 Docker 守护进程的启动参数,加上--registry-mirror选项:

sh

--registry-mirror=https://:

例如,如果你的缓存仓库的主机名为 http://mycache.example.com 并且仓库服务端口为 5000,你需要加上以下选项到守护进程的参数:

sh

--registry-mirror=https://mycache.example.com:5000

参考在各种的 Linux 分发版中配置运行 Docker 了解更多信息关于如何添加 Docker 守护进程参数。

测试你的代理缓存仓库

从 Docker Hub 上拉取一个你本地没有的镜像。例如, busybox:latest 镜像:

sh

$ docker pull busybox:latest

检查缓存仓库中的目录,验证 busybox 镜像是否被缓存:

sh

$ curl https://mycache.example.com:5000/v2/_catalog

{"repositories":["library/busybox"]}

你也可以验证 latest 标签是否被缓存:

sh

$ curl https://mycache.example.com:5000/v2/library/busybox/tags/list

{"name":"library/busybox","tags":["latest"]}

现在开始当你拉取镜像时,镜像将被缓存到你的代理缓存仓库,之后拉取相同的镜像时会更快,并且这些镜像缓存会维护自身,当他们不再被使用时将会自动清除。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,242评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,769评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,484评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,133评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,007评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,080评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,496评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,190评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,464评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,549评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,330评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,205评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,567评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,889评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,160评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,475评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,650评论 2 335

推荐阅读更多精彩内容