alpine/gcloud

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

镜像概述和主要用途

本镜像为谷歌云命令行工具(gcloud)的Docker化版本，当https://cloud.google.com/sdk/docs/release-notes%E6%97%B6%E4%BC%9A%E8%87%AA%E5%8A%A8%E8%A7%A6%E5%8F%91%E6%9E%84%E5%BB%BA%E3%80%82%E9%95%9C%E5%83%8F%E5%8C%85%E5%90%AB%E6%89%80%E6%9C%89gcloud%E7%BB%84%E4%BB%B6%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8ECI/CD%EF%BC%88%E6%8C%81%E7%BB%AD%E9%9B%86%E6%88%90%E5%92%8C%E6%8C%81%E7%BB%AD%E9%83%A8%E7%BD%B2%EF%BC%89%E6%88%96%E4%BD%9C%E4%B8%BA%E8%87%AA%E5%8A%A8%E5%8C%96%E6%9E%84%E5%BB%BA/%E9%83%A8%E7%BD%B2%E6%B5%81%E7%A8%8B%E7%9A%84%E4%B8%80%E9%83%A8%E5%88%86%E3%80%82

注意：由于包含所有gcloud组件，镜像体积较大（>2.8GB）。latest标签对应https://cloud.google.com/sdk/docs/release-notes%E4%B8%AD%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%EF%BC%8C%E4%BD%86%E7%94%9F%E4%BA%A7%E7%8E%AF%E5%A2%83%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%E5%85%B7%E4%BD%93%E7%89%88%E6%9C%AC%E6%A0%87%E7%AD%BE%EF%BC%88%E5%A6%82%60alpine/gcloud:290.0.1%60%EF%BC%89%EF%BC%8C%E9%81%BF%E5%85%8D%E4%BD%BF%E7%94%A8latest%E6%A0%87%E7%AD%BE%E3%80%82

核心功能和特性

• 自动构建机制：监听谷歌云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构建日志（历史）：https://travis-ci.org/alpine-docker/gcloud
• 镜像构建状态：由于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. 比对https://cloud.google.com/sdk/docs/release-notes%E4%B8%8EDocker Hub现有标签
3. 若存在未构建的新版本，自动构建并推送对应版本标签至Docker Hub
4. 同步更新latest标签指向最新版本

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