容器与云原生 / 系统课时

使用镜像仓库

使用镜像仓库

镜像仓库是 Docker 生产交付的重要基础设施,用于保存、分发和管理应用镜像。本课将完成仓库命名、认证访问、镜像推送以及摘要校验,让发布过程具备可追踪性。

学习目标

  • 理解镜像仓库的基本组成
  • 掌握镜像登录与推送流程
  • 学会使用摘要确认镜像一致性

镜像仓库的作用

镜像仓库负责存储已经构建完成的镜像制品,并向部署环境提供稳定下载来源。生产环境通常不会直接在服务器构建镜像,而是通过仓库分发经过验证的版本。

一个镜像地址通常包含仓库地址、命名空间、镜像名称和版本标签,例如 registry.example.com/team/app:v1。其中标签方便管理版本,摘要用于确认内容是否完全一致。

配置认证与推送镜像

访问私有仓库前,需要先完成身份认证。认证信息通常由凭据管理系统提供,不应直接写入代码仓库。

bash
docker login registry.example.com
docker tag app:local registry.example.com/team/app:<ID>
docker push registry.example.com/team/app:<ID>

预期输出

text
Login Succeeded
The push refers to repository [registry.example.com/team/app]
latest: digest: sha256:xxxxxxxx size: 1234

推送成功后,仓库会保存镜像层和元数据。部署环境只需要拉取指定版本即可运行相同制品。

使用摘要验证制品

标签可能被重新指向不同镜像,因此生产部署更推荐记录 digest 摘要。摘要由镜像内容计算生成,相同摘要代表相同镜像内容。

bash
docker pull registry.example.com/team/app:<ID>
docker image inspect registry.example.com/team/app:<ID> --format '{{index .RepoDigests 0}}'

预期输出

text
registry.example.com/team/app@sha256:xxxxxxxx

部署系统可以保存这个摘要作为发布记录,后续排查时能够确认实际运行的镜像版本。

权限管理与常见问题

生产仓库通常按照团队、项目或环境划分命名空间,并限制推送和拉取权限。开发人员可能只有推送权限,生产节点通常只有拉取权限。

常见失败包括认证过期、仓库地址错误和权限不足。排查时先确认登录状态,再检查镜像名称和账号权限。

bash
docker logout registry.example.com
docker login registry.example.com

预期结果

text
Removed login credentials
Login Succeeded

重新认证后即可继续执行拉取或推送操作。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用镜像仓库

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

登录哪都通