Docker Registry 安装和运行

使用场景

• 内部网络，无法访问​​Docker Hub​​
• 控制 image 的存储方式和存储位置
• 控制 image 的部署流程
• 内部开发流程需要集成控制 image 的部署和存储
  应用逻辑示意图：

安装 Registry 服务

概要

Docker Registry 在 docker hub 的名称是 ​​registry​​​。v1 版本的源码地址 github.com/docker/docker-registry 已经废弃，v2 版本源码地址在 github.com/docker/distribution，对应的 API 是 ​​Docker Registry HTTP API V2​​​。以下安装没有使用 HTTPS 方式，启用 HTTPS 相关的证书配置参考这个文档：
​Docker Registry 私有 Docker 站 官方文档参考：

• ​​Docker Hub 上的 registry 镜像介绍文档​​
• ​​Docker 官方 Registry 部署文档​​
• Docker 相关命令行介绍：​​docker build​​​、​​docker tag​​​、​​docker push​​

最简安装（启动）

​​docker run -d -p 5000:5000 --name registry registry:2​​ 以上命令未使用用户名密码登录策略。

启用登录密码

生成密码
登录密码可以通过 host 的文件传入，以下命令调用容器的 htpasswd 命令生成密码文件：

mkdir auth
docker run --entrypoint htpasswd registry:2 -Bbn <USER_NAME> <PASSWORD> >

启用密码
通过 –volume 参数传入密码文件：

docker run -d -p 5000:5000 --restart=always --name registry \
  --volume `PWD`/auth:/auth \
  --env "REGISTRY_AUTH=htpasswd" \
  --env "REGISTRY_AUTH_HTPASSWD_REALM=Registry Realm" \
  --env REGISTRY_AUTH_HTPASSWD_PATH=/auth/auth.htpasswd \
  registry:2

修改镜像存储

默认镜像数据存储在 Docker Volume 中，可以通过 bind mount 进行修改，参数信息参考 ​​Volume文档​​。下面的例子将本机目录 PWD/images 绑定到容器的 /var/lib/registry

docker run -d -p 5000:5000 \
    --name auth-registry \
    -v `PWD`/images:/var/lib/registry \
    -e SQLALCHEMY_INDEX_DATABASE=sqlite:opt/docker-image/docker-registry.db \
    -e STORAGE_PATH=/opt/docker-image \
    --restart=always \
    docker.onestch.com:5000/admin/registry:0.1

默认的存储引擎为本地文件系统，可以修改文件的存储引擎为 Amazon S3 bucket、Google Cloud Platform 或其他引擎，可以通过配置 config.yml 的方式修改存储配置，更多信息参考 ​​Docker Registry 存储配置文档​​。

停止服务

停止 registry 容器并清理运行数据 ​​docker stop registry && docker rm -v registry​​

验证

查看容器信息 ​​docker ps --no-trunc​​ 查看全部配置信息或部分信息

docker inspect <CONTAINER_ID> 
docker inspect <CONTAINER_ID> | grep -C3 -e "Volumes\":"
docker inspect <CONTAINER_ID> | grep -C2 Binds
docker inspect -f '{{ .Mounts }}' <CONTAINER_ID>

查看映射的详细信息 ​​docker volume inspect 4496b0a257b966052ef8d0743014a4f63fc9924251c8de0df0e9c70fde4c45e6​​

发布镜像

登录服务

如果安装（启动）的 registry 服务需要登录访问时，执行：​​docker login <REGISTRY_HOST>:<REGISTRY_PORT>​​ 输入安装时设定的用户名密码。

目标地址

使用 docker tag 设定镜像的目标地址，镜像的目标地址包括三部分

<HOST_NAME>[:<HOST_PORT>]/<IMAGE_NAME>:<IMAGE_VERSION>

• HOST_NAME : HOST_PORT 目标 registry 服务地址，缺省时使用官方 docker hub 的地址 registry-1.docker.io，且不允许包含下划线
• IMAGE_NAME 发布目标镜像名称
• IMAGE_VERSION 发布目标镜像版本

例如：repo.company.com:3456/myapp:0.1

发布镜像

发布的镜像文件可以从 docker hub 中 Pull 或者本地使用 Dockerfile build 获得
Pull
​​​docker pull registry​​

Build
​​​docker build -t docker.onestch.com:5000/admin/registry:0.1 .​​​ 首先需要对镜像 tag 设定目标仓库，如果 build 的时候已经设置了目标地址，可以不用进行 tag 操作
​​docker tag registry:latest docker.onestch.com:5000/admin/registry:0.1​​ 然后 Push
​​docker push docker.onestch.com:5000/admin/registry:0.1​​

验证

重新从私有仓库中获取镜像
​​​docker pull localhost:5000/admin/registry:0.1​​

0.1: Pulling from admin/registry
Digest: sha256:d738e358b6910d3a53c9c7ff7bbb5eac490ab7a9b12ffb4c1c27f2c53aae9275
Status: Image is up to date for localhost:5000/admin/registry:0.1

安装 Registry UI

选择 registry ui，可选的有 ​​atcol/docker-registry-ui​​​、​​hyper/docker-registry-web​​​、​​konradkleine/docker-registry-frontend​​等

安装运行

针对 hyper/docker-registry-web，使用 BASIC 认证，未使用 HTTPS的情况

docker run -it -p 8080:8080 \
    --rm \
    --name registry-web \
    --link auth-registry \
    -e REGISTRY_URL=http://auth-registry:5000/v2 \
    -e REGISTRY_AUTH_ENABLED=false \
    -e REGISTRY_BASIC_AUTH=YWRtaW46MTIzNDU2 \
    -e REGISTRY_NAME=docker.onestch.com:5000 hyper/docker-registry-web

命令中 auth-registry 是自定的 registry 镜像。

使用 HTTPS 时需要传入 /config/auth.key 文件，或自定义 config.xml 配置，例如：

docker run -it -p 8080:8080 –name registry-web \
–link auth-registry \
-v $(pwd)/config.yml:/conf/config.yml:ro \
hyper/docker-registry-web

管理界面

建立了 registry 服务后，对 registry 的管理界面在本机的访问地址是http://localhost:8080，一般 ui 服务会和 registry 服务同样运行在私有网络，所以我们可以发布 registry ui 到 registry 服务器再运行。

docker tag docker.io/hyper/docker-registry-web docker.onestch.com:5000/admin/docker-registry-web

docker push docker.onestch.com:5000/admin/docker-registry-web

查看 UI 界面如下图