talkingdolphin/gcloud-sdk-plus

gcloud-sdk-plus

镜像概述与主要用途

gcloud-sdk-plus是基于https://github.com/GoogleCloudPlatform/cloud-sdk-docker的扩展Docker镜像，额外集成了Go语言环境、yq、jq数据处理工具、ginkgo测试框架以及Datastore Emulator。该镜像旨在为GCP相关应用开发提供一站式环境，简化开发、部署和测试流程。

核心功能与特性

• 基础GCP工具：包含完整的Google Cloud SDK（gcloud、gsutil、bq等），支持GCP资源管理与操作
• Go开发环境：集成Go语言运行时，支持Go项目开发与编译
• 数据处理工具：内置yq（YAML处理）和jq（JSON处理），方便配置文件解析与数据转换
• 测试框架：集成ginkgo测试框架，支持Go应用的行为驱动开发（BDD）测试
• 本地模拟服务：包含Datastore Emulator，支持本地开发和测试Cloud Datastore应用

使用场景与适用范围

• GCP应用开发：需要同时使用gcloud命令行工具和Go环境的开发场景
• 自动化部署流程：CI/CD管道中需处理JSON/YAML配置并与GCP交互的场景
• 本地功能测试：需在本地模拟Datastore服务进行应用功能验证的场景
• Go项目测试：使用ginkgo进行Go项目单元测试和集成测试的场景

使用方法与配置说明

基本使用

拉取镜像

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/gcloud-sdk-plus:latest

交互式运行

bash
docker run -it --rm docker.xuanyuan.run/[镜像仓库地址]/gcloud-sdk-plus:latest /bin/bash

常用工具使用示例

1. GCP配置与操作

bash
# 初始化GCP配置
gcloud init

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

# 列出GCP存储桶
gsutil ls

2. Go开发

bash
# 查看Go版本
go version

# 创建Go模块并编译
go mod init example.com/myapp
go build -o myapp main.go

3. JSON/YAML处理

bash
# 使用jq解析JSON
echo '{"app":"gcloud-sdk-plus","version":"1.0"}' | jq '.app'

# 使用yq处理YAML
echo 'app: gcloud-sdk-plus\nversion: 1.0' | yq '.version'

4. 运行Ginkgo测试

bash
# 初始化Ginkgo测试
ginkgo bootstrap

# 生成测试文件
ginkgo generate mycomponent

# 运行测试
ginkgo -v

5. 启动Datastore Emulator

bash
# 启动模拟器并指定数据存储目录
gcloud beta emulators datastore start --data-dir=/data

# 在另一个终端设置环境变量并连接模拟器
$(gcloud beta emulators datastore env-init)

数据持久化配置

挂载本地目录以持久化GCP配置和Datastore数据：

bash
docker run -it --rm \
  -v $HOME/.config/gcloud:/root/.config/gcloud \  # 持久化GCP配置
  -v $PWD/datastore-data:/data \                # 持久化Datastore数据
  [镜像仓库地址]/gcloud-sdk-plus:latest

环境变量

支持Google Cloud SDK标准环境变量，主要包括：

• GOOGLE_APPLICATION_CREDENTIALS：服务账号密钥文件路径
• CLOUDSDK_CORE_PROJECT：默认GCP项目ID
• CLOUDSDK_COMPUTE_REGION：默认计算区域
• DATASTORE_EMULATOR_HOST：Datastore模拟器地址（本地运行时自动设置）