如何配置GitLab与Kubernetes集成以查看Pod状态及容器日志

1. 确认KAS与Kubernetes集群的连接有效性 #

• 登录GitLab管理员后台，进入Admin Area > Kubernetes，检查目标集群的KAS代理状态是否为Connected。若状态异常，先排查网络与Pod状态：
  • 用kubectl get pods -n gitlab-agent查看集群侧KAS代理Pod是否正常运行
  • 确保KAS服务能访问Kubernetes API Server，无防火墙或网络策略阻断
• 验证KAS代理的ServiceAccount权限，需至少具备以下资源访问权限，可通过检查绑定的ClusterRole确认：

  apiGroups: [""]
  resources: ["pods", "pods/log"]
  verbs: ["get", "list", "watch"]
  apiGroups: ["apps"]
  resources: ["deployments", "replicasets"]
  verbs: ["get", "list", "watch"]
  

2. 确保CI/CD部署与GitLab环境绑定 #

• CI/CD配置中必须指定environment字段，且名称与项目内环境一致。示例.gitlab-ci.yml片段：

  deploy:
    stage: deploy
    script:
      - kubectl apply -f deployment.yaml
    environment:
      name: production
      url: http://your-nginx-service-endpoint
  

• 检查Kubernetes Deployment资源是否带有GitLab识别标签（CI/CD部署会自动添加，手动部署需手动配置）：

  metadata:
    labels:
      gitlab.com/env: production
      gitlab.com/project-id: "<你的项目ID>"
      gitlab.com/app: "<你的应用名称>"
  

3. 配置项目级Kubernetes集成选项 #

• 进入项目Settings > Integrations > Kubernetes，确保Deploy Boards功能已启用（该功能负责在环境页展示Pod状态）
• 检查环境权限：在Settings > CI/CD > Environments中，将目标环境的可见性设置为对应开发者组可访问（比如Everyone with access）

4. 调试与同步验证 #

• 查看GitLab实例侧KAS容器日志，排查是否存在资源同步错误（如权限不足、资源匹配失败）
• 在浏览器开发者工具中，检查环境页的Network请求：确认向KAS发起的Pod列表请求是否成功，返回数据是否正常
• 进入项目Operations > Environments页面，点击目标环境右侧的Refresh按钮，强制触发资源同步

内容的提问来源于stack exchange，提问作者Roma Lukinskiy