首页/云/Kubernetes 速查/imagePullSecrets 拉取私有镜像
配置与存储54 条

imagePullSecrets 拉取私有镜像

私有仓库凭据存在 docker-registry 类型 Secret 中,通过 Pod 的 imagePullSecrets 或 ServiceAccount 交给 kubelet。

Kubernetes 速查云更新于 2026-10-12

创建与引用

创建与引用
kubectl create secret docker-registry regcred -n prod \
  --docker-server=registry.example.com \
  --docker-username=robot-ci \
  --docker-password='<token>' \
  --docker-email=ci@example.com

kubectl patch deploy web -n prod --type merge \
  -p '{"spec":{"template":{"spec":{"imagePullSecrets":[{"name":"regcred"}]}}}}'
多命名空间各自维护一份;也可以把 Secret 绑到工作负载的 ServiceAccount 上,让新 Pod 自动继承。

易错点

  • ImagePullBackOff 先核对 Secret 里的 server 与镜像地址前缀是否完全一致
  • Token 轮换后忘记更新 Secret:老节点有本地镜像缓存仍能跑,新节点立刻拉不动

数据来源与参考

  • Kubernetes 官方文档 · 从私有仓库拉取镜像
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌