pindar/gcloud-kubectl-docker

gcloud-kubectl-docker 镜像文档

镜像概述

gcloud-kubectl-docker是一个专为Gitlab-CI环境设计的Docker镜像，基于docker:latest构建，预安装了Google Cloud CLI（gcloud）和Kubernetes命令行工具（kubectl）。该镜像旨在简化Gitlab-CI流程中与Google Cloud Platform（GCP）及Kubernetes集群的交互操作。

核心功能与特性

• 基础镜像：基于官方docker:latest，确保基础Docker功能可用
• 预装工具：包含gcloud（Google Cloud CLI）和kubectl（Kubernetes命令行工具）
• CI/CD优化：无需在CI流程中额外安装GCP和Kubernetes工具，直接使用预配置环境

使用场景与适用范围

适用于需要在Gitlab-CI流程中执行以下操作的场景：

• 与Google Cloud Platform进行交互（如资源管理、部署应用）
• 管理Kubernetes集群（如部署资源、查看集群状态）
• 构建和推送Docker镜像至GCP Container Registry

使用方法与配置说明

在Gitlab-CI中使用

在.gitlab-ci.yml文件中指定该镜像作为执行环境：

yaml
stages:
  - deploy

deploy-to-gke:
  stage: deploy
  image: gcloud-kubectl-docker
  script:
    # 配置gcloud认证
    - echo "$GCP_SERVICE_ACCOUNT_KEY" > key.json
    - gcloud auth activate-service-account --key-file=key.json
    - gcloud config set project $GCP_PROJECT_ID
    - gcloud config set compute/zone $GCP_ZONE
    
    # 获取GKE集群凭证
    - gcloud container clusters get-credentials $GKE_CLUSTER_NAME
    
    # 使用kubectl部署应用
    - kubectl apply -f k8s/deployment.yaml
    - kubectl rollout status deployment/my-app

环境变量说明

使用时通常需要配置以下环境变量（通过Gitlab CI/CD变量设置）：

• GCP_SERVICE_ACCOUNT_KEY：GCP服务账号密钥（JSON格式）
• GCP_PROJECT_ID：GCP项目ID
• GCP_ZONE：GCP区域（如us-central1-a）
• GKE_CLUSTER_NAME：GKE集群名称

本地测试

可通过以下命令本地运行镜像进行测试：

bash
docker run -it --rm gcloud-kubectl-docker sh

进入容器后，可直接使用gcloud和kubectl命令：

bash
# 查看gcloud版本
gcloud --version

# 查看kubectl版本
kubectl version --client