kibix/registry

Docker Registry S3包装器

概述

该Docker镜像为Docker Registry提供包装功能，核心特性是支持将S3兼容存储作为后端，实现私有镜像仓库在Kubernetes环境中的部署与管理。通过整合S3存储，解决了Kubernetes集群中镜像仓库的数据持久化问题，同时保持与原生Docker Registry的兼容性。

核心功能与特性

• S3后端存储：支持将镜像数据持久化存储到S3或S3兼容对象存储服务，确保数据可靠性与可扩展性
• Kubernetes适配：优化用于Kubernetes环境，支持通过ConfigMap、Secret管理配置，兼容集群内服务发现
• 原生Registry兼容：基于官方Docker Registry构建，保留其所有核心功能（镜像推送/拉取、访问控制、镜像管理等）
• 轻量级设计：仅添加S3适配层，不增加额外性能开销，保持镜像精简
• 配置灵活：支持通过环境变量或配置文件自定义S3连接参数、存储路径、访问权限等

使用场景与适用范围

• 企业私有镜像仓库：在Kubernetes集群内部署安全可控的私有镜像仓库
• 多集群镜像共享：通过S3后端实现跨Kubernetes集群的镜像数据共享
• 持久化存储需求：适用于需要高可用、高持久化存储的镜像仓库场景
• 云原生环境：与AWS、阿里云、腾讯云等云厂商的S3兼容存储服务无缝集成
• 资源受限环境：轻量级设计适合资源有限的边缘计算或小型Kubernetes集群

使用方法与配置说明

环境变量配置

Docker Run部署示例

bash
docker run -d \
  -p 5000:5000 \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLEKEY \
  -e AWS_SECRET_ACCESS_KEY=secretkeyexample \
  -e S3_BUCKET=my-registry-bucket \
  -e S3_REGION=us-west-2 \
  -e REGISTRY_STORAGE_S3_ROOTDIRECTORY=/registry \
  --name s3-registry \
  [镜像名称]:[版本]

Kubernetes部署示例

1. 创建Secret存储S3凭证

yaml
apiVersion: v1
kind: Secret
metadata:
  name: s3-registry-secrets
type: Opaque
data:
  access-key: <base64-encoded-access-key>
  secret-key: <base64-encoded-secret-key>

2. 部署Registry Deployment

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: s3-registry
spec:
  replicas: 1
  selector:
    matchLabels:
      app: s3-registry
  template:
    metadata:
      labels:
        app: s3-registry
    spec:
      containers:
      - name: registry
        image: [镜像名称]:[版本]
        ports:
        - containerPort: 5000
        env:
        - name: AWS_ACCESS_KEY_ID
          valueFrom:
            secretKeyRef:
              name: s3-registry-secrets
              key: access-key
        - name: AWS_SECRET_ACCESS_KEY
          valueFrom:
            secretKeyRef:
              name: s3-registry-secrets
              key: secret-key
        - name: S3_BUCKET
          value: "my-registry-bucket"
        - name: S3_REGION
          value: "us-west-2"
        - name: REGISTRY_STORAGE_S3_ROOTDIRECTORY
          value: "/registry"

3. 创建Service暴露服务

yaml
apiVersion: v1
kind: Service
metadata:
  name: s3-registry
spec:
  selector:
    app: s3-registry
  ports:
  - port: 5000
    targetPort: 5000
  type: ClusterIP

注意事项

• 确保S3存储桶已创建且访问权限配置正确，容器需具备读写权限
• 在Kubernetes环境中建议使用持久化配置（如ConfigMap）管理非敏感配置
• 生产环境中应启用TLS加密（通过REGISTRY_HTTP_TLS_CERTIFICATE和REGISTRY_HTTP_TLS_KEY配置）
• 高可用场景下可部署多个副本并配合负载均衡服务使用