通过Azure DevOps Pipeline部署Kubernetes时无法从Artifactory拉取镜像如何解决？

从错误日志来看，核心问题是Kubernetes Pod拉取Artifactory镜像时返回401 Unauthorized，说明Pod未正确使用配置的镜像拉取Secret。以下是针对性的排查步骤：

1. 验证镜像拉取Secret的正确性 #

• 确保Secret类型为kubernetes.io/dockerconfigjson，这是K8s用于私有镜像仓库认证的标准类型。创建命令示例：

  kubectl create secret docker-registry artifactory-secret \
    --docker-server=dscdr-ltd-discover-docker-dev-l.artifactory.utc.com \
    --docker-username=<你的Artifactory用户名> \
    --docker-password=<你的Artifactory令牌/密码> \
    --docker-email=<你的邮箱>
  

• 检查Secret内容是否有效：

  kubectl get secret artifactory-secret -o jsonpath='{.data.\.dockerconfigjson}' | base64 -d
  

  确认输出的auths字段包含目标Artifactory地址，且凭证是正确的Base64编码值。

2. 确认Deployment已正确引用Secret #

• 检查Deployment的imagePullSecrets配置，必须和创建的Secret名称一致，示例：

  spec:
    template:
      spec:
        imagePullSecrets:
          - name: artifactory-secret
        containers:
          - name: filebrowser
            image: dscdr-ltd-discover-docker-dev-l.artifactory.utc.com/3rd-parties/filebrowser:latest
  

• 如果使用Azure DevOps的Kubernetes部署任务，需确保部署的Manifest文件已添加上述配置，或在任务参数中指定了对应的Secret。

3. 检查Pipeline的K8s权限与上下文 #

• 若Pipeline通过Service Account部署，需确保该ServiceAccount有权限读取目标Secret：

  kubectl create role secret-reader --verb=get,list --resource=secrets
  kubectl create rolebinding sa-secret-access --role=secret-reader --serviceaccount=<命名空间>:<ServiceAccount名称>
  

• 确认Pipeline使用的K8s上下文指向了正确的命名空间——Secret是命名空间级资源，必须与Deployment处于同一命名空间。

4. 验证Artifactory凭证的拉取权限 #

• 手动登录成功不代表该凭证有权限拉取3rd-parties/filebrowser:latest镜像，需在Artifactory控制台检查：
  • 该用户/令牌是否拥有3rd-parties仓库的读取（Pull）权限
  • 镜像地址是否完全匹配（注意域名、仓库名的大小写和拼写）

5. 直接测试Secret的拉取能力 #

• 创建临时Pod验证Secret有效性：

  apiVersion: v1
  kind: Pod
  metadata:
    name: test-image-pull
  spec:
    containers:
      - name: test-container
        image: dscdr-ltd-discover-docker-dev-l.artifactory.utc.com/3rd-parties/filebrowser:latest
    imagePullSecrets:
      - name: artifactory-secret
  

  • 若临时Pod拉取成功，说明Deployment配置或Pipeline部署过程存在问题；若失败，需重新检查Secret或Artifactory权限配置。

内容的提问来源于stack exchange，提问作者Saurabh Asthana