distribution/distribution Docker 镜像 - 轩辕镜像

Distribution 容器镜像文档

镜像概述和主要用途

Distribution 镜像提供了符合 OCI 分发规范 的开源容器制品仓库实现，用于存储和分发容器镜像等 OCI 应用内容。该镜像基于 Distribution 项目构建，支持容器镜像的推送、拉取和管理，适用于构建私有容器镜像仓库或本地开发测试环境。

核心功能和特性

• 符合 OCI 标准：完全遵循 OCI Distribution Specification，确保与主流容器运行时（如 Docker、containerd）兼容。
• 灵活存储驱动：默认使用 filesystem 存储驱动，支持将容器镜像存储在本地文件系统，同时支持扩展其他存储后端（需通过配置文件定义）。
• 可定制配置：支持通过自定义配置文件调整仓库行为，包括存储路径、访问控制、日志等。
• 持久化存储：支持通过挂载宿主机目录实现镜像数据的持久化，避免容器重启后数据丢失。
• 轻量部署：提供简单的 Docker 部署命令，支持 --restart always 确保服务持续运行。

使用场景和适用范围

• 本地开发测试：在开发环境快速搭建私有仓库，用于测试镜像推送、拉取流程。
• 私有仓库部署：企业内部搭建私有容器镜像仓库，管理内部开发的容器镜像。
• CI/CD 流水线集成：作为 CI/CD 流程的中间仓库，存储构建过程中生成的镜像，供后续部署步骤使用。
• 边缘环境部署：在资源受限的边缘环境中，部署轻量级镜像仓库，减少对外部仓库的依赖。

详细使用方法和配置说明

快速启动

默认配置运行

使用默认配置启动仓库，监听本地 5000 端口：

bash
docker run -d -p 5000:5000 --restart always --name registry distribution/distribution:edge

注意：若需向本地仓库推送/拉取镜像，需配置 Docker 引擎允许「不安全注册表」（insecure registry）：

1. 编辑 /etc/docker/daemon.json 文件：

   json
   {
     "insecure-registries": ["host.docker.internal:5000"]
   }
   

2. 重启 Docker 引擎使配置生效。

测试仓库功能

完成配置后，可通过以下步骤测试仓库：

bash
# 拉取官方 alpine 镜像
docker pull alpine

# 为镜像打标签，指向本地仓库
docker tag alpine localhost:5000/alpine

# 推送镜像到本地仓库
docker push localhost:5000/alpine

持久化存储配置

默认配置使用 filesystem 存储驱动，但未挂载宿主机目录，容器重启后数据会丢失。如需持久化存储，需将宿主机目录挂载到仓库的存储根目录（/var/lib/registry）：

bash
# 将宿主机当前目录下的 FS/PATH 目录挂载到容器内的 /var/lib/registry
docker run -d -p 5000:5000 -v $PWD/FS/PATH:/var/lib/registry --restart always --name registry distribution/distribution:edge

其中，$PWD/FS/PATH 为宿主机上用于存储镜像数据的本地目录，需提前创建。

自定义配置

如需使用非默认配置，可通过挂载自定义配置文件覆盖默认配置（默认配置文件路径：/etc/distribution/config.yml）：

1. 准备自定义配置文件（示例配置可参考 官方默认配置）。
2. 挂载配置文件启动仓库：

bash
# 将宿主机 PATH/TO/config.yml 挂载到容器内的 /etc/distribution/config.yml
docker run -d -p 5000:5000 -v $PWD/PATH/TO/config.yml:/etc/distribution/config.yml --restart always --name registry distribution/distribution:edge

配置文件主要参数说明：

• storage：定义存储驱动，默认使用 filesystem，可配置 rootdirectory 指定存储路径（如 /var/lib/registry）。
• http：配置 HTTP 服务监听地址和端口（默认 0.0.0.0:5000）。
• log：配置日志输出格式和级别。

通信与支持

• 异步交流：通过 GitHub 仓库 的 Issues 和 Pull Requests 进行长期讨论。
• 实时交流：加入 CNCF Slack 的 #distribution 频道参与实时开发交流。