gleez/registry

Docker Registry for S3 Storage (DigitalOcean Spaces/Ceph)

镜像概述

本镜像基于官方Docker Registry构建，针对S3 Ceph兼容存储服务（如DigitalOcean Spaces）的兼容性问题，应用了特定补丁以解决https://github.com/docker/distribution/issues/2553%E4%B8%AD%E6%8F%8F%E8%BF%B0%E7%9A%84%E5%AD%98%E5%82%A8%E9%80%82%E9%85%8D%E9%97%AE%E9%A2%98%E3%80%82%E6%97%A8%E5%9C%A8%E4%B8%BA%E9%9C%80%E8%A6%81%E5%B0%86Docker%E9%95%9C%E5%83%8F%E5%AD%98%E5%82%A8%E4%BA%8ES3 Ceph兼容服务的场景提供稳定支持。

核心功能和特性

• S3 Ceph兼容性：通过应用补丁(https://github.com/leoh0/distribution/commit/abcacf2)%E8%A7%A3%E5%86%B3%E5%8E%9F%E7%89%88Docker Registry与S3 Ceph存储（如DigitalOcean Spaces）的兼容性问题
• 基于官方Registry：保留官方Docker Registry的核心功能，仅针对存储层进行适配优化
• 无缝集成：支持标准S3存储配置参数，可直接对接DigitalOcean Spaces等S3兼容服务

使用场景

• 需要将Docker Registry数据持久化存储至DigitalOcean Spaces的环境
• 使用Ceph S3兼容存储服务部署私有Docker Registry的场景
• 解决原版Docker Registry在S3 Ceph存储环境下的功能异常问题

使用方法和配置说明

基本部署（docker run）

bash
docker run -d \
  --name registry-s3-ceph \
  -p 5000:5000 \
  -e REGISTRY_STORAGE=s3 \
  -e REGISTRY_STORAGE_S3_ACCESSKEY=<your-access-key> \
  -e REGISTRY_STORAGE_S3_SECRETKEY=<your-secret-key> \
  -e REGISTRY_STORAGE_S3_REGION=<region> \
  -e REGISTRY_STORAGE_S3_BUCKET=<bucket-name> \
  -e REGISTRY_STORAGE_S3_ENDPOINT=<s3-endpoint> \
  leoh0/distribution:latest

docker-compose配置示例

yaml
version: '3'
services:
  registry:
    image: leoh0/distribution:latest
    container_name: registry-s3-ceph
    ports:
      - "5000:5000"
    environment:
      - REGISTRY_STORAGE=s3
      - REGISTRY_STORAGE_S3_ACCESSKEY=AKIAEXAMPLE
      - REGISTRY_STORAGE_S3_SECRETKEY=secret123
      - REGISTRY_STORAGE_S3_REGION=nyc3
      - REGISTRY_STORAGE_S3_BUCKET=my-registry-bucket
      - REGISTRY_STORAGE_S3_ENDPOINT=https://nyc3.digitaloceanspaces.com
      - REGISTRY_STORAGE_S3_USESSL=true
    restart: always

关键环境变量说明

注：具体配置需根据实际S3 Ceph服务提供商的要求调整，例如DigitalOcean Spaces需指定对应的区域和端点。