安装 Cloud SDK

本页面包含有关选择和维护 Cloud SDK 安装的说明。 Cloud SDK 包含 gcloudgsutilbq 命令行工具。如需查看 Cloud SDK 功能的列表,请参阅所有功能

如需使用受支持的编程语言访问 Google Cloud API,您可以下载 Cloud 客户端库

安装说明

以下说明适用于安装 Cloud SDK。如需了解如何安装其他组件,例如 Alpha 版或 Beta 版级别的 gcloud 工具命令,请参阅管理 SDK 组件

Linux
  1. 确认您拥有受支持的 Python 版本。Cloud SDK 要求安装 Python 3(3.5 到 3.8,推荐 3.7)和 Python 2(2.7.9 或更高版本)。如需了解如何选择和配置 Python 解释器,请参阅 gcloud topic startup
  2. 下载以下内容之一:
    平台 软件包 大小 SHA256 校验和
    Linux 64 位

    (x86_64)

    google-cloud-sdk-365.0.1-linux-x86_64.tar.gz 92.7 MB 17003cdba67a868c2518ac16efa60dc6175533b7a9fb87304459784308e30fb0
    Linux 64 位

    (arm)

    google-cloud-sdk-365.0.1-linux-arm.tar.gz 90.1 MB fbe88d385e2648ac21bd67586c669e824160424627ac2f9c3fd17c79c765286b
    Linux 32 位

    (x86)

    google-cloud-sdk-365.0.1-linux-x86.tar.gz 90.1 MB 9cf354476192935d9d43db455f777e43daf2b59bb9110ff3f21d533e550916cf

    或者,如需下载 Linux 64 位归档文件,请在命令行中运行以下命令:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-365.0.1-linux-x86_64.tar.gz

    对于 64 位 arm 归档文件,请运行以下命令:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-365.0.1-linux-arm.tar.gz

    对于 32 位归档文件,请运行以下命令:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-365.0.1-linux-x86.tar.gz
  3. 将文件内容提取到文件系统上的任意位置(最好是主目录)。如需替换现有安装,请移除现有的 google-cloud-sdk 目录并将归档解压缩到同一位置。
  4. 如果您想发送匿名使用情况统计信息以帮助改进 Cloud SDK,请在出现提示时回答 Y
  5. 如需将 Cloud SDK 命令行工具添加到 PATH 并启用命令补全功能,请在出现提示时回答 Y
  6. 可选。使用安装脚本将 Cloud SDK 工具添加至您的 PATH。 您还可以选择为您的 shell 启用命令补全功能以及选择启用使用情况统计信息收集功能

    使用以下命令运行脚本(从解压缩到的文件夹的根目录运行):

    ./google-cloud-sdk/install.sh
    
    也可以通过提供偏好设置作为标志以非交互方式(例如使用脚本)完成此操作。相关说明,请参阅:
    ./google-cloud-sdk/install.sh --help
    
    打开新终端,以使更改生效。
  7. 如需初始化 SDK,请运行 gcloud init
  8. ./google-cloud-sdk/bin/gcloud init
    
  9. 可选。使用组件管理器安装其他组件。
Debian/Ubuntu

软件包内容

对于 Debian 和 Ubuntu 系统,可以通过软件包格式的 Cloud SDK 进行安装。 此软件包仅包含 gcloudgcloud alphagcloud betagsutil、和 bq 命令,而不包括 kubectl 或使用 gcloud 命令部署应用所需的 App Engine 扩展程序。如果您需要这些组件,则必须单独安装

准备工作

在安装 Cloud SDK 之前,请确保您的操作系统满足以下要求:

安装
  1. 添加 Cloud SDK 分发 URI 作为软件包源。如果您的发行版支持 signed-by 选项,请运行以下命令:
    echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

    如果您的发行不支持 signed-by 选项,请运行以下命令:

    echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  2. 导入 Google Cloud 公钥。 如果您的发行版的 apt-key 命令支持 --keyring 参数,请运行以下命令:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    如果您的发行版的 apt-key 命令不支持 --keyring 参数,请运行以下命令:

    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    如果您由于密钥过期而无法获取最新更新,请获取最新的 apt-get.gpg 密钥文件

  3. 更新并安装 Cloud SDK:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    如需了解其他 apt-get 选项(例如停用提示或试运行),请参阅 apt-get 手册页面

    Docker 提示:如果在 Docker 映像中安装 Cloud SDK,请改用单个 RUN 步骤:

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-sdk -y
          
  4. 您可以选择安装以下任何其他组件
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    例如,google-cloud-sdk-app-engine-java 组件可以按以下方式安装:

    sudo apt-get install google-cloud-sdk-app-engine-java
  5. 运行 gcloud init 以开始执行初始化操作:
    gcloud init

降级 Cloud SDK 版本

如需还原到特定版本的 Cloud SDK(其中 VERSION123.0.0 形式),请运行以下命令:

sudo apt-get update && sudo apt-get install google-cloud-sdk=123.0.0-0

代码库中始终提供最新的十个版本。

Red Hat/Fedora/CentOS

软件包内容

对于 Red Hat Enterprise Linux 7、Red Hat Enterprise Linux 8、Fedora 33 以及 CentOS 7 和 8 系统,可以通过软件包格式的 Cloud SDK 进行安装。此软件包仅包含 gcloudgcloud alphagcloud betagsutil、和 bq 命令,而不包括 kubectl 或使用 gcloud 命令部署应用所需的 App Engine 扩展程序,您可以按照本部分稍后所述的方法单独安装。

安装
  1. 使用 Cloud SDK 代码库信息更新 DNF。以下示例命令适用于与 Red Hat Enterprise Linux 8 兼容的安装。对于与 Red Hat Enterprise Linux 7 兼容的安装,请将 el8 替换为 baseUrl 的值中的 el7
    sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
    [google-cloud-sdk]
    name=Google Cloud SDK
    baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el8-x86_64
    enabled=1
    gpgcheck=1
    repo_gpgcheck=0
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM
    
  2. 安装 Cloud SDK:
    sudo dnf install google-cloud-sdk
  3. 您可以选择安装以下任何其他组件
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    例如,google-cloud-sdk-app-engine-java 组件可以按以下方式安装:

    sudo dnf install google-cloud-sdk-app-engine-java
  4. 运行 gcloud init 以开始执行初始化操作:
    gcloud init

降级 Cloud SDK 版本

如果您想还原到特定版本的 Cloud SDK(其中 VERSION 的格式为 123.0.0),请运行以下命令:sudo dnf downgrade google-cloud-sdk-VERSION 最新的 10 个版本将始终显示在代码库中。

macOS
  1. 确认您拥有受支持的 Python 版本:
    • 受支持的版本是 Python 3(3.5 到 3.8,推荐 3.7)和 Python 2(2.7.9 或更高版本)。
    • 现代版本的 macOS 包含 Cloud SDK 所需的适当版本的 Python。 如需查看当前的 Python 版本,请运行 python -V
    • 对于 Cloud SDK 发布版本 352.0.0 及更高版本,主安装脚本允许在基于 Intel 的 Mac 上安装 CPython 的 Python 3.7。
    • 如需详细了解如何选择和配置 Python 解释器,请参阅 gcloud topic startup
  2. 下载以下内容之一:
  3. 平台 软件包 大小 SHA256 校验和
    macOS 64 位

    (x86_64)

    google-cloud-sdk-365.0.1-darwin-x86_64.tar.gz 93.2 MB 4ae8a3274eb9b6fca5761ef2eed713bc3486256d11268575febe3351e9e4d902
    macOS 64 位

    (arm64、Apple M1 silicon)

    google-cloud-sdk-365.0.1-darwin-arm.tar.gz 93.2 MB 636591e597730649011f510fc8c78e2b133ef8b417992f8d923a87a528dc6d5e
    macOS 32 位

    (x86)

    google-cloud-sdk-365.0.1-darwin-x86.tar.gz 97.0 MB b3b04f7f5577347d5c30277d4bf6aa2d1a182c1ff8f9cc04edf0dee6f0b8c4a9

    1. 将归档解压缩到文件系统上的任意位置(最好是解压缩到您的主目录)。在 macOS 上,此操作可通过打开下载到首选位置的 .tar.gz 归档文件来实现。

      如需替换现有安装,请移除现有的 google-cloud-sdk 目录,然后将归档解压缩到同一位置。

    2. 可选。使用安装脚本将 Cloud SDK 工具添加至您的 PATH

      您还可以选择为您的 shell 启用命令补全功能以及选择启用使用情况统计信息收集功能,并视情况安装 Python 3.7。

      使用以下命令运行脚本(从您在上一步中解压缩的文件夹的根目录运行):

      ./google-cloud-sdk/install.sh
      
      也可以通过提供偏好设置作为标志以非交互方式(例如使用脚本)完成此操作。如需描述可用标志,请运行以下命令:
      ./google-cloud-sdk/install.sh --help
      
      如需在开启屏幕阅读器模式的情况下运行安装脚本,请运行以下命令:
      ./google-cloud-sdk/install.sh --screen-reader=true
      
      打开新终端,以使更改生效。
    3. 运行 gcloud init 来初始化 SDK:
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. 可选。使用组件管理器安装其他组件。
Windows
  1. 下载 Cloud SDK 安装程序

    或者,打开 PowerShell 终端,然后运行以下 PowerShell 命令:

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
    
    & $env:Temp\GoogleCloudSDKInstaller.exe
        
  2. 启动安装程序并按提示操作。安装程序已经过 Google LLC 签名。

    如果您使用的是屏幕阅读器,请选中启用屏幕阅读器模式复选框。此选项会将 gcloud 配置为使用状态跟踪器而不是 Unicode 旋转图标,以百分比表示显示进度和展开的表。如需了解详情,请参阅无障碍功能指南

  3. Cloud SDK 要求安装 Python;支持的版本是 Python 3(首选,3.5 到 3.8)和 Python 2(2.7.9 或更高版本)。 Cloud SDK 默认附带 Python 3。如需使用 Cloud SDK,您的操作系统必须能够运行受支持的 Python 版本。

    安装程序会安装所有必需的依赖项(包括所需的 Python 版本)。虽然 Cloud SDK 默认安装和管理 Python 3,但您可以根据需要使用已安装的 Python,只需取消选中“安装捆绑的 Python”选项即可。请参阅 gcloud topic startup,了解如何使用现有 Python 安装。

  4. 安装完成后,安装程序会为您提供创建开始菜单和桌面快捷方式,启动 Cloud SDK shell 以及配置 Cloud SDK 的选项。确保已选择用于启动 shell 并配置安装的选项。安装程序会启动终端窗口并运行 gcloud init 命令。

  5. 默认安装不包括使用 gcloud 命令部署应用所必需的 App Engine 扩展程序。这些组件可通过 Cloud SDK 组件管理器进行安装。
问题排查提示
  • 如果由于 find 命令未被识别而导致安装失败,请确保您的 PATH 环境变量设置为将包含 find 的文件夹包括在内。通常,此文件夹为 C:\WINDOWS\system32;
  • 如果您卸载了 Cloud SDK,则必须重新启动系统才能再次安装 Cloud SDK。
  • 如果解压缩失败,请以管理员身份运行安装程序。

其他安装选项

根据您的开发需求,您可以使用其他方法安装 Cloud SDK,而非使用建议安装

  • 如需将 Cloud SDK 与脚本或持续集成/部署结合使用,请下载 版本归档,以非交互方式安装特定版本的 Cloud SDK。
  • 如需作为 Docker 映像运行 Cloud SDK,请使用 Cloud SDK Docker 映像获取最新版本(或特定版本)的 Cloud SDK。
  • 运行 Ubuntu 并希望自动更新?使用快照软件包安装 Cloud SDK。
  • 对于 Windows 和 macOS 交互式安装以及所有其他用例,请运行交互式安装程序以安装最新版本的 Cloud SDK。

管理安装

安装 Cloud SDK 后,您可以使用 gcloud components 命令组中的命令来管理安装。这包括查看已安装的组件、添加和移除组件,以及升级到新的 Cloud SDK 版本或降级到特定 Cloud SDK 版本。

旧版 Cloud SDK

如果您需要旧版 Cloud SDK,可以下载以往版本

自行试用

如果您是 Google Cloud 新手,请创建一个帐号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。

免费开始使用