fedora/registry

Fedora Docker Registry 镜像文档

镜像概述

本镜像基于Fedora系统构建，提供Docker Registry功能，用于搭建私有Docker镜像仓库。通过该镜像，用户可以在本地或内部网络中存储、管理和分发Docker镜像，满足企业或团队内部的镜像管理需求。

核心功能与特性

• 基于Fedora构建：以Fedora为基础镜像，确保系统环境的稳定性和兼容性。
• 数据持久化支持：通过Docker数据卷（Volumes）机制，可将镜像数据存储在独立卷中，避免因镜像更新或容器重建导致数据丢失。
• 标准Registry功能：支持Docker镜像的标记（tag）、推送（push）和拉取（pull）等核心操作，符合Docker Registry规范。

使用场景

• 企业内部搭建私有Docker镜像仓库，管理开发、测试和生产环境的自定义镜像。
• 开发团队共享内部镜像，提高协作效率，减少对公共镜像仓库的依赖。
• 需要本地存储镜像以节省网络带宽或满足数据安全合规要求的场景。

使用方法与配置说明

前提条件

确保已安装Docker环境，可通过以下命令检查Docker版本：

bash
docker version

构建镜像

1. 克隆或获取镜像源码后，进入包含Dockerfile的目录。
2. 执行以下命令构建镜像（将<yourname>替换为实际用户名）：

bash
docker build --rm -t <yourname>/registry .

基本运行方式

直接运行Registry容器，映射端口5000（Registry默认端口）：

bash
docker run -d -p 5000:5000 <yourname>/registry

推荐：使用数据卷持久化数据

为避免容器重建导致数据丢失，推荐使用数据卷存储镜像数据（路径/var/lib/docker-registry）。

步骤1：创建数据卷容器

创建一个仅用于存储数据卷的容器（无需运行，仅用于引用数据卷）：

bash
docker run --name=registry-data -v /var/lib/docker-registry fedora true

• --name=registry-data：指定数据卷容器名称为registry-data。
• -v /var/lib/docker-registry：定义数据卷，挂载路径为/var/lib/docker-registry。
• fedora true：使用fedora镜像，执行true命令后容器退出（仅创建卷）。

步骤2：创建Registry应用容器

通过--volumes-from参数关联数据卷容器，启动Registry服务：

bash
docker run --name=registry -d -p 5000:5000 --volumes-from=registry-data <yourname>/registry

• --name=registry：指定应用容器名称为registry。
• -d：后台运行容器。
• -p 5000:5000：映射主机端口5000到容器端口5000。
• --volumes-from=registry-data：挂载registry-data容器的数据卷到当前容器。

测试Registry功能

1. 标记本地镜像

将已构建的Registry镜像标记为本地Registry的镜像（将<yourname>替换为实际用户名）：

bash
docker tag <yourname>/registry localhost:5000/<yourname>/registry

2. 推送镜像到私有Registry

执行推送命令，验证Registry是否正常工作：

bash
docker push localhost:5000/<yourname>/registry

若推送成功，说明私有Registry搭建完成并可正常使用。