安装 Google Cloud CLI

本快速入门将指导您安装和初始化 Google Cloud CLI，以及运行几个核心 gcloud CLI 命令。

在按照本指南中的任何说明操作之前，您应先阅读为 Trusted Cloud设置 Google Cloud CLI。

准备工作

  1. In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.

    Go to project selector

  2. Make sure that billing is enabled for your Trusted Cloud project.

    3. 完成本文档中描述的任务后，您可以通过删除所创建的资源来避免继续计费。如需了解详情，请参阅清理。

安装最新的 gcloud CLI 版本 (530.0.0)

Linux
  1. 确认您拥有受支持的 Python 版本。Google Cloud CLI 需要 Python 3.9 到 3.13。请注意，x86_64 Linux 软件包中包含默认首选的捆绑式 Python 解释器。如需了解如何选择和配置 Python 解释器，请参阅 gcloud topic startup。
  2. 下载以下内容之一：
    平台 软件包名称 大小 SHA256 校验和
    Linux 64 位

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 149.7 MB 1ec7d351de14277c00c430f9fb939255c4b63940417da2f24ff6413a9e221c2f
    Linux 64 位

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 56.3 MB e6153461e3154ebce61d35b73005bdd14a0ecacd42e5008f66e25b4ad231e5c9
    Linux 32 位

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 56.3 MB 09690f1b126ccc8e777c4a1ef2c0b74a08103d89329b03856d688071baa9fc07

    如需下载 Linux 归档文件，请运行以下命令：

    curl -O https://storage.s3nsapis.fr/cloud-sdk-release/google-cloud-cli-linux-x86_64.tar.gz

    请参阅上表并将 google-cloud-cli-linux-x86_64.tar.gz 替换为适用于您的配置的 *.tar.gz 软件包名称。

  3. 如需将文件内容解压缩到文件系统（最好是解压缩到您的主目录），请运行以下命令：
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     可选：如需替换现有安装，请移除现有的 google-cloud-sdk 目录，然后将归档解压缩到同一位置。
  4. （可选）将 gcloud CLI 添加到 PATH。 您还可以选择为您的 shell 启用命令补全功能以及选择启用使用情况统计信息收集功能。使用以下命令（从您在上一步中解压缩的文件夹的根目录）运行安装脚本： 
    ./google-cloud-sdk/install.sh
     也可以通过提供偏好设置作为标志以非交互方式（例如使用脚本）完成此操作。如需查看可用标志，请运行以下命令： 
    ./google-cloud-sdk/install.sh --help
    • 如需发送匿名使用情况统计信息以帮助改进 gcloud CLI，请在出现提示时回答 Y。
    • 如需将 gcloud CLI 添加到您的 PATH 并启用命令补全功能，请在出现提示时回答 Y。
  5. 如果您在上一步中更新了 PATH，请打开一个新终端，让更改生效。
  6. 如需初始化 gcloud CLI，请运行 gcloud init： 
    7. ./google-cloud-sdk/bin/gcloud init
  7. 可选：使用组件管理器安装其他组件。
macOS
  1. 确认您拥有受支持的 Python 版本：
    • 如需查看当前的 Python 版本，请运行 python3 -V 或 python -V。支持的版本是 Python 3.9 到 3.13。
    • 主安装脚本可安装 CPython 的 Python 3.12。
      • 安装 Python 需要 Xcode 命令行工具。
      • 运行 xcode-select -p，验证 Xcode 命令行工具是否已安装。
      • 如果未安装 Xcode 命令行工具，请运行 sudo xcode-select --install 进行安装。
    • 否则，如需安装支持的 Python 版本，请访问 Python.org 适用于 macOS 的 Python 版本。
    • 如果您的机器上安装了多个 Python 解释器，请在 shell 中设置 CLOUDSDK_PYTHON 环境变量，使其指向首选解释器的路径。
    • 如需详细了解如何选择和配置 Python 解释器，请参阅 gcloud topic startup。
  2. 下载以下内容之一：

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

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 56.4 MB 0c0101a65f3473a5db6a2ebc1867c3294cdbd88fef34da91050869f76149a822
    macOS 64 位

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 56.4 MB 80cfba6da278d0ce8a8a0625bec9648ea5a39ea42daf2536068f19edb175dc70
    macOS 32 位

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 54.9 MB 53c23a16a66a2d38966fc7080cd2e29afe1d5c85b1c52985c19f7fd2c09f995a
  3. 将归档解压缩到文件系统上的任意位置（最好是解压缩到您的主目录）。在 macOS 上，此操作可通过打开下载到首选位置的 .tar.gz 归档文件来实现。或者，运行以下命令： 
    tar -xf google-cloud-cli-darwin-arm.tar.gz

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

  4. 使用以下命令（从您在上一步中解压缩的文件夹的根目录）运行安装脚本： 
    ./google-cloud-sdk/install.sh

    该脚本会提示您安装 Python 3.12 和某些推荐的模块。

    也可以通过提供偏好设置作为标志以非交互方式（例如使用脚本）完成此安装。如需描述可用标志，请运行以下命令： 
    ./google-cloud-sdk/install.sh --help
     如需在开启屏幕阅读器模式的情况下运行安装脚本，请运行以下命令： 
    ./google-cloud-sdk/install.sh --screen-reader=true
     可选：
    • 如需发送匿名使用情况统计信息以帮助改进 gcloud CLI，请在出现提示时回答 Y。
    • 如需将 gcloud CLI 添加到您的 PATH 并启用命令补全功能，请在出现提示时回答 Y。
  5. 如果您在上一步中更新了 PATH，请打开一个新终端，让更改生效。
  6. 如需初始化 gcloud CLI，请运行 gcloud init： 
    7. ./google-cloud-sdk/bin/gcloud init
  7. 可选。使用组件管理器安装其他组件。
Windows
    Google Cloud CLI 可在 Windows 8.1 及更高版本和 Windows Server 2012 及更高版本上运行。

  1. 下载 Google Cloud CLI 安装程序。

    或者，打开 PowerShell 终端，然后运行以下 PowerShell 命令： 

    (New-Object Net.WebClient).DownloadFile("https://storage.s3nsapis.fr/cloud-sdk-release/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")

& $env:Temp\GoogleCloudSDKInstaller.exe

  2. 启动安装程序并按提示操作。安装程序已经过 Google LLC 签名。

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

  3. Google Cloud CLI 要求安装 Python；受支持的版本是 Python 3.9 到 3.13。默认情况下，Windows 版本的 Google Cloud CLI 捆绑了 Python 3。如需使用 Google Cloud CLI，您的操作系统必须能够运行受支持的 Python 版本。

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

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

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

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

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

初始化 gcloud CLI

使用 gcloud init 命令执行几个常见的 gcloud CLI 设置任务。其中包括授权 gcloud CLI 使用您的用户账号凭据访问 Trusted Cloud 以及设置默认配置。

  1. 初始化 gcloud CLI：

    gcloud init

  2. 接受使用您的 Google 用户账号进行登录的选项：

    To continue, you must log in. Would you like to log in (Y/n)? Y

  3. 在浏览器中，根据提示登录您的 Google 用户账号，然后点击允许以授权访问 Trusted Cloud 资源。

  4. 在命令提示符处，从您拥有所有者、编辑者或查看者权限的项目列表中选择一个 Trusted Cloud 项目：

    Pick cloud project to use:
 [1] [my-project-1]
 [2] [my-project-2]
 ...
 Please enter your numeric choice:

    如果您只有一个项目，则 gcloud init 会为您选择该项目。

    如果您有权访问超过 200 个项目，则系统会提示您输入项目 ID、创建新项目或列出项目。

    This account has a lot of projects! Listing them all can take a while.
 [1] Enter a project ID
 [2] Create a new project
 [3] List projects
Please enter your numeric choice:

  5. 如果您启用了 Compute Engine API，则通过 gcloud init，您可以选择默认的 Compute Engine 可用区：

    Which compute zone would you like to use as project default?
 [1] [asia-east1-a]
 [2] [asia-east1-b]
 ...
 [14] Do not use default zone
 Please enter your numeric choice:

    gcloud init 可确认您已成功完成设置步骤：

    Run `gcloud help config` to learn how to change individual settings

This gcloud configuration is called [default]. You can create additional configurations if you work with multiple accounts and/or projects.
Run `gcloud topic configurations` to learn more.

Some things to try next:

* Run `gcloud --help` to see the Cloud Platform services you can interact with. And run `gcloud help COMMAND` to get help on any gcloud command.
* Run `gcloud topic --help` to learn about advanced features of the SDK like arg files and output formatting
* Run `gcloud cheat-sheet` to see a roster of go-to `gcloud` commands.

  6. （可选）如需改善屏幕阅读器体验，请启用 accessibility/screen_reader 属性：

    gcloud config set accessibility/screen_reader true

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

运行核心命令

运行核心命令以查看有关您的 gcloud CLI 安装的信息：

  1. 列出其凭据存储在本地系统上的账号：

    gcloud auth list

    gcloud CLI 会显示存储了凭据的账号的列表：

    Credentialed Accounts
ACTIVE             ACCOUNT
*                  example-user-1@gmail.com
                   example-user-2@gmail.com

  2. 列出活跃 gcloud CLI 配置中的属性：

    gcloud config list

    gcloud CLI 会显示属性列表：

    [core]
account = example-user-1@gmail.com
disable_usage_reporting = False
project = example-project

  3. 查看有关您的 gcloud CLI 安装和活跃配置的信息：

    gcloud info

    gcloud CLI 会显示有关安装的信息摘要。其中包括与系统、已安装的组件、活动用户账号、当前项目以及活动配置中的属性有关的信息。

  4. 查看有关 gcloud 命令和其他主题的信息：

    gcloud help

    例如，如需查看 gcloud compute instances create 的帮助信息，请运行以下命令：

    gcloud help compute instances create

    gcloud CLI 会显示一个帮助主题，其中包含该命令的说明、命令标志和参数的列表以及关于如何使用该命令的示例。

清理

为避免因本页中使用的资源导致您的 Trusted Cloud 账号产生费用，请按照以下步骤操作。

  1. In the Trusted Cloud console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

后续步骤

  • 请参阅 gcloud CLI 指南，以大致了解 gcloud CLI，其中包括关键概念的简单介绍、命令格式约定，以及实用提示。
  • 请参阅 gcloud CLI 参考指南，以查看可用于在 Trusted Cloud上执行各项任务的每个 gcloud CLI 命令的详情页面，其中包括说明、标志和示例。
  • 如需查看常用命令和关键概念的列表，请参阅 gcloud CLI 备忘单。
  • 使用 gcloud CLI 组件管理器安装其他组件，例如 App Engine 模拟器或 kubectl。