容器与云原生 / 系统课时

容器镜像仓库

容器镜像仓库

本课解决镜像如何被可靠存储、版本化并安全拉取的问题。完成后,你将能把本地镜像推送到私有仓库,为 Kubernetes 配置拉取凭证,并用可追溯版本替代容易漂移的 latest 标签。

学习目标

  • 理解镜像仓库、标签与摘要之间的关系
  • 完成私有镜像的登录、推送和拉取验证
  • 为工作负载配置 imagePullSecrets 与版本管理策略

镜像仓库解决什么问题

镜像仓库保存的是按仓库名、标签和摘要组织的镜像制品。完整引用通常写成 registry.example.com/platform/demo-web:1.4.2:最前面是仓库地址,中间是项目或命名空间,最后是镜像名与标签。

标签便于人阅读,但通常可以被重新指向;摘要形如 sha256:<DIGEST>,由镜像内容计算而来,同一摘要对应同一份内容。开发环境可使用语义化标签,生产环境应记录摘要,以便审计和回滚。

私有镜像从构建到集群拉取的数据流

推送一个带版本的镜像

下面示例假设当前目录包含可构建的 Dockerfile,私有仓库已创建 platform 项目,并通过环境变量提供账号密码。<USER>、<PASSWORD> 和摘要是占位值,执行时应替换或由密钥系统注入。

bash
# 统一声明镜像坐标,确保构建与推送使用同一引用
export REGISTRY="registry.example.com"
export PROJECT="platform"
export IMAGE_NAME="demo-web"
export VERSION="1.4.2"
export REGISTRY_USER="<USER>"
export REGISTRY_PASSWORD="<PASSWORD>"

IMAGE_REF="${REGISTRY}/${PROJECT}/${IMAGE_NAME}:${VERSION}"

# 密码通过标准输入传递,避免出现在命令历史中
printf '%s' "${REGISTRY_PASSWORD}" | docker login "${REGISTRY}" \
  --username "${REGISTRY_USER}" \
  --password-stdin

# 推送后读取摘要,用于发布记录和回滚定位
docker build --tag "${IMAGE_REF}" .
docker push "${IMAGE_REF}"
docker image inspect "${IMAGE_REF}" --format '{{index .RepoDigests 0}}'

预期输出

text
Login Succeeded
registry.example.com/platform/demo-web@sha256:<DIGEST>

构建层数、上传进度和摘要会随镜像内容变化。最终能看到仓库地址与 sha256 摘要,说明客户端已完成推送并取得可追溯引用。

配置拉取凭证与版本策略

imagePullSecret 是命名空间级资源,工作负载和 Secret 必须位于同一命名空间。下面假设 demo-prod 尚未创建;真实密码不得写进 YAML 或 Git 仓库,生产环境应由 CI 密钥、外部 Secret 系统或受控命令注入。

bash
# Secret 与工作负载必须位于同一命名空间
kubectl create namespace demo-prod

# 真实凭证应由 CI 或外部密钥系统注入
kubectl -n demo-prod create secret docker-registry registry-cred \
  --docker-server="registry.example.com" \
  --docker-username="<USER>" \
  --docker-password="<PASSWORD>"

kubectl -n demo-prod get secret registry-cred

预期输出

text
namespace/demo-prod created
secret/registry-cred created
NAME            TYPE                             DATA   AGE
registry-cred   kubernetes.io/dockerconfigjson   1      <TIME>

工作负载通过 imagePullSecrets 引用该 Secret。以下清单使用固定版本标签,并显式设置 IfNotPresent,避免每次启动都重复拉取同一版本。

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: demo-web
  namespace: demo-prod
spec:
  replicas: 2
  selector:
    matchLabels:
      app: demo-web
  template:
    metadata:
      labels:
        app: demo-web
    spec:
      # 拉取凭证必须存在于 demo-prod 命名空间
      imagePullSecrets:
        - name: registry-cred
      containers:
        - name: web
          # 使用固定版本,避免 latest 被覆盖后产生漂移
          image: registry.example.com/platform/demo-web:1.4.2
          imagePullPolicy: IfNotPresent
          ports:
            - containerPort: 8080

保存为 deployment.yaml 后首次应用,并检查 Pod 状态:

bash
# 应用配置后等待 Deployment 完成滚动发布
kubectl apply -f deployment.yaml
kubectl -n demo-prod rollout status deployment/demo-web
kubectl -n demo-prod get pods -l app=demo-web

预期输出

text
deployment.apps/demo-web created
deployment "demo-web" successfully rolled out
NAME                        READY   STATUS    RESTARTS   AGE
demo-web-<POD_ID_1>         1/1     Running   0          <TIME>
demo-web-<POD_ID_2>         1/1     Running   0          <TIME>

Pod 名称和时间会不同。若出现 ImagePullBackOff,应依次检查镜像引用是否存在、Secret 是否在正确命名空间、账号是否有拉取权限,以及节点是否能访问仓库地址。

版本管理同样属于拉取可靠性的一部分。生产镜像不要复用同一个版本标签,也不要依赖 latest。推荐同时写入语义化版本、提交号和镜像摘要,例如 1.4.2、git-a1b2c3d 与 sha256:<DIGEST>,让发布记录能对应到源码和制品。

仓库侧应配置最小权限、传输加密、漏洞扫描和保留策略。构建账号只负责推送指定项目,集群账号只负责拉取;旧版本至少保留到回滚窗口结束,再由清理策略删除无引用制品。

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

目录与阅读设置

阅读设置

17

记录一个想法

容器镜像仓库

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

登录哪都通