Garden-Google Cloud SDK 镜像文档

1. 镜像概述

本镜像是一个集成Garden工具与Google Cloud SDK（gcloud CLI）的容器化环境，旨在为开发者和运维人员提供一站式工具链，简化基于Google Cloud Platform（GCP）的应用开发、构建、部署及运维流程。通过容器化封装，确保工具版本一致性和环境隔离，避免本地环境依赖冲突。

2. 核心功能与特性

• 预集成工具链：内置稳定版Garden和Google Cloud SDK，包含gcloud、gsutil、bq等GCP命令行工具
• 环境隔离：容器化运行，不干扰宿主机配置，支持多版本并行使用
• 即开即用：无需手动安装依赖，拉取镜像后可直接执行Garden和gcloud命令
• 配置持久化：支持挂载本地配置文件（如gcloud credentials、Garden配置），实现状态持久化
• 多平台支持：适配linux/amd64、linux/arm64等主流架构（具体以镜像标签为准）

3. 使用场景与适用范围

• 本地开发环境：快速搭建包含Garden和GCP工具链的开发环境，统一团队配置
• CI/CD流水线：在自动化流程中执行Garden构建、GCP资源部署（如GKE集群、Cloud Run服务）
• 测试环境：模拟GCP生产环境，使用Garden进行应用部署测试、资源验证
• 多团队协作：提供标准化工具环境，减少"本地可运行，线上有问题"的环境差异
• 临时任务：执行一次性GCP操作（如数据迁移、资源审计），避免本地工具安装

4. 使用方法与配置说明

4.1 前提条件

• 已安装Docker Engine（20.10+）或Docker Desktop
• 网络可访问镜像仓库及GCP API（如需执行GCP操作）

4.2 镜像拉取

docker pull [镜像仓库地址]/garden-gcloud:latest

注：实际使用时需替换[镜像仓库地址]为真实仓库路径（如Docker Hub、私有仓库等）

4.3 基本使用（Docker Run）

4.3.1 交互式终端

启动容器并进入交互式终端，直接使用工具链：

docker run -it --rm [镜像仓库地址]/garden-gcloud:latest /bin/bash

进入容器后验证工具可用性：

# 验证Garden版本
garden --version

# 验证gcloud版本
gcloud --version

4.3.2 单次命令执行

无需进入容器，直接执行命令（如查询GCP项目列表）：

docker run --rm [镜像仓库地址]/garden-gcloud:latest gcloud projects list

4.4 配置持久化与认证

4.4.1 挂载gcloud配置目录

挂载本地gcloud配置目录（默认~/.config/gcloud），实现认证状态持久化：

docker run -it --rm \
  -v ~/.config/gcloud:/root/.config/gcloud \
  [镜像仓库地址]/garden-gcloud:latest /bin/bash

4.4.2 服务账号认证

通过环境变量指定GCP服务账号密钥，实现非交互式认证：

docker run -it --rm \
  -v /local/path/to/key.json:/app/key.json \
  -e GOOGLE_APPLICATION_CREDENTIALS=/app/key.json \
  [镜像仓库地址]/garden-gcloud:latest \
  gcloud auth activate-service-account --key-file=/app/key.json

4.5 Docker Compose配置示例

version: '3.8'

services:
  garden-gcloud:
    image: [镜像仓库地址]/garden-gcloud:latest
    volumes:
      # 挂载gcloud配置
      - ~/.config/gcloud:/root/.config/gcloud
      # 挂载Garden项目代码
      - ./garden-project:/app/garden-project
      # 挂载服务账号密钥
      - ./service-account-key.json:/app/key.json
    environment:
      # GCP配置
      - GOOGLE_CLOUD_PROJECT=my-gcp-project-id
      - GOOGLE_APPLICATION_CREDENTIALS=/app/key.json
      - CLOUDSDK_CORE_REGION=us-central1
      # Garden配置
      - GARDEN_ENV=dev
      - GARDEN_LOG_LEVEL=info
    working_dir: /app/garden-project
    stdin_open: true
    tty: true

启动服务：

docker-compose up -d
docker-compose exec garden-gcloud /bin/bash

5. 配置参数与环境变量

5.1 核心环境变量

5.2 gcloud常用配置命令

容器内可通过以下命令配置gcloud默认参数：

# 设置默认项目
gcloud config set project my-gcp-project-id

# 设置默认区域和可用区
gcloud config set compute/region us-central1
gcloud config set compute/zone us-central1-a

# 查看当前配置
gcloud config list

6. 注意事项

• 版本锁定：生产环境建议使用具体版本标签（如v1.2.3）而非latest，避免兼容性问题
• 权限管理：挂载本地文件时确保容器用户（默认root）对文件有读写权限
• 密钥安全：服务账号密钥文件避免提交至代码仓库，建议通过安全密钥管理服务注入
• 网络要求：执行GCP操作需确保容器可访问[***]，必要时配置代理
• 镜像更新：定期拉取最新镜像以获取工具安全补丁和功能更新
• 数据持久化：重要配置文件建议通过挂载宿主机目录或使用Docker Volume持久化