Docker Registry 安装和运行

Myth丶恋晨 2023-01-21 11:19 75阅读 0赞

## 使用场景 ##

*  内部网络，无法访问 [Docker Hub][]
 *  控制 image 的存储方式和存储位置
 *  控制 image 的部署流程
 *  内部开发流程需要集成控制 image 的部署和存储  
    应用逻辑示意图：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70]

## 安装 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 Registry _ Docker]  
官方文档参考：

*  [Docker Hub 上的 registry 镜像介绍文档][registry]
 *  [Docker 官方 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> > auth/auth.htpasswd

启用密码  
通过 –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文档][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 存储配置文档][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][atcol_docker-registry-ui]、[hyper/docker-registry-web][hyper_docker-registry-web]、[konradkleine/docker-registry-frontend][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 界面如下图  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70 1]

[Docker Hub]: http://hub.docker.com/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70]: /images/20221020/7ef5df00ce904aeda4d18e3d75d6cc65.png
[registry]: https://hub.docker.com/_/registry/
[Docker Registry HTTP API V2]: https://github.com/docker/distribution/blob/master/docs/spec/api.md
[Docker Registry _ Docker]: https://blog.csdn.net/qq_29245097/article/details/60138072
[Docker _ Registry]: https://github.com/docker/docker.github.io/blob/master/registry/deploying.md
[docker build]: https://docs.docker.com/engine/reference/commandline/build/
[docker tag]: https://docs.docker.com/engine/reference/commandline/tag/
[docker push]: https://docs.docker.com/engine/reference/commandline/push/
[Volume]: https://docs.docker.com/storage/volumes/#use-a-volume-driver
[Docker Registry]: https://docs.docker.com/registry/configuration/#storage
[atcol_docker-registry-ui]: https://hub.docker.com/r/atcol/docker-registry-ui/
[hyper_docker-registry-web]: https://hub.docker.com/r/hyper/docker-registry-web/
[konradkleine_docker-registry-frontend]: https://hub.docker.com/r/konradkleine/docker-registry-frontend/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70 1]: /images/20221020/03e82338780f4ec79882a29ac9b526b2.png