opensciencegrid/ospool-static-registry

OS Pool静态容器注册表

概述

OS Pool静态容器注册表是一款轻量级容器镜像存储解决方案，专为OS Pool环境设计，提供静态容器镜像的持久化存储与标准化访问能力。该镜像采用静态架构，无需动态数据库支持，通过文件系统直接管理镜像数据，简化部署流程并降低资源消耗。

核心功能与特性

• 静态存储架构：基于文件系统实现镜像存储，无需额外数据库，数据结构透明可管理
• 标准兼容：遵循OCI（开放容器倡议）镜像规范，支持与主流容器工具（如Docker、Podman）集成
• 轻量级设计：镜像体积小，启动快速，运行时资源占用低（内存<100MB，CPU占用率<5%）
• 持久化存储：支持通过卷挂载实现镜像数据持久化，确保服务重启后数据不丢失
• 访问控制：内置基础HTTP访问控制机制，可通过配置文件限制访问来源

使用场景与适用范围

• 开发/测试环境：用于存储项目依赖的基础镜像，提供稳定的本地镜像源
• 边缘计算节点：在资源受限的边缘设备中部署，提供本地化镜像分发服务
• 静态镜像仓库：适用于镜像版本固定、无需频繁更新的场景（如生产环境基础镜像）
• 离线环境部署：支持离线环境下的镜像导入与分发，无需连接外部 registry

使用方法

基础部署

通过以下命令快速启动容器注册表：

bash
docker run -d \
  --name os-pool-registry \
  -p 5000:5000 \
  -v /path/to/local/storage:/var/lib/registry \
  os-pool-static-registry:latest

参数说明：

• -p 5000:5000：映射容器5000端口（默认 registry 端口）到主机
• -v /path/to/local/storage:/var/lib/registry：挂载本地目录作为镜像存储路径，实现数据持久化

镜像上传与拉取

上传镜像

1. 标记本地镜像为 registry 地址格式：

   bash
   docker tag local-image:tag localhost:5000/os-pool/image-name:tag
   

2. 推送镜像到 registry：

   bash
   docker push localhost:5000/os-pool/image-name:tag
   

拉取镜像

bash
docker pull localhost:5000/os-pool/image-name:tag

docker-compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  os-pool-registry:
    image: os-pool-static-registry:latest
    container_name: os-pool-registry
    ports:
      - "5000:5000"
    volumes:
      - ./registry-data:/var/lib/registry
      - ./config.yml:/etc/registry/config.yml  # 自定义配置文件
    restart: unless-stopped
    environment:
      - REGISTRY_STORAGE_DELETE_ENABLED=true  # 允许删除镜像（默认禁用）

配置参数

通过环境变量或配置文件（config.yml）进行配置，常用参数如下：

数据备份与恢复

备份

直接打包挂载的存储目录：

bash
tar -czf registry-backup.tar.gz /path/to/local/storage

恢复

将备份文件解压到存储目录：

bash
tar -xzf registry-backup.tar.gz -C /path/to/local/storage

注意事项

• 静态 registry 不支持镜像索引动态更新，新增镜像需手动放置到存储目录或通过 docker push 上传
• 生产环境建议配合反向代理（如 Nginx）使用，增加 HTTPS 加密与高级访问控制
• 存储目录权限需设置为 uid=1000,gid=1000（容器内运行用户），避免权限问题导致服务启动失败