alpine/gcloud

gcloud - 谷歌云命令行工具Docker镜像

镜像概述和主要用途

本镜像为谷歌云命令行工具(gcloud)的Docker化版本，当谷歌云SDK发布新版本时会自动触发构建。镜像包含所有gcloud组件，主要用于CI/CD（持续集成和持续部署）或作为自动化构建/部署流程的一部分。

注意：由于包含所有gcloud组件，镜像体积较大（>2.8GB）。latest标签对应发布说明中最新版本，但生产环境建议使用具体版本标签（如alpine/gcloud:290.0.1），避免使用latest标签。

核心功能和特性

• 自动构建机制：监听谷歌云SDK新版本发布，自动触发Docker镜像构建
• 完整组件集成：包含所有gcloud组件，无需额外安装
• 版本标签管理：提供与官方版本对应的镜像标签，latest标签同步最新版本
• 多平台支持：可在非谷歌云Shell环境中运行，需通过凭证文件进行认证

使用场景和适用范围

• CI/CD流水线：作为持续集成/部署流程中的工具容器，执行gcloud命令
• 自动化运维：用于自动化构建、部署谷歌云资源的脚本环境
• 本地开发测试：在本地环境中模拟谷歌云命令行操作，避免直接在宿主机安装gcloud

注意事项

镜像大小说明

所有gcloud组件均已预装，导致镜像体积较大（>2.8GB），拉取和存储时需注意资源占用。

版本标签使用规范

• Docker镜像标签列表：https://hub.docker.com/r/alpine/gcloud/tags/
• latest标签对应官方最新发布版本，但生产环境必须使用具体版本标签（如290.0.1），避免版本变更引发意外问题

相关资源链接

• GitHub仓库：https://github.com/alpine-docker/gcloud
• Travis CI构建日志（历史）：[***]
• 镜像构建状态：由于Travis CI调整免费额度，自2021年7月15日起停止新标签发布，不再更新镜像版本

使用方法和配置说明

前提条件

需提前生成谷歌云应用默认凭证文件，用于容器内gcloud工具的认证授权。

步骤1：生成应用默认凭证

1. 创建本地配置目录：

   bash
   $ mkdir -p ~/.config/gcloud
   

2. 运行容器生成凭证（替换290.0.1为实际使用的版本标签）：

   bash
   $ docker run -ti --rm -v ~/.config/gcloud:/root/.config/gcloud alpine/gcloud:290.0.1 gcloud auth application-default login
   

3. 验证凭证文件生成（凭证保存在宿主机~/.config/gcloud/application_default_credentials.json）：

   bash
   $ cat ~/.config/gcloud/application_default_credentials.json
   {
     "client_id": "764086051850-6qr4p6gpi6hn506pt8ejuq83di341hur.apps.googleusercontent.com",
     "client_secret": "d-FL95Q19q7MQmFpd7hHD0Tx",
     "refresh_token": "1//0gnhgE8nu6YhICgYIARAAGBASNwF-L9IrERjKiLhTFNx_J2kVsvuC6vg0IbF5tl5g7z4NksVp0WEFBvj9KBlMCNmp9iRdImTljoc",
     "type": "authorized_user"
   }
   

   每个项目只需执行一次凭证生成流程，凭证文件可重复使用。

步骤2：运行gcloud命令

通过挂载本地凭证目录并设置环境变量，执行gcloud命令：

bash
$ docker run -ti --rm \
  -v ~/.config:/root/.config \
  -e GOOGLE_APPLICATION_CREDENTIALS="/root/.config/gcloud/application_default_credentials.json" \
  alpine/gcloud:290.0.1 \
  gcloud config list

步骤3：创建命令别名（可选）

为简化操作，可将长命令创建为系统别名：

bash
$ alias gcloud="docker run -ti --rm \
  -v ~/.config:/root/.config \
  -e GOOGLE_APPLICATION_CREDENTIALS=\"/root/.config/gcloud/application_default_credentials.json\" \
  alpine/gcloud:290.0.1 gcloud"

使用别名直接执行命令：

bash
$ gcloud config list
[accessibility]
screen_reader = true
[compute]
region = us-central1
zone = us-central1-a
[core]
account = student-01-47a98e659643@qwiklabs.net
disable_usage_reporting = True
project = qwiklabs-gcp-01-6b02c2d236db

Your active configuration is: [default]

镜像构建流程（历史）

1. 通过Travis CI定时任务每日检查master分支
2. 比对官方发布说明与Docker Hub现有标签
3. 若存在未构建的新版本，自动构建并推送对应版本标签至Docker Hub
4. 同步更新latest标签指向最新版本

注：由于Travis CI免费额度调整，自2021年7月15日起已停止新标签构建和发布。