Deployment 起了 3 个副本,两个 ImagePullBaCkOff,一个卡在 ContainerCreating。kubectl describe pod 的 Events 里是 Failed to pull image harbor.xxx.com/app/api:1.4.2,后面跟着 401 Unauthorized。
secret 是建过的,叫 harbor-reg。查 kubectl get secret -n prod,没有。secret 建在 default 命名空间,Deployment 在 prod,跨命名空间不通用。
补建的时候用了 kubectl create secret generic,类型是 Opaque,kubelet 不认。必须用 docker-registry 类型,生成的 .dockerconfigjson 才是 kubelet 读的格式。
kubectl create secret docker-registry harbor-reg --docker-server=harbor.xxx.com --docker-username=robot-ci --docker-password='******' -n prod
kubectl get secret harbor-reg -n prod -o yaml
建完还要在 Pod 模板里引用。Deployment 的 spec.template.spec.imagePullSecrets 加上名字,写到 spec 层不生效,位置错了不会有报错。
改完 rollout,还有一个副本拉不下来。describe 看到 Events 里 401 变成 403,仓库项目是私有的,机器人账号只加到了 library 项目,没加到 app 项目。Harbor 里补上成员权限,403 消失。
另一种做法是把 secret 挂到命名空间的 default ServiceAccount 上,该空间所有 Pod 默认带凭据,不用每个 Deployment 写一遍。代价是权限扩散,看团队规模决定。
确认方式:kubectl get pod -o jsonpath 看 imagePullSecrets 有没有生效,describe 的 Events 里出现 Successfully pulled image 才算过。
secret 轮换要注意。Harbor 密码改了之后旧 secret 还在,Pod 重启才失败,很容易误判成镜像问题。现在是密码轮换和 secret 更新放在同一张发布单里。
