安装 Google Cloud SDK

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

准备工作

  1. 登录您的 Google 帐号。

    如果您还没有 Google 帐号,请注册一个新帐号

  2. 在 Cloud Console 的项目选择器页面上,选择或创建 Cloud 项目。

    转到项目选择器页面

  3. 确保您的 Google Cloud 项目已启用结算功能。 了解如何确认您的项目已启用结算功能

安装说明

Linux
  1. Cloud SDK 要求安装 Python。受支持的版本有 3.5 到 3.7 版本,以及 2.7.9 或更高版本。

    python --version
  2. 下载以下某个软件包
  3. 平台 软件包 大小 SHA256 校验和
    Linux 64 位

    (x86_64)

    google-cloud-sdk-309.0.0-linux-x86_64.tar.gz 85.2 MB c95f35e090918099a5f043a0ff80a9e15b7b91540920ae253a3114ac207b2b5b
    Linux 32 位

    (x86)

    google-cloud-sdk-309.0.0-linux-x86.tar.gz 83.5 MB 7fd4e2131a3b3d1c119f61546e694196313678241940671ae800e1a7e67e3475

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

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

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

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-309.0.0-linux-x86.tar.gz
  5. 将文件内容解压缩到文件系统上的任意位置。如果您想替换现有安装,请移除现有的 google-cloud-sdk 目录并将归档解压缩到同一位置。
  6. 可选。使用安装脚本将 Cloud SDK 工具添加至您的路径。您还可以选择为您的 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

    问题排查提示:如果您的发行版不支持 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

    问题排查提示:请确保您没有重复的 cloud-sdk 代码库条目。

  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 -

    问题排查提示:如果您由于密钥过期而无法获取最新更新,请获取最新的 apt-get.gpg 密钥文件

    问题排查提示:如果您发行版的 apt-key 命令不支持 --keyring 参数,请改为运行以下命令:

    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key 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

Red Hat/Fedora/CentOS

软件包内容

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

安装
  1. 利用 Cloud SDK 代码库信息更新 YUM:
    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=1
    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:
    yum install google-cloud-sdk
    注意:如需了解其他 yum 选项(例如停用提示或试运行),请参阅 yum 手册页面
  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 组件可以按以下方式安装:

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

降级 Cloud SDK 版本

如果您想还原到特定版本的 Cloud SDK(其中 VERSION 为 123.0.0 形式),请运行以下命令:sudo yum downgrade google-cloud-sdk-VERSION

macOS
  1. Cloud SDK 要求安装 Python。受支持的版本有 3.5 到 3.7 版本,以及 2.7.9 或更高版本。现代版本的 macOS 包含 Cloud SDK 所需的适当版本的 Python。
  2. python -V
    
  3. 下载以下某个软件包
  4. 平台 软件包 大小 SHA256 校验和
    macOS 64 位

    (x86_64)

    google-cloud-sdk-309.0.0-darwin-x86_64.tar.gz 85.6 MB 8bc50a56668148db72623f6f3e8af87c56fe8c058729ebfc17b0374c0ef0a012
    macOS 32 位

    (x86)

    google-cloud-sdk-309.0.0-darwin-x86.tar.gz 84.6 MB dc6a5fc8e289ba9a28872f16c7573c9a220a901c95e41856d0008b7180a3d65c

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

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

    2. 可选。使用安装脚本将 Cloud SDK 工具添加至您的路径。您还可以选择为您的 shell 启用命令补全功能以及选择开启使用情况统计信息收集功能。使用以下命令运行脚本:
      ./google-cloud-sdk/install.sh
      
      也可以通过提供偏好设置作为标志来以非交互方式(例如,使用脚本)完成此操作。相关说明,请参阅:
      ./google-cloud-sdk/install.sh --help
      
      打开新终端,以使更改生效。
    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 签名。

    Cloud SDK 要求安装 Python。受支持的版本有 3.5 到 3.7 版本,以及 2.7.9 或更高版本。

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

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

    Windows 安装程序提示

    确保选中以下选项:

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

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

  4. 默认安装不包括使用 gcloud 命令部署应用所必需的 App Engine 扩展程序。这些组件可通过 Cloud SDK 组件管理器进行安装。
问题排查提示
  • 如果 Cloud SDK 在安装版本 274.0.0 后无法运行,请参阅此 跟踪 bug,了解最新的解决方法。
  • 如果由于 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。