容器与云原生 / 系统课时

搭建本地私有仓库

搭建本地私有仓库

本课解决“在不依赖公共平台的情况下,如何快速验证私有镜像分发流程”的问题。完成后,你会启动本地 Registry,推送镜像,并通过删除后重新拉取证明仓库可用。

学习目标

  • 使用 Registry 容器启动本地仓库服务
  • 完成本地镜像的重新标记、推送和拉取
  • 理解数据卷、TLS 与远程访问的基本边界

启动带持久化的 Registry

官方 registry:2 镜像默认监听容器内的 5000 端口,镜像数据保存在 /var/lib/registry。使用命名卷后,即使删除并重建容器,仓库数据仍可保留。

bash
docker volume create registry-data

docker run -d --name local-registry --restart unless-stopped -p 5000:5000 -v registry-data:/var/lib/registry registry:2

预期输出

text
第一条命令输出 registry-data。
第二条命令输出一个容器 ID:<CONTAINER_ID>。

可用 docker ps 确认容器状态为 Up,端口映射包含 0.0.0.0:5000->5000/tcp 或对应的本机监听地址。

推送并重新拉取

本机地址使用 localhost:5000 作为 Registry 前缀。下面把 Alpine 镜像放入 demo/alpine Repository,再删除本地发布标签并重新拉取。

bash
set -e

docker pull alpine:3.20
docker tag alpine:3.20 localhost:5000/demo/alpine:3.20
docker push localhost:5000/demo/alpine:3.20

docker image rm localhost:5000/demo/alpine:3.20
docker pull localhost:5000/demo/alpine:3.20

curl -s http://localhost:5000/v2/_catalog

预期结果

text
推送结束时出现 digest: sha256:<DIGEST>。
重新拉取成功。
目录接口返回 {"repositories":["demo/alpine"]}。

目录顺序和 Digest 可能不同。目录接口只能证明 Repository 已登记,是否包含指定 Tag 还可以查询 /v2/demo/alpine/tags/list。

远程访问不能照搬本机配置

本机实验通常可以直接访问 localhost:5000。当其他服务器通过主机名或 IP 连接时,生产环境应配置 HTTPS、可信证书、身份认证和访问控制。

把远程仓库简单加入 insecure-registries 会允许明文或不受信任 TLS,适合隔离实验环境,不应作为生产方案。配置变更后还需要重启 Docker daemon,并确认客户端连接的是预期 Registry。

验收要点

先重启 Registry 容器,确认数据卷中的镜像仍能拉取;再从另一台受控客户端测试网络、证书和权限。只有“服务可达、认证生效、数据持久、推拉成功”同时满足,私有仓库才具备基本可用性。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

搭建本地私有仓库

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通