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 界面。它允许用户查看存储在 Docker Registry 中的镜像仓库和标签，查看镜像详细信息，以及管理事件日志等。该项目主要使用 Go 语言开发，同时包含 HTML、JavaScript 和 Dockerfile 等技术。

2. 关键技术和框架

• Go 语言：项目的主体语言，用于后端服务逻辑的实现。
• HTML/CSS/JavaScript：用于实现用户界面的前端技术。
• Docker：容器技术，用于打包和运行应用。
• SQLite/MySQL：用于存储事件日志的数据库。
• Registry：Docker Registry 用于存储和分发 Docker 镜像。

3. 安装和配置

准备工作

在开始之前，请确保您的系统中已经安装了以下软件：

• Docker
• Docker Compose (可选，用于简化多容器部署)

安装步骤

步骤 1：克隆项目

首先，需要从 GitHub 上克隆项目到本地：

git clone https://github.com/Quiq/registry-ui.git
cd registry-ui

步骤 2：配置 Docker Registry

确保您的系统中已经运行了一个 Docker Registry 实例。如果没有，可以按照以下步骤启动一个：

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

步骤 3：运行 Registry UI

使用环境变量配置 Registry UI 以连接到您的 Docker Registry。以下是示例命令：

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

• REGISTRY_HOSTNAME 设置为您的 Docker Registry 的地址。
• REGISTRY_INSECURE 设置为 true 如果您的 Registry 没有启用 TLS。

步骤 4：访问 Web 界面

启动后，使用浏览器访问 http://127.0.0.1:8000，您应该能够看到 Registry UI 的界面。

步骤 5：配置事件监听器（可选）

如果需要使用事件监听器功能，您需要在 Docker Registry 配置文件中添加相应的通知端点，并确保在运行 Registry UI 容器时挂载了正确的配置文件。

notifications:
  endpoints:
    - name: registry-ui
      url: http://registry-ui.local:8000/event-receiver
      headers:
        Authorization: [Bearer 您的令牌]
      timeout: 1s
      threshold: 5
      backoff: 10s

在运行 Registry UI 容器时，添加 -v /path/to/your/config.yml:/opt/config.yml:ro 参数来挂载配置文件。

步骤 6：使用自定义配置（可选）

如果需要使用自定义配置，您可以创建一个 config.yml 文件，并使用 -v 参数将其挂载到容器内：

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

以上就是 Docker Registry UI 的基础安装和配置指南。按照以上步骤操作，您可以轻松地搭建自己的 Docker Registry 管理界面。

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