Gitlab CI/CD Steps如何访问K8S Agent？上下文获取异常

我已正确安装并运行K8S Agent，但改用CI/CD的steps功能后无法获取K8S上下文。

可正常返回上下文的旧配置 #

job:
  image:
     name: bitnami/kubectl:latest
     entrypoint: [""]
  script:
      kubectl config get-contexts

无法返回上下文的新steps配置 #

job:
  image:
     name: bitnami/kubectl:latest
     entrypoint: [""]
  run:
    - name: contexts
      script: kubectl config get-contexts

问题排查与解决方法 #

• 检查kubeconfig文件可用性
  部分CI/CD系统在单script模式下会自动将K8S Agent的kubeconfig挂载到容器默认路径（如~/.kube/config），但改用多步骤run结构时，可能出现配置文件未正确传递的情况。可先在步骤中添加检查命令：

  run:
    - name: 验证kubeconfig存在性
      script: |
        ls -la ~/.kube/
        cat ~/.kube/config
  

• 显式指定kubeconfig路径
  如果默认路径未加载配置，可在kubectl命令中显式指定kubeconfig路径：

  job:
    image:
      name: bitnami/kubectl:latest
      entrypoint: [""]
    run:
      - name: 获取K8S上下文
        script: kubectl config get-contexts --kubeconfig /path/to/your/kubeconfig
  

  需将/path/to/your/kubeconfig替换为CI/CD系统实际挂载的kubeconfig路径，可通过上述检查命令确认。

• 确认步骤间环境共享
  部分CI/CD工具中，不同的run步骤可能运行在独立容器实例中，导致kubeconfig未被继承。此时需要：

  • 确保kubeconfig文件挂载到所有步骤共享的持久化存储卷中
  • 或者通过环境变量KUBECONFIG指定配置路径，确保每个步骤都能读取到

• 验证环境变量设置
  在步骤中检查KUBECONFIG环境变量是否正确设置：

  run:
    - name: 检查KUBECONFIG环境变量
      script: echo $KUBECONFIG
  

  如果该变量存在且指向有效路径，直接使用kubectl命令即可自动读取配置。

内容的提问来源于stack exchange，提问作者Techie TillIDie