首页/开发/CI/CD 与发布速查/imagePullSecrets 与私有仓库拉取
环境与配置管理60 条

imagePullSecrets 与私有仓库拉取

私有镜像拉取凭据:把 docker-registry 类型 Secret 挂到工作负载或 ServiceAccount 上,跨命名空间需显式复制。

CI/CD 与发布速查开发更新于 2026-10-12
创建kubectl create secret docker-registry regcred --docker-server=... --docker-username=... --docker-password=...
挂载Pod spec 的 imagePullSecrets 或 ServiceAccount 默认拉取凭据
跨命名空间Secret 不跨命名空间共享,按命名空间分发或使用平台方案

ServiceAccount 示例

ServiceAccount 示例
apiVersion: v1
kind: ServiceAccount
metadata:
  name: app-sa
imagePullSecrets:
  - name: regcred
优先使用云侧工作负载身份或短期令牌换取拉取凭据:减少长期账号。

易错点

  • 把仓库凭据散落在每个工作负载:集中到 ServiceAccount 或平台方案
  • 凭据过期无告警:拉取失败才被发现,监控拉取错误率

数据来源与参考

  • Kubernetes 文档《Pull an Image from a Private Registry》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌