Google Cloud SDK 文档

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

此外,gcloud CLI 参考文档记录了所有 gcloud CLI 功能。

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

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

    python2 --version
  2. 下载以下软件包之一:
  3. 平台 软件包 大小 SHA256 校验和
    Linux 64 位

    (x86_64)

    google-cloud-sdk-298.0.0-linux-x86_64.tar.gz 68.7 MB 0d58f451331abf43d080fa997c8e580d64897627e30be74f6d8f983ccfabef1e
    Linux 32 位

    (x86)

    google-cloud-sdk-298.0.0-linux-x86.tar.gz 66.2 MB abcbe0c7e19462b48808154345b222b1dee1dfedae4cafe18ef18f2348803af3

  4. 将文件内容解压缩到文件系统上的任意位置。如果您想替换现有安装,请移除现有的 google-cloud-sdk 目录并将归档解压缩到同一位置。
  5. 可选。使用安装脚本将 Cloud SDK 工具添加至您的路径。您还可以选择为您的 shell 启用命令补全功能以及选择开启使用情况统计信息收集功能。使用以下命令运行脚本:
    ./google-cloud-sdk/install.sh
    
    也可以通过提供偏好设置作为标志来以非交互方式(例如,使用脚本)完成此操作。相关说明,请参阅:
    ./google-cloud-sdk/install.sh --help
    
    打开新终端,以使更改生效。
  6. 运行 gcloud init 来初始化 SDK:
  7. ./google-cloud-sdk/bin/gcloud init
    
  8. 可选。使用组件管理器安装其他组件。
Debian/Ubuntu

对于 Debian 和 Ubuntu 系统,可以通过软件包格式的 Cloud SDK 进行安装。此软件包仅包含 gcloudgcloud alphagcloud betagsutilbq 命令,而不包括 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/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 扩展程序,但您可以 单独安装 这些内容。

注意:如果您使用了 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 到 3.7 版本,以及 2.7.9 或更高版本。现代版本的 macOS 包含 Cloud SDK 所需的适当版本的 Python。
  2. python -V
    
  3. 下载以下某个软件包
  4. 平台 软件包 大小 SHA256 校验和
    macOS 64 位

    (x86_64)

    google-cloud-sdk-298.0.0-darwin-x86_64.tar.gz 69.1 MB 6d2e83c7e8bae273647ddc8c88d0eb72a6e24005d2290d90ba2b3505c3b65edc
    macOS 32 位

    (x86)

    google-cloud-sdk-298.0.0-darwin-x86.tar.gz 67.1 MB 609452e661d98e918d88a38a5fdc2e10a60991efd7cea06a5a20c509d7a7cfb1

  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. 可选。使用组件管理器安装其他组件。
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 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 命令行工具附带的无障碍功能,请参阅 启用无障碍功能 指南。

更多信息