lexiq/gcloud-docker

gcloud-docker镜像说明

镜像概述

本镜像提供了在GitLab CI/CD流水线中，将Docker镜像推送至Google Cloud Registry（GCR）并部署到Google Kubernetes Engine（GKE）集群的能力，帮助开发团队实现云原生应用的自动化构建、推送和部署流程。

核心功能

1. 支持Google Cloud服务账户认证（通过JSON密钥文件）
2. 将本地构建的Docker镜像推送至指定GCR仓库
3. 与GKE集群交互，应用Kubernetes部署配置
4. 无缝集成GitLab CI多阶段流水线（构建、推送、部署）

使用场景

适用于以下场景：

• 使用GitLab作为代码管理和CI/CD工具的团队
• 需要将Java或其他语言构建的应用部署到Google Cloud Kubernetes集群
• 希望实现应用镜像推送与集群部署自动化的开发流程

配置说明

前提条件

1. 在Google Cloud项目中创建服务账户，并生成JSON格式的密钥文件（参考：[***]
2. 在GitLab项目/组的CI/CD变量中配置以下参数：
   • GCLOUD_SERVICE_KEY：Google Cloud服务账户JSON密钥内容
   • KUBERNETES_NAMESPACE：目标Kubernetes命名空间
   • GCLOUD_SERVICE_NAME：服务名称
   • GCLOUD_PROJECT_ID：Google Cloud项目ID
   • GCLOUD_CLUSTER：GKE集群名称
   • GCLOUD_ZONE：集群所在区域（如europe-west1-b）
3. 项目根目录需包含kubernetes.yml文件（定义Kubernetes部署配置）

GitLab CI/CD示例

yaml
image: mathijsblok/gcloud-docker
services:
- docker:dind

variables:
  KUBERNETES_NAMESPACE: namespace
  GCLOUD_SERVICE_NAME: service-name
  GCLOUD_PROJECT_ID: some-gcloud-project
  GCLOUD_CLUSTER: dev-cluster
  GCLOUD_ZONE: europe-west1-b
  IMAGE_NAME: gcr.io/$GCLOUD_PROJECT_ID/$GCLOUD_SERVICE_NAME

stages:
- build
- push
- deploy

build:
  image: maven:3-jdk-8
  stage: build
  script: "mvn package -B"
  artifacts:
    paths:
    - target/*.jar

push:
  only:
  - master
  stage: push
  script:
  - docker build -t $IMAGE_NAME:$CI_BUILD_REF -t $IMAGE_NAME:latest .
  - echo $GCLOUD_SERVICE_KEY >> /tmp/google_sa.json
  - gcloud auth activate-service-account --key-file /tmp/google_sa.json
  - gcloud docker -- push $IMAGE_NAME:$CI_BUILD_REF
  - gcloud docker -- push $IMAGE_NAME:latest

deploy:
  stage: deploy
  only:
  - master
  dependencies:
  - push
  script:
  - echo $GCLOUD_SERVICE_KEY >> /tmp/google_sa.json
  - gcloud auth activate-service-account --key-file /tmp/google_sa.json
  - gcloud container clusters get-credentials $GCLOUD_CLUSTER --project $GCLOUD_PROJECT_ID --zone $GCLOUD_ZONE
  - kubectl apply -f kubernetes.yml
  - kubectl set image --namespace=$KUBERNETES_NAMESPACE deployment/$GCLOUD_SERVICE_NAME $GCLOUD_SERVICE_NAME=$IMAGE_NAME:$CI_BUILD_REF