Docker Registry 教程

Docker Registry 教程

docker-registry项目地址:https://gitcode.com/gh_mirrors/dock/docker-registry

1. 项目目录结构及介绍

Docker Registry 的源代码位于 https://github.com/docker/docker-registry.git。这个项目主要由以下关键部分组成：

• docker-compose.yml: 使用 Docker Compose 启动服务的配置文件。
• config_sample.py: 示例配置文件，用于定制 Registry 行为。
• registry: 主程序代码，包含了处理 Docker 镜像存储和检索的核心功能。
• tests: 单元测试和集成测试的代码。
• docs: 项目的文档，包括安装和使用的指导。

目录结构概览:

.
├── config_sample.py   # 示例配置文件
├── docker-compose.yml # Docker Compose 配置文件
├── registry          # Registry 应用主代码
└── tests              # 测试代码
    ├── functional     # 功能性测试
    └── unit           # 单元测试

2. 项目启动文件介绍

项目使用 docker-compose.yml 文件作为启动配置。这是一个 YAML 格式的文件，描述了如何使用 Docker Compose 启动 Registry 服务以及可能的依赖服务（如数据库或缓存）。

典型的 docker-compose.yml 文件会定义服务，如 Registry 和其关联的数据存储。例如：

version: '3'
services:
  registry:
    image: registry:latest
    volumes:
      - ./data:/var/lib/registry
    ports:
      - "5000:5000"

这段配置表示使用 registry:latest 镜像启动服务，把本地的 ./data 目录挂载到容器内的 /var/lib/registry （存储镜像），并将容器的 5000 端口暴露到宿主机的相同端口。

3. 项目配置文件介绍

配置文件通常以 .py 结尾，比如 config_sample.py，它提供了修改 Registry 行为的选项。常见的配置项包括认证机制、存储驱动和日志级别等。

# 配置示例
class Config(object):
    DEBUG = False
    REGISTRY_STORAGE = 'registry.storage.fileystem.Storage'
    REGISTRY_STORAGE_FILESYSTEM_ROOT_LOCATION = '/var/lib/registry'
    REGISTRY_AUTH = 'basic'
    REGISTRY_AUTH_BASIC_REALM = 'Registry Realm'
    REGISTRY_AUTH BASIC_USERNAME = 'admin'
    REGISTRY_AUTH_BASIC_PASSWORD = 'password'

这个例子中，DEBUG 控制调试模式，REGISTRY_STORAGE 定义了存储驱动（这里是文件系统），REGISTRY_STORAGE_FILESYSTEM_ROOT_LOCATION 是镜像存储的路径，而 REGISTRY_AUTH 部分配置了基本的 HTTP 认证。

要启用这个配置，你需要将 config_sample.py 中的内容复制到一个新的配置文件，然后在 Docker Compose 或者启动命令中指定该配置文件的位置。

---

请确保根据你的具体需求调整这些配置，以便成功部署和管理你的 Docker Registry。更多详细的配置选项和用法，可以在项目文档或源码注释中找到。

docker-registry项目地址:https://gitcode.com/gh_mirrors/dock/docker-registry