docker部署私有registry指南

1.版本信息

通过 docker version 命令可以获取当前docker版本信息

Client:
 Version:         1.13.1
 API version:     1.26
 Package version: docker-1.13.1-103.git7f2769b.el7.centos.x86_64
 Go version:      go1.10.3
 Git commit:      7f2769b/1.13.1
 Built:           Sun Sep 15 14:06:47 2019
 OS/Arch:         linux/amd64

Server:
 Version:         1.13.1
 API version:     1.26 (minimum version 1.12)
 Package version: docker-1.13.1-103.git7f2769b.el7.centos.x86_64
 Go version:      go1.10.3
 Git commit:      7f2769b/1.13.1
 Built:           Sun Sep 15 14:06:47 2019
 OS/Arch:         linux/amd64
 Experimental:    false

2.部署registry镜像

2.1 搜索registry镜像

通过 docker search registry 命令搜索registry相关镜像

docker search registry

如下是部分搜索结果，OFFICIAL 表示是官方镜像

搜索结果.png

2.2 拉取registry镜像

通过 docker pull registry 命令拉取registry镜像，默认是latest版本

docker pull docker.io/registry

拉取成功后，可以通过 docker images 确认镜像

docker images

2.3 以基础启动registry容器

启动命令如下：

docker run -d -p 5000:5000 --name registry \
--restart=always docker.io/registry

-d 表示后台启动
-p 表示端口映射
--name 表示指定名称
--restart=always 表示自动重启

验证启动情况：

docker ps -a

docker ps 可以查看正在运行的容器
-a 查看全部状态的容器

访问容器rest接口

# curl 命令访问registry的rest接口
curl http://127.0.0.1:5000/v2/_catalog

# 返回结果如下
{"repositories":""}

3.进阶部署之鉴权部署

3.1 配置用户名密码

创建相关目录用于保存数据到宿主机环境

mkdir -p /opt/registry/ /opt/registry/auth opt/registry/data

创建用户信息并保存

docker run --entrypoint htpasswd docker.io/registry:latest \
  -Bbn testuser testpwd > /opt/registry/auth/htpasswd

testuser 自定义的用户名
testpwd 自定义的用户密码
> /opt/registry/auth/htpasswd 输出htpasswd文件到/opt/registry/auth/

3.2 以鉴权的方式启动registry

docker run -d -p 5000:5000 --name registry --restart=always \ 
-v /opt/registry/data:/var/lib/registry \
-v /opt/registry/auth:/auth \
-e "REGISTRY_AUTH=htpasswd" \
-e "REGISTRY_AUTH_HTPASSWD_REALM=Registry Realm" \
-e REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd \
docker.io/registry:latest

-v 挂载本地目录，即建立宿主机与容器之间目录的映射关系
-e 指定环境变量
-p 指定端口的映射关系
-d 以后台的方式启动
--name 指定名称
--restart=always 总是启动

如遇启动问题，请先停止原有registry容器：

# 停止registry，之前指定了--name
docker stop registry

# 移除容器
docker rm registry

3.3 验证鉴权启动结果

## 原有方式

# curl http://127.0.0.1:5000/v2/_catalog
# {"errors":[{"code":"UNAUTHORIZED","message":"authentication required","detail":[{"Type":"registry","Class":"","Name":"catalog","Action":"*"}]}]}

## 鉴权方式

# curl http://127.0.0.1:5000/v2/_catalog -u testuser:testpwd
# {"repositories":""}

4.进阶部署之配置证书

4.1 配置证书目录

# mkdir -p /opt/registry/certs

4.2 使用openssl生成证书（有证书可以跳过此步骤）

# 生成证书
openssl req -newkey rsa:2048 -nodes -sha256 \
-keyout /opt/registry/certs/domain.key \
-x509 -days 3650 -out /opt/registry/certs/domain.crt

4.3 使用证书其鉴权方式启动

docker run -d -p 5000:5000 --name registry --restart=always \
-v /opt/registry/data:/var/lib/registry \
-v /opt/registry/auth:/auth \
-v /opt/registry/certs:/certs \
-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
docker.io/registry:latest

REGISTRY_HTTP_TLS_CERTIFICATE ：指定crt文件路径
REGISTRY_HTTP_TLS_KEY：指定key文件路径

5.常见问题

# docker login http://XXXX
Username: testuser
Password: testpwd
Error response from daemon : Get https://XXX/v2 : http: server gave HTTP response to HTTPS client

从错误描述可以看出，服务端把我们的客户端当成HTTPS client，我们需要配置客户端，daemon.json 文件
docker login -u testuser -p testpwd http://xxxx 可以略过输入密码过程

将 http://XXXX 添加到客户端 daemon.json 的insecure-registries 中。

# cd /etc/docker
# vim daemon.json
{
  "insecure-registries" : [
    "http://xxxx"
  ]
}

使用docker info 检查配置是否生效

docker info

Linux CentOS 重启docker 服务

systemctl restart docker

5.2 push镜像是返回 HTTP 413 response body: invalid character

客户端推送镜像是返回如下异常：

error parsing HTTP 413 response body: invalid character '<'  looking for beginning of value: "<html>\r\n<head><title>413  Request Entity Too Large</title></head>\r\n<body  bgcolor=\"white\">\r\n<center><h1>413 Request Entity Too  Large</h1></center>\r\n<hr> <center>openresty/1.13.6.2</center>\r\n</body>\r\n</html>\r\ n"

可能原因：如果您使用了nginx代理了自己的registry，需要修改nginx.conf 文件，解除大小限制

# 在http，server，location均可以设置，不同的设置，影响范围不一样。
client_max_body_size 0;

5.3 宿主机时间与容器内时间不一致，相差8小时

# date
Fri Dec 27 10:16:48 CST 2019

## 进入容器内执行结果
# docker exec -it registry /bin/sh
sh-4.2# date
Fri Dec 27 02:16:48 UTC 2019

原因：我国时区处于东八区

解决办法：

## 方法一：启动时挂载宿主机时间
docker run -d -p 5000:5000 --name registry -v /etc/localtime:/etc/localtime -v /opt/registry/:/var/lib/registry docker.io/registry:latest

## 方法二：复制本机时间至容器内
docker cp /etc/localtime registry:/etc/localtime

如返回：Error response from daemon: Error processing tar file(exit status 1): invalid symlink "/etc/localtime" -> "/usr/share/zoneinfo/Asia/Shanghai"，执行以下命令

## 方法三：备份
docker cp /usr/share/zoneinfo/Asia/Shanghai registry:/etc/localtime

作者是一个技术肥宅，还在不断的学习进步中，十分欢迎各位杠精读者指出文中不足之处，快来给我留言吧；欢迎转载，烦请注明出处。

本文作者： sexylowrie

本文链接： https://www.sunce.wang/archives/docker部署私有registry指南

版权声明： 本博客所有文章除特别声明外，均采用CC BY-NC-SA 3.0 许可协议。转载请注明出处！