Google Cloud CLI Docker镜像使用说明

Google Cloud CLI Docker镜像可从Artifact Registry拉取特定版本的gcloud CLI，让你在隔离且配置正确的容器中快速执行Google Cloud CLI命令。完整细节可参考镜像文档页。

镜像类型说明

Google Cloud CLI Docker镜像共有六种，均包含gcloud、gsutil和bq命令行工具。以下是各类型特点及适用场景：

1. :stable、:VERSION-stable

• 特点：最小化环境，仅包含gcloud核心组件及gsutil、bq。
• 基础镜像：最新Google提供的Debian 12基础镜像。
• 使用：推荐作为基础镜像，按需扩展安装组件；指定版本用:VERSION-stable标签（如:489.0.0-stable），最新稳定版直接用:stable。

2. :alpine、:VERSION-alpine

• 特点：功能同stable，但基于轻量级Alpine系统。
• 基础镜像：最新Alpine 3.20。
• 使用：适合需要精简基础镜像的场景；指定版本用:VERSION-alpine标签。

3. :emulators、:VERSION-emulators

• 特点：在stable基础上增加所有模拟器组件。
• 基础镜像：最新Google提供的Debian 12基础镜像，通过组件管理器安装额外组件。
• 使用：需本地运行Google Cloud服务模拟器时选用；指定版本用:VERSION-emulators标签。

4. :latest、:VERSION

• 特点：在stable基础上预装额外组件（组件列表见此处）。
• 基础镜像：最新Google提供的Debian 12基础镜像，通过deb包安装组件。
• 使用：需常用扩展组件时直接选用；指定版本用:VERSION标签。

5. :slim、:VERSION-slim

• 特点：在stable基础上增加第三方工具，包括curl、python3-crcmod、apt-transport-https、lsb-release、openssh-client、git、make、gnupg。
• 基础镜像：最新Google提供的Debian 12基础镜像。
• 使用：需基础开发工具链时选用；指定版本用:VERSION-slim标签。

6. :debian_component_based、:VERSION-debian_component_based

• 特点：在stable基础上预装额外组件（组件列表见此处）。
• 基础镜像：最新Google提供的Debian 12基础镜像，通过组件管理器安装组件。
• 使用：需通过组件管理器灵活管理扩展组件时选用；指定版本用:VERSION-debian_component_based标签。

查看Docker Hub获取所有可用标签。

!Docker Pulls !Docker Build Status !Docker Automated build

镜像安装步骤

镜像托管位置

gcloud CLI Docker镜像托管于：

• Docker Hub仓库：google/cloud-sdk（查看标签）
• Artifact Registry：google.com:cloudsdktool/us/gcr.io/cloud-sdk

拉取镜像

以stable版本为例，从Docker Hub拉取特定版本镜像（如489.0.0-stable）：

docker pull google/cloud-sdk:489.0.0-stable

如需拉取最新稳定版（使用浮动标签:stable，始终指向最新发布）：

docker pull google/cloud-sdk:stable

验证安装

• 使用特定版本标签（如489.0.0-stable）：

  docker run --rm google/cloud-sdk:489.0.0-stable gcloud version
  

• 使用浮动标签:stable：

  docker run --rm google/cloud-sdk:stable gcloud version
  

Cloud SDK发布跟踪

可通过以下链接关注Cloud SDK发布计划及更新：
Google Cloud SDK Announce论坛