Google Cloud SDK 文档

Google Cloud SDK 是一套工具，可用于管理托管在 Google Cloud Platform 上的资源和应用。这套工具包含 gcloud、gsutil 和 bq 命令行工具。gcloud 命令行工具随 Cloud SDK 一并下载；如需查看 gcloud CLI 的综合性指南，请参阅 gcloud 命令行工具概览。

此外，gcloud CLI 参考记录了所有 gcloud CLI 功能。

安装最新的 Cloud SDK 版本 (280.0.0)

Linux

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

    python2 --version
  2. 下载以下软件包之一：

    3. 平台 软件包 大小 SHA256 校验和
    Linux 64 位

    (x86_64)

    		 google-cloud-sdk-280.0.0-linux-x86_64.tar.gz 56.3 MB 11950f1db216ec7dc3abaf80722fb80518c38e279bd76b6924326fe660c209cf
    Linux 32 位

    (x86)

    		 google-cloud-sdk-280.0.0-linux-x86.tar.gz 54.5 MB dfc2bc5d016e1c20d43c7bcd2f5be3063c31b924971598838978fbe25d6ac341

  3. 将文件内容解压缩到文件系统上的任意位置。如果您想替换现有安装，请移除现有的 google-cloud-sdk 目录并将归档解压缩到同一位置。
  4. 可选。使用安装脚本将 Cloud SDK 工具添加至您的路径。您还可以选择为您的 shell 启用命令补全功能以及选择开启使用情况统计信息收集功能。使用以下命令运行脚本：
        ./google-cloud-sdk/install.sh
    打开新终端，以使更改生效。
  5. 运行 gcloud init 来初始化 SDK：
    6.     ./google-cloud-sdk/bin/gcloud init
  6. 可选。使用组件管理器安装其他组件。
Debian/Ubuntu

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

对于未达到使用期限的所有官方 Ubuntu 版本以及从 Wheezy 开始的 Debian 稳定版本，您可以通过 Debian/Ubuntu 软件包安装 Cloud SDK。

注意：如果您使用了 Google Compute Engine 上的实例，则会默认安装 Cloud SDK。但您仍可按照以下说明手动安装 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 手册页面。
  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
Red Hat/CentOS

对于 Red Hat Enterprise Linux 7、Red Hat Enterprise Linux 8 和 CentOS 7 系统，可以通过软件包格式的 Cloud SDK 进行安装。此软件包仅包含 gcloud、gcloud alpha、gcloud beta、gsutil、bq 命令，而不包括 kubectl 或使用 gcloud 命令部署应用时所必需的 App Engine 扩展程序，但您可以单独安装这些内容。

注意：如果您使用了 Google Compute Engine 上的实例，则会默认安装 Cloud SDK。

  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

    重要提示：gpgkey 的第二行必须缩进，如上文所示。

  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
macOS
  1. Cloud SDK 要求安装 Python。受支持的版本有 3.5 或更高版本，以及 2.7.9 或更高版本。现代版本的 macOS 包含 Cloud SDK 所需的适当版本的 Python。
    2.     python -V
  2. 下载以下软件包之一：

    3. 平台 软件包 大小 SHA256 校验和
    macOS 64 位

    (x86_64)

    		 google-cloud-sdk-280.0.0-darwin-x86_64.tar.gz 49.0 MB c9554507bc217a503b42bef7dfa72179bae57ad7e4e696af4205c50b373d3576
    macOS 32 位

    (x86)

    		 google-cloud-sdk-280.0.0-darwin-x86.tar.gz 47.9 MB 50c80701e1307ccd8e78fba34d34cec446cf24ee0a7ef30cef260c72676c0980

  3. 将文件内容解压缩到文件系统上的任意位置。如果您想替换现有安装，请移除现有的 google-cloud-sdk 目录并将归档解压缩到同一位置。
  4. 可选。使用安装脚本将 Cloud SDK 工具添加至您的路径。您还可以选择为您的 shell 启用命令补全功能以及选择开启使用情况统计信息收集功能。使用以下命令运行脚本：
        ./google-cloud-sdk/install.sh
    打开新终端，以使更改生效。
  5. 运行 gcloud init 来初始化 SDK：
    6.     ./google-cloud-sdk/bin/gcloud init
  6. 可选。使用组件管理器安装其他组件。
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 或更高版本，以及 2.7.9 或更高版本。

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

  3. 安装完成后，接受以下选项：

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

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

  4. 默认安装不包括使用 gcloud 命令部署应用所必需的 App Engine 扩展程序。这些组件可通过 Cloud SDK 组件管理器进行安装。

安装最新的 Google Cloud 客户端库

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

可选：启用无障碍功能

如需获得更精简的屏幕阅读器体验，gcloud 命令行工具会附带 accessibility/screen_reader 属性。

如需启用此属性，请运行以下命令：

gcloud config set accessibility/screen_reader true

如需详细了解 gcloud 命令行工具附带的无障碍功能，请参阅启用无障碍功能指南。

更多信息

schedule

快速入门

安装并初始化 Cloud SDK
description

方法指南

执行具体任务
code

API 与参考

gcloud CLI 参考
class

概念

深入了解 Cloud SDK

help

支持

获取有关 Cloud SDK 问题的帮助
library_books

资源

价格、配额、版本说明和其他资源

account_tree

解决方案

跨产品指南、最佳做法等