theubercloud/registry

theubercloud/registry 镜像文档

镜像概述

theubercloud/registry是v2官方Docker Registry的自定义构建版本，基于https://github.com/docker/distribution%E9%A1%B9%E7%9B%AE%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E7%94%A8%E4%BA%8E%E6%90%AD%E5%BB%BA%E7%A7%81%E6%9C%89Docker%E9%95%9C%E5%83%8F%E4%BB%93%E5%BA%93%EF%BC%8C%E6%94%AF%E6%8C%81Docker%E9%95%9C%E5%83%8F%E7%9A%84%E5%AD%98%E5%82%A8%E3%80%81%E7%AE%A1%E7%90%86%E5%92%8C%E5%88%86%E5%8F%91%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E4%BC%81%E4%B8%9A%E5%86%85%E9%83%A8%E6%88%96%E5%9B%A2%E9%98%9F%E5%86%85%E9%83%A8%E7%9A%84%E9%95%9C%E5%83%8F%E7%AE%A1%E7%90%86%E9%9C%80%E6%B1%82%E3%80%82

核心功能与特性

• 基于官方v2 Docker Registry构建，兼容标准Docker Registry API
• 支持通过配置文件自定义仓库行为（如存储后端、访问控制、镜像清理策略等）
• 轻量级设计，易于部署和维护
• 支持持久化存储，可通过挂载卷保存镜像数据

使用场景

• 企业内部私有镜像仓库搭建，确保镜像安全和可控
• 开发团队内部共享和管理自定义Docker镜像
• CI/CD流程中作为镜像存储和分发节点

使用方法

基本部署命令

通过以下命令快速部署私有Docker Registry：

bash
docker run -it -d -p 5000:5000 -v /path/to/config.yaml:/config.yaml:ro theubercloud/registry:latest

参数说明：

• -it: 分配交互式终端并保持容器运行
• -d: 后台运行容器
• -p 5000:5000: 将容器的5000端口映射到主机的5000端口（Docker Registry默认端口）
• -v /path/to/config.yaml:/config.yaml:ro: 挂载主机上的配置文件到容器内，ro表示只读模式，确保配置不被容器修改
• theubercloud/registry:latest: 使用最新版本的镜像

配置文件说明

配置文件（config.yaml）用于自定义Registry的行为，具体配置项可参考官方文档，常见配置包括：

• 存储后端（如本地文件系统、S3、GCS等）
• 访问控制（如基本认证、TLS配置）
• 镜像生命周期管理（如自动清理策略）

访问私有仓库

部署后，可通过http://localhost:5000访问私有仓库。例如，标记并推送镜像：

bash
# 标记本地镜像
docker tag my-image:latest localhost:5000/my-image:latest

# 推送到私有仓库
docker push localhost:5000/my-image:latest

# 从私有仓库拉取镜像
docker pull localhost:5000/my-image:latest

注意事项

• 生产环境中建议配置TLS加密，确保数据传输安全
• 对于大规模部署，建议使用外部存储后端（如S3）以提高可靠性和扩展性
• 定期备份配置文件和镜像数据，防止数据丢失