安装 Google Cloud SDK

本页面包含有关选择和维护 Cloud SDK 安装的说明。

安装说明

Linux
  1. Cloud SDK 要求安装 Python;支持的版本是 Python 3(首选,3.5 到 3.8)和 Python 2(2.7.9 或更高版本)。

    python --version
    您的操作系统必须能够运行这些受支持的 Python 版本之一才能运行 Cloud SDK。如需详细了解如何选择和配置 Python 解释器,请参阅 gcloud topic startup
  2. 下载以下软件包之一:
  3. 平台 软件包 大小 SHA256 校验和
    Linux 64 位

    (x86_64)

    google-cloud-sdk-350.0.0-linux-x86_64.tar.gz 86.4 MB 861a02dcaed5eb8b4b2fe39640355700af322c1e487226e7bf19356496e28cee
    Linux 64 位

    (arm)

    google-cloud-sdk-350.0.0-linux-arm.tar.gz 83.8 MB f9334db8f1558e2edc9b20992259306b176be46b07ecee03f5a95a50d780af48
    Linux 32 位

    (x86)

    google-cloud-sdk-350.0.0-linux-x86.tar.gz 83.7 MB 37d34ec5072829ee4aac1159c505ac6d91f9605169d47b316c8f4329f70ae87e

  4. 或者,如需通过命令行下载 Linux 64 位归档文件,请运行以下命令:

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

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

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

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

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

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

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

软件包内容

对于 Debian 和 Ubuntu 系统,可以通过软件包格式的 Cloud SDK 进行安装。此软件包仅包含 gcloudgcloud alphagcloud betagsutilbq 命令,而不包括 kubectl 或使用 gcloud 命令部署应用所必需的 App Engine 扩展程序。如果您需要这些组件,则必须按照本部分稍后所述的方法另行安装。

前提条件

在安装 Cloud SDK 之前,请确保您的操作系统是下面某一项:

安装
  1. 添加 Cloud SDK 分发 URI 作为软件包源:
    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
    请确保您已安装 apt-transport-https
    sudo apt-get install apt-transport-https ca-certificates gnupg
  2. 导入 Google Cloud 公钥:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
  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(其中 VERSION 的格式为 123.0.0),请运行以下命令:sudo apt-get update && sudo apt-get install google-cloud-sdk=123.0.0-0 最新的 10 个版本将始终显示在代码库中。

Red Hat/Fedora/CentOS

软件包内容

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

安装
  1. 利用 Cloud SDK 代码库信息更新 DNF:
    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-el7-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. Cloud SDK 要求安装 Python;支持的版本是 Python 3(首选,3.5 到 3.8)和 Python 2(2.7.9 或更高版本)。现代版本的 macOS 包含 Cloud SDK 所需的适当版本的 Python。 如需查看当前的 Python 版本,请运行以下命令:
      python -V
      
    如需详细了解如何选择和配置 Python 解释器,请参阅 gcloud topic startup
  2. 下载以下内容之一:
  3. 平台 软件包 大小 SHA256 校验和
    macOS 64 位

    (x86_64)

    google-cloud-sdk-350.0.0-darwin-x86_64.tar.gz 86.9 MB d3b995a4b8d0d5a2181d98298ca31020f406c323bc51889a4e3a7aefc346963e
    macOS 64 位

    (arm64)

    google-cloud-sdk-350.0.0-darwin-arm.tar.gz 86.8 MB 8af64643437114658c58d2fa75c58ee830737e04268a650f2992972b5440f1f3
    macOS 32 位

    (x86)

    google-cloud-sdk-350.0.0-darwin-x86.tar.gz 90.7 MB a20157ac9974b02b329d53fb1de0d79b6a5fc97844e71f47e22b59aa5fb652d5

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

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

    2. 可选。使用安装脚本将 Cloud SDK 工具添加至您的 PATH。您还可以选择为您的 shell 启用命令补全功能以及选择开启使用情况统计信息收集功能

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

      ./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 签名。

    如果您要启用屏幕阅读器模式,请选择启用屏幕阅读器模式 (Turn on screen reader mode) 选项,以畅享更精简的屏幕阅读器体验。如需详细了解 Cloud SDK 屏幕阅读器体验,请参阅无障碍功能指南

    Windows 中“Google Cloud SDK 安装程序”(Google Cloud SDK Setup) 的“欢迎使用”对话框,其中包含用于启用屏幕阅读器模式的复选框

  3. Cloud SDK 要求 Python;受支持的版本是 Python 3(首选,版本 3.5 到 3.8;安装程序默认绑定 Python 3)和 Python 2(2.7.9 或更高版本)。您的操作系统必须能够运行这些受支持的 Python 版本之一才能运行 Cloud SDK。

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

  4. 安装完成后,安装程序会提供几个选项:

    Windows 安装程序提示

    确保选中以下选项:

    • 启动 Google Cloud SDK Shell (Start Google Cloud SDK Shell)
    • 运行 gcloud init

    安装程序会启动终端窗口并运行 gcloud init 命令。

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

可选:安装最新的 Google Cloud 客户端库

您可以为支持的语言下载 Cloud 客户端库

其他安装选项

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

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

随附组件

上述所有安装方法都会安装默认的 Cloud SDK 组件,其中包括 gcloudgsutilbq 命令行工具。

如需安装其他组件,您可以使用 gcloud components install 命令,或安装相应的 deb 或 RPM 软件包。

管理安装

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

旧版 Cloud SDK

如果您需要还原到较旧版本的 Cloud SDK,可以从此归档文件中找到所有可供下载的旧版 Cloud SDK。

亲自尝试

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

免费开始使用