soon/gke-helm

GKE部署专用镜像（预安装Google Cloud CLI、kubectl和Helm）

镜像概述和主要用途

本Docker镜像专为持续部署（CD）流水线设计，预集成Google Cloud CLI（gcloud）、kubectl和Helm工具链，核心用途是简化从CI环境向Google Kubernetes Engine（GKE）集群的部署流程。通过提供预配置的工具环境，消除部署环节中的依赖安装步骤，提升流水线效率和一致性。

核心功能和特性

• 完整工具链预安装：内置Google Cloud CLI（与GCP交互）、kubectl（Kubernetes集群管理）和Helm（Kubernetes包管理），满足GKE部署全流程需求
• 版本化标签策略：镜像标签与捆绑的Helm版本严格对应，便于版本追溯和依赖管理
• 自动更新机制：最新的3个Helm次要版本标签（如3.14、3.13、3.12）每周自动更新，同步集成最新版kubectl和Google Cloud CLI

使用场景和适用范围

• CI/CD流水线集成：适配GitLab CI、GitHub Actions、Jenkins等主流CI平台，作为部署阶段的执行环境
• GKE自动化部署：适用于需要通过脚本自动化完成GCP认证、集群连接、应用发布的场景
• 多版本兼容需求：支持通过标签选择特定Helm版本，满足不同项目的工具版本依赖要求

使用方法和配置说明

镜像标签使用

标签格式遵循helm-major.helm-minor（次要版本）或helm-major.helm-minor.helm-patch（补丁版本），例如：

• 3.14：对应Helm 3.14.x版本
• 3.13.2：对应Helm 3.13.2具体版本

基础使用示例

1. 拉取镜像

bash
docker pull [镜像仓库地址]/gke-deploy-helper:3.14  # 拉取Helm 3.14版本镜像

2. 本地测试GKE连接

bash
docker run -it --rm \
  -v $HOME/.config/gcloud:/root/.config/gcloud \  # 挂载本地GCP配置
  [镜像仓库地址]/gke-deploy-helper:3.14 \
  gcloud container clusters get-credentials my-gke-cluster --zone us-central1-a --project my-gcp-project

3. GitLab CI配置示例

在.gitlab-ci.yml中集成部署步骤：

yaml
deploy_to_production:
  stage: deploy
  image: [镜像仓库地址]/gke-deploy-helper:3.14
  script:
    # GCP服务账号认证
    - echo "$GCP_SERVICE_KEY" > key.json
    - gcloud auth activate-service-account --key-file=key.json
    # 获取GKE集群凭证
    - gcloud container clusters get-credentials $CLUSTER_NAME --zone $GCP_ZONE --project $GCP_PROJECT
    # Helm部署应用
    - helm repo add my-charts https://charts.example.com
    - helm upgrade --install my-app my-charts/my-app --namespace production
  only:
    - main

版本维护说明

• 每周对最新的3个Helm次要版本标签执行自动更新，确保工具链安全性和兼容性
• 建议根据项目Helm版本锁定镜像标签，避免非预期的版本变更
• 旧版本标签（超出最新3个次要版本）将停止更新，建议及时迁移至新版本标签