gcloud-sdk-alpine 镜像文档

镜像概述

gcloud-sdk-alpine是一款轻量级Docker镜像，基于Alpine Linux构建，集成了完整的Google Cloud SDK (gcloud)工具链。该镜像专为iDPARC AG的Bitbucket CI/CD流水线设计，提供稳定、高效的GCP（Google Cloud Platform）相关操作运行环境，支持在自动化流水线中执行GCP资源管理、应用部署、数据传输等任务。

核心功能与特性

• 轻量级基础：基于Alpine Linux，相比其他基础镜像（如Ubuntu）体积更小，启动速度更快，适合资源受限的CI/CD环境。
• 完整GCP工具链：集成最新稳定版Google Cloud SDK，包含gcloud、gsutil、bq等核心工具，支持GCP全平台操作。
• CI/CD适配性：针对Bitbucket流水线场景优化，可直接作为流水线执行环境，无需额外配置即可调用GCP工具。
• 环境一致性：通过容器化封装，确保不同流水线节点、不同执行环境中GCP工具版本和依赖的一致性，减少"环境差异"问题。

使用场景

主要用于iDPARC AG的Bitbucket CI/CD流水线，具体场景包括：

• 在自动化流水线中执行GCP资源部署（如GKE集群管理、Cloud Run服务部署）；
• 通过gsutil进行GCS（Google Cloud Storage）存储桶文件上传/下载；
• 使用bq工具操作BigQuery数据集；
• 执行GCP项目配置、权限管理等自动化脚本；
• 其他需要调用Google Cloud SDK的流水线任务。

使用方法与配置说明

基本使用（本地测试）

可通过以下命令启动镜像并验证gcloud环境：

bash
# 启动镜像并进入交互式终端
docker run --rm -it idparc/gcloud-sdk-alpine sh

# 在容器内验证gcloud版本
gcloud --version

在Bitbucket流水线中配置

在iDPARC AG的Bitbucket项目中，通过修改bitbucket-pipelines.yml文件，将该镜像指定为流水线执行环境。示例配置如下：

yaml
image: idparc/gcloud-sdk-alpine:latest  # 指定镜像及版本（如有版本标签）

pipelines:
  default:
    - step:
        name: "GCP资源部署"
        script:
          # 1. 激活GCP服务账号（需提前通过Bitbucket Secrets配置密钥文件）
          - gcloud auth activate-service-account --key-file=<path-to-service-account-key>
          # 2. 配置目标GCP项目
          - gcloud config set project <gcp-project-id>
          # 3. 执行具体GCP操作（示例：部署Cloud Run服务）
          - gcloud run deploy my-service --image gcr.io/<gcp-project-id>/my-image:latest --region us-central1

环境变量与配置

该镜像支持通过环境变量或挂载配置文件自定义gcloud行为，常用配置方式包括：

• 认证配置：通过挂载GCP服务账号密钥文件（推荐通过Bitbucket Secrets管理，避免硬编码）；
• 默认项目/区域：通过CLOUDSDK_CORE_PROJECT（默认项目ID）、CLOUDSDK_COMPUTE_REGION（默认区域）等环境变量预设gcloud配置，减少流水线脚本中的显式配置步骤。

注意事项

• 镜像基于Alpine Linux，部分依赖可能与其他Linux发行版存在差异，若流水线脚本涉及系统级依赖，需提前测试兼容性；
• 建议通过固定版本标签（如:1.0.0）使用镜像，避免因基础镜像或gcloud SDK版本更新导致流水线异常；
• GCP服务账号密钥等敏感信息需通过Bitbucket Secrets或其他安全方式注入，禁止直接存储在镜像或代码仓库中。