Docker Registry UI 使用教程

Docker Registry UI 使用教程

registry-ui Web UI for Docker Registry 项目地址: https://gitcode.com/gh_mirrors/re/registry-ui

1. 项目介绍

Docker Registry UI 是一个用于浏览和管理的 Docker Registry 的 Web 界面。它支持浏览仓库和标签，显示关于图像和图像索引的详细信息，以及监听来自 Registry 的通知事件。此项目旨在提供一个快速、简单且体积小的包，用于与 Docker Registry 或类似替代方案一起使用。

2. 项目快速启动

以下是快速启动 Docker Registry UI 的步骤：

首先，确保你的主机上运行了一个 Docker Registry。如果没有，可以使用以下命令启动一个：

docker run -d --network host --name registry registry:2

接着，运行 Docker Registry UI 并连接到上面启动的 Registry：

docker run -d --network host \
-e REGISTRY_HOSTNAME=127.0.0.1:5000 \
-e REGISTRY_INSECURE=true \
--name registry-ui quiq/registry-ui

现在，你可以将任何 Docker 图像推送到 127.0.0.1:5000/owner/name，然后使用浏览器打开 http://127.0.0.1:8000 来查看和管理你的 Registry。

3. 应用案例和最佳实践

案例一：使用自定义配置文件

你可以通过挂载自定义的 config.yml 文件到容器中来覆盖默认配置：

docker run -d -p 8000:8000 -v /local/config.yml:/opt/config.yml:ro quiq/registry-ui

案例二：使用自定义根 CA 证书

如果你需要使用自己的根 CA 证书，可以添加以下参数到命令中：

-v /local/rootcacerts.crt:/etc/ssl/certs/ca-certificates.crt:ro

案例三：持久化事件数据

为了保留事件数据，可以将一个目录挂载到容器内部，确保该目录由运行容器用户（alpine 中的用户 ID 是 65534）拥有：

-v /local/data:/opt/data

4. 典型生态项目

目前，Docker Registry UI 项目主要是作为一个独立的前端界面与 Docker Registry 进行交互。在生态系统中，你可能还需要以下项目：

• Docker Registry：用于存储和分发 Docker 图像的开放源代码 Registry。
• nginx 或 oauth2_proxy：用于在 UI 前面提供 TLS 加密和/或身份验证。
• cron：用于定期执行任务，例如清理旧标签。

这些项目可以与 Docker Registry UI 一起工作，以创建一个完整的容器镜像存储和分发解决方案。

registry-ui Web UI for Docker Registry 项目地址: https://gitcode.com/gh_mirrors/re/registry-ui