kubectl-gitlab-ci

镜像概述

kubectl-gitlab-ci是一个专为GitLab CI/CD环境设计的Kubernetes客户端工具镜像，集成了kubectl命令行工具，旨在简化GitLab CI流程中与Kubernetes集群的交互操作。该镜像可直接用于GitLab CI流水线，无需在CI runner中单独安装配置kubectl，支持快速执行集群部署、资源检查、配置更新等Kubernetes相关操作。

核心功能与特性

• 内置kubectl工具：集成最新稳定版kubectl，支持完整的Kubernetes集群管理命令集
• CI环境适配：针对GitLab CI环境优化，支持通过环境变量注入kubeconfig配置
• 轻量级设计：基于精简基础镜像构建，减少CI流水线执行时间
• 多版本支持：提供不同kubectl版本的镜像标签，适配不同Kubernetes集群版本

使用场景

• GitLab CI/CD流水线中自动化部署应用至Kubernetes集群
• 在CI流程中执行kubectl命令检查Kubernetes资源状态（如Pod、Deployment健康状态）
• 通过CI流水线更新Kubernetes资源配置（如ConfigMap、Secret、Deployment版本）
• 自动化执行Kubernetes集群运维操作（如资源创建、删除、伸缩）

使用方法与配置说明

环境变量配置

GitLab CI配置示例

在.gitlab-ci.yml中使用该镜像执行部署操作：

deploy-to-k8s:
  stage: deploy
  image: kubectl-gitlab-ci:latest
  script:
    # 打印kubectl版本信息
    - kubectl version --client
    # 检查集群节点状态
    - kubectl get nodes
    # 部署应用
    - kubectl apply -f k8s/deployment.yaml
    # 确认部署状态
    - kubectl rollout status deployment/my-app -n default
  only:
    - main
  environment:
    name: production

本地测试示例

通过docker run命令本地模拟CI环境执行kubectl命令：

# 使用本地kubeconfig文件执行命令
docker run --rm -v $HOME/.kube/config:/root/.kube/config kubectl-gitlab-ci:latest kubectl get pods -n default

# 通过环境变量注入kubeconfig
docker run --rm -e KUBECONFIG="$(cat ~/.kube/config | base64)" kubectl-gitlab-ci:latest kubectl get svc

版本选择

镜像通过标签区分kubectl版本，格式为kubectl-gitlab-ci:<kubectl-version>，例如：

• kubectl-gitlab-ci:v1.28.0（对应kubectl v1.28.0）
• kubectl-gitlab-ci:latest（最新稳定版）

建议根据目标Kubernetes集群版本选择匹配的kubectl版本（遵循Kubernetes版本 skew策略）。