b2wasgard/registry

Docker Registry 镜像文档

镜像概述

本镜像用于部署和运行Docker Registry服务，通过环境变量在运行时动态生成配置文件，支持多种存储后端、缓存机制及访问控制，适用于构建私有Docker镜像仓库。

核心功能与特性

• 动态配置生成：基于环境变量自动生成Registry配置文件，无需手动编写配置
• 多存储后端支持：
  • 文件系统存储（默认）
  • S3兼容对象存储
• 缓存支持：通过Redis实现blob描述符缓存
• 访问控制：基于htpasswd的用户认证机制
• 删除功能：支持镜像删除操作
• 日志配置：JSON格式日志输出，错误级别记录

使用场景

• 企业内部私有Docker镜像仓库部署
• 需要灵活切换存储后端（本地文件系统或云存储）的场景
• 需对镜像仓库访问进行用户认证控制的环境
• 需要缓存优化以提升镜像拉取性能的场景

使用方法与配置说明

环境变量配置

卷挂载要求

• 认证文件卷：必须将包含用户/密码的htpasswd文件挂载到容器内，路径需与REGISTRY_AUTH_FILE环境变量一致
• 数据卷（可选）：若使用文件系统存储，建议挂载数据卷到存储根目录以持久化数据

部署示例

Docker Run 命令（文件系统存储）

bash
# 1. 创建htpasswd文件（需提前安装apache2-utils）
htpasswd -c /path/to/local/auth/htpasswd admin

# 2. 启动容器
docker run -d \
  -p 5000:80 \
  -v /path/to/local/auth:/auth \
  -v /path/to/local/registry/data:/var/lib/registry \
  -e REGISTRY_AUTH_FILE=/auth/htpasswd \
  -e REGISTRY_STORAGE_FILESYSTEM_ENABLE=true \
  --name my-docker-registry \
  [镜像名称]

Docker Compose 配置（S3存储+Redis缓存）

yaml
version: '3'
services:
  registry:
    image: [镜像名称]
    ports:
      - "5000:80"
    volumes:
      - /path/to/local/auth:/auth
    environment:
      - REGISTRY_AUTH_FILE=/auth/htpasswd
      - REGISTRY_STORAGE_S3_ENABLE=true
      - REGISTRY_STORAGE_S3_ACCESS_KEY_ID=AKIAEXAMPLE
      - REGISTRY_STORAGE_S3_ACCESS_KEY_SECRET=secretkeyexample
      - REGISTRY_STORAGE_S3_REGION=us-east-1
      - REGISTRY_STORAGE_S3_BUCKET=my-registry-bucket
      - REGISTRY_STORAGE_CACHE_ENABLE=true
      - REGISTRY_REDIS_ADDRESS=redis:6379
    depends_on:
      - redis

  redis:
    image: redis:alpine
    ports:
      - "6379:6379"

配置模板说明

镜像使用以下模板动态生成registry/config.yml：

yaml
version: 0.1
auth:
  htpasswd:
    realm: auth-realm
    path: {{.REGISTRY_AUTH_FILE}}
log:
    level: error
    formatter: json
    fields:
        service: registry
storage:
{{ if .REGISTRY_STORAGE_CACHE_ENABLE }}
    cache:
        blobdescriptor: redis
{{ end }}

{{if .REGISTRY_STORAGE_FILESYSTEM_ENABLE }}
    filesystem:
    {{if .REGISTRY_STORAGE_FILESYSTEM_ROOT_DIR }}
        rootdirectory: {{.REGISTRY_STORAGE_FILESYSTEM_ROOT_DIR}}
    {{else}}
        rootdirectory: /var/lib/registry
  {{end}}
{{end}}

{{ if .REGISTRY_STORAGE_S3_ENABLE }}
    s3:
        accesskey: {{.REGISTRY_STORAGE_S3_ACCESS_KEY_ID}}
        secretkey: {{.REGISTRY_STORAGE_S3_ACCESS_KEY_SECRET}}
        region: {{.REGISTRY_STORAGE_S3_REGION}}
        bucket: {{.REGISTRY_STORAGE_S3_BUCKET}}
        encrypt: false
        secure: true
        v4auth: false
        chunksize: 5242880
        rootdirectory: images
{{ end }}

    delete:
        enabled: true

{{ if .REGISTRY_STORAGE_CACHE_ENABLE }}
redis:
    addr: {{.REGISTRY_REDIS_ADDRESS}}
{{ end }}
http:
    addr: :80