安装 Google Cloud CLI
本快速入门将指导您安装和初始化 Google Cloud CLI,以及运行几个核心 gcloud CLI 命令。
如需在 Google Cloud 控制台中直接遵循有关此任务的分步指导,请点击操作演示:
准备工作
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
- 
    
    
      
        In the Google Cloud console, on the project selector page, select or create a Google Cloud project. Roles required to select or create a project - Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- 
      Create a project: To create a project, you need the Project Creator
      (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
 
- 
  
    Verify that billing is enabled for your Google Cloud project. 
- 
    
    
      
        In the Google Cloud console, on the project selector page, select or create a Google Cloud project. Roles required to select or create a project - Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- 
      Create a project: To create a project, you need the Project Creator
      (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
 
- 
  
    Verify that billing is enabled for your Google Cloud project. 
- 确认您拥有受支持的 Python 版本。Google Cloud CLI 需要 Python 3.9 到 3.14。请注意,x86_64 Linux 软件包中包含默认首选的捆绑式 Python 解释器。如需了解如何选择和配置 Python 解释器,请参阅 gcloud topic startup。
- 下载以下内容之一:平台 软件包名称 大小 SHA256 校验和 Linux 64 位 (x86_64) google-cloud-cli-linux-x86_64.tar.gz 150.5 MB 31000673c1f9e18ec7b38823748031c58949cb0479d36ede999ae8cad6097ae3 Linux 64 位 (Arm) google-cloud-cli-linux-arm.tar.gz 57.1 MB a1c1a88274e8bf11561771b9373b566cbb044f1cb3884e454625ec9449ea33f2 Linux 32 位 (x86) google-cloud-cli-linux-x86.tar.gz 57.1 MB 32ff2bea65cd5c79aa86b948219c1e861a0434cc99011f4d977c4a9810e595de 如需下载 Linux 归档文件,请运行以下命令: curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz 请参阅上表并将 google-cloud-cli-linux-x86_64.tar.gz 替换为适用于您的配置的 *.tar.gz软件包名称。
- 如需将文件内容解压缩到文件系统(最好是解压缩到您的主目录),请运行以下命令:tar -xf google-cloud-cli-linux-x86_64.tar.gz google-cloud-sdk目录,然后将归档解压缩到同一位置。
- (可选)将 gcloud CLI 添加到 PATH。 您还可以选择为您的 shell 启用命令补全功能以及选择启用使用情况统计信息收集功能。使用以下命令(从您在上一步中解压缩的文件夹的根目录)运行安装脚本:./google-cloud-sdk/install.sh ./google-cloud-sdk/install.sh --help- 如需发送匿名使用情况统计信息以帮助改进 gcloud CLI,请在出现提示时回答 Y。
- 
        如需将 gcloud CLI 添加到您的 PATH并启用命令补全功能,请在出现提示时回答Y。
 
- 如需发送匿名使用情况统计信息以帮助改进 gcloud CLI,请在出现提示时回答 
- 如果您在上一步中更新了 PATH,请打开一个新终端,让更改生效。
- 如需初始化 gcloud CLI,请运行 gcloud init:
- 可选:使用组件管理器安装其他组件。
- 这是尚未达到服务终止期限的 Ubuntu 版本或尚未达到服务终止期限的 Debian 稳定版本
- 它最近更新了其软件包:sudo apt-get update 
- 它安装了 apt-transport-https和curl:sudo apt-get install apt-transport-https ca-certificates gnupg curl 
- 导入 Google Cloud 公钥。
    - 对于较新的发行版(Debian 9+ 或 Ubuntu 18.04+),请运行以下命令: - curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg 
-  对于较旧的发行版,请运行以下命令:
      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add - 
- 如果您的发行版的 apt-key 命令不支持 - --keyring参数,请运行以下命令:- curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add - 
- 如果您由于密钥过期而无法获取最新更新,请获取最新的 apt-get.gpg 密钥文件。 
 
- 添加 gcloud CLI 发行版 URI 作为软件包源。
  - 对于较新的发行版(Debian 9+ 或 Ubuntu 18.04+),请运行以下命令:
    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 
- 对于不支持 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 
 
- 对于较新的发行版(Debian 9+ 或 Ubuntu 18.04+),请运行以下命令:
    
- 更新并安装 gcloud CLI:sudo apt-get update && sudo apt-get install google-cloud-cli apt-get选项(例如停用提示或试运行),请参阅apt-get手册页面。Docker 提示:如果安装 Docker 映像中的 gcloud CLI,请改用单个 RUN 步骤: RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://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 | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y gpg --dearmor命令的旧基础映像:RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://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-cli -y 
- (可选)安装以下任何其他组件:- google-cloud-cli
- google-cloud-cli-anthos-auth
- google-cloud-cli-app-engine-go
- google-cloud-cli-app-engine-grpc
- google-cloud-cli-app-engine-java
- google-cloud-cli-app-engine-python
- google-cloud-cli-app-engine-python-extras
- google-cloud-cli-bigtable-emulator
- google-cloud-cli-cbt
- google-cloud-cli-cloud-build-local
- google-cloud-cli-cloud-run-proxy
- google-cloud-cli-config-connector
- google-cloud-cli-datastore-emulator
- google-cloud-cli-firestore-emulator
- google-cloud-cli-gke-gcloud-auth-plugin
- google-cloud-cli-kpt
- google-cloud-cli-kubectl-oidc
- google-cloud-cli-local-extract
- google-cloud-cli-minikube
- google-cloud-cli-nomos
- google-cloud-cli-pubsub-emulator
- google-cloud-cli-skaffold
- google-cloud-cli-spanner-emulator
- google-cloud-cli-terraform-validator
- google-cloud-cli-tests
- kubectl
 例如, google-cloud-cli-app-engine-java组件可以按以下方式安装:sudo apt-get install google-cloud-cli-app-engine-java 
- 运行 gcloud init以开始执行初始化操作:gcloud init
- 使用 gcloud CLI 仓库信息更新 DNF。- 
        以下示例命令适用于与 Red Hat Enterprise Linux 7、8 或 9 兼容的安装,但请务必根据您的配置的需要更新设置: sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM [google-cloud-cli] name=Google Cloud CLI baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=0 gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM 
- 
        对于与 RHEL 10 兼容的安装,请使用以下命令以及更新后的 gpgkey:sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM [google-cloud-cli] name=Google Cloud CLI baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=0 gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg EOM 
 
- 
        
- 
    安装 libxcrypt-compat.x86_64。sudo dnf install libxcrypt-compat.x86_64 
- 安装 gcloud CLI:sudo dnf install google-cloud-cli 
- (可选)安装以下任何其他组件:- google-cloud-cli
- google-cloud-cli-anthos-auth
- google-cloud-cli-app-engine-go
- google-cloud-cli-app-engine-grpc
- google-cloud-cli-app-engine-java
- google-cloud-cli-app-engine-python
- google-cloud-cli-app-engine-python-extras
- google-cloud-cli-bigtable-emulator
- google-cloud-cli-cbt
- google-cloud-cli-cloud-build-local
- google-cloud-cli-cloud-run-proxy
- google-cloud-cli-config-connector
- google-cloud-cli-datastore-emulator
- google-cloud-cli-firestore-emulator
- google-cloud-cli-gke-gcloud-auth-plugin
- google-cloud-cli-kpt
- google-cloud-cli-kubectl-oidc
- google-cloud-cli-local-extract
- google-cloud-cli-minikube
- google-cloud-cli-nomos
- google-cloud-cli-pubsub-emulator
- google-cloud-cli-skaffold
- google-cloud-cli-spanner-emulator
- google-cloud-cli-terraform-validator
- google-cloud-cli-tests
- kubectl
 例如, google-cloud-cli-app-engine-java组件可以按以下方式安装:sudo dnf install google-cloud-cli-app-engine-java 
- 运行 gcloud init以开始执行初始化操作:gcloud init
- 确认您拥有受支持的 Python 版本:- 
        如需查看当前的 Python 版本,请运行 python3 -V或python -V。支持的版本是 Python 3.9 到 3.14。
- 
        主安装脚本可安装 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。
 
- 
        如需查看当前的 Python 版本,请运行 
- 下载以下内容之一:
- 
    将归档解压缩到文件系统上的任意位置(最好是解压缩到您的主目录)。在 macOS 上,此操作可通过打开下载到首选位置的 .tar.gz归档文件来实现。 或者,运行以下命令:tar -xf google-cloud-cli-darwin-arm.tar.gz 可选:如需替换现有安装,请移除现有的 google-cloud-sdk目录,然后将归档解压缩到同一位置。
- 使用以下命令(从您在上一步中解压缩的文件夹的根目录)运行安装脚本:
    ./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。
 
- 如需发送匿名使用情况统计信息以帮助改进 gcloud CLI,请在出现提示时回答 
- 如果您在上一步中更新了 PATH,请打开一个新终端,让更改生效。
- 
    如需初始化 gcloud CLI,请运行 gcloud init:
- 可选。使用组件管理器安装其他组件。
- 
    
    或者,打开 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 
- 
    启动安装程序并按提示操作。安装程序已经过 Google LLC 签名。 如果您使用的是屏幕阅读器,请选中启用屏幕阅读器模式复选框。此选项会将 gcloud配置为使用状态跟踪器而不是 Unicode 旋转图标,以百分比表示显示进度和展开的表。如需了解详情,请参阅无障碍功能指南。
- 
    Google Cloud CLI 要求安装 Python;受支持的版本是 Python 3.9 到 3.14。默认情况下,Windows 版本的 Google Cloud CLI 捆绑了 Python 3。如需使用 Google Cloud CLI,您的操作系统必须能够运行受支持的 Python 版本。 安装程序会安装所有必需的依赖项(包括所需的 Python 版本)。虽然 Google Cloud CLI 默认安装和管理 Python 3,但您可以根据需要通过取消选中“安装捆绑的 Python”选项来使用已安装的 Python。请参阅 gcloud topic startup,了解如何使用现有 Python 安装。
- 安装完成后,安装程序会为您提供创建开始菜单和桌面快捷方式、启动 Google Cloud CLI shell 以及配置 gcloud CLI 的选项。确保已选择用于启动 shell 并配置安装的选项。安装程序会启动终端窗口并运行 - gcloud init命令。
- 默认安装不包括使用 gcloud命令部署应用所必需的 App Engine 扩展程序。您可以使用 gcloud CLI 组件管理器安装这些组件。
- 如果由于 find命令未被识别而导致安装失败,请确保您的PATH环境变量设置为将包含find的文件夹包括在内。通常,此文件夹为C:\WINDOWS\system32;。
- 如果您卸载了 gcloud CLI,则必须先重新启动系统,然后才能再次安装 gcloud CLI。
- 如果解压缩失败,请以管理员身份运行安装程序。
- 在 Chromebook 上启用 Linux 功能。 在 Chromebook 上安装 Google Cloud CLI 需要此功能。
- 添加 gcloud CLI 发行版 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 
- 导入 Google Cloud 公钥:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add - 
- 更新并安装 gcloud CLI:sudo apt-get update && sudo apt-get install google-cloud-cli 
- (可选)安装以下任何其他组件:- google-cloud-cli
- google-cloud-cli-anthos-auth
- google-cloud-cli-app-engine-go
- google-cloud-cli-app-engine-grpc
- google-cloud-cli-app-engine-java
- google-cloud-cli-app-engine-python
- google-cloud-cli-app-engine-python-extras
- google-cloud-cli-bigtable-emulator
- google-cloud-cli-cbt
- google-cloud-cli-cloud-build-local
- google-cloud-cli-cloud-run-proxy
- google-cloud-cli-config-connector
- google-cloud-cli-datastore-emulator
- google-cloud-cli-firestore-emulator
- google-cloud-cli-gke-gcloud-auth-plugin
- google-cloud-cli-kpt
- google-cloud-cli-kubectl-oidc
- google-cloud-cli-local-extract
- google-cloud-cli-minikube
- google-cloud-cli-nomos
- google-cloud-cli-pubsub-emulator
- google-cloud-cli-skaffold
- google-cloud-cli-spanner-emulator
- google-cloud-cli-terraform-validator
- google-cloud-cli-tests
- kubectl
 例如, google-cloud-cli-app-engine-java组件可以按以下方式安装:sudo apt-get install google-cloud-cli-app-engine-java 
- 运行 gcloud init以开始执行初始化操作:gcloud init
- 初始化 gcloud CLI: - gcloud init
- 接受使用您的 Google 用户账号进行登录的选项: - To continue, you must log in. Would you like to log in (Y/n)? Y 
- 在浏览器中,根据提示登录您的 Google 用户账号,然后点击允许以授权访问 Google Cloud 资源。 
- 在命令提示符处,从您拥有所有者、编辑者或查看者权限的项目列表中选择一个 Google 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: 
- 如果您启用了 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. 
- (可选)如需改善屏幕阅读器体验,请启用 - accessibility/screen_reader属性:- gcloud config set accessibility/screen_reader true- 如需详细了解 gcloud CLI 附带的无障碍功能,请参阅启用无障碍功能指南。 
- 列出其凭据存储在本地系统上的账号: - gcloud auth list- gcloud CLI 会显示存储了凭据的账号的列表: - Credentialed Accounts ACTIVE ACCOUNT * example-user-1@example.com example-user-2@example.com
- 列出活跃 gcloud CLI 配置中的属性: - gcloud config list- gcloud CLI 会显示属性列表: - [core] account = example-user-1@example.com disable_usage_reporting = False project = example-project 
- 查看有关 - gcloud命令和其他主题的信息:- gcloud help- 例如,如需查看 - gcloud compute instances create的帮助信息,请运行以下命令:- gcloud help compute instances create- gcloud CLI 会显示一个帮助主题,其中包含该命令的说明、命令标志和参数的列表以及关于如何使用该命令的示例。 
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
- 请参阅 gcloud CLI 指南,以大致了解 gcloud CLI,其中包括关键概念的简单介绍、命令格式约定,以及实用提示。
- 请参阅 gcloud CLI 参考指南,以查看可用于在 Google Cloud上执行各项任务的每个 gcloud CLI 命令的详情页面,其中包括说明、标志和示例。
- 如需查看常用命令和关键概念的列表,请参阅 gcloud CLI 备忘单。
- 使用 gcloud CLI 组件管理器安装其他组件,例如 App Engine 模拟器或 kubectl。
完成本文档中描述的任务后,您可以通过删除所创建的资源来避免继续计费。如需了解详情,请参阅清理。
安装最新的 gcloud CLI 版本 (543.0.0)
./google-cloud-sdk/bin/gcloud init软件包内容
  对于 Debian 和 Ubuntu 系统,可以通过软件包格式的 gcloud CLI 进行安装。此软件包仅包含 gcloud、gcloud alpha、gcloud beta、gsutil、和 bq 命令,而不包括 kubectl 或使用 gcloud 命令部署应用所需的 App Engine 扩展程序。如果您需要这些组件,则必须单独安装。
在安装 gcloud CLI 之前,请确保您的操作系统满足以下要求:
降级 gcloud CLI 版本
如需还原到特定版本的 gcloud CLI(其中 VERSION 为 123.0.0 形式),请运行以下命令:
sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0
仓库中始终提供最新的十个版本。
注意:对于 371.0.0 之前的版本,该软件包名称为 google-cloud-sdk
软件包内容
  对于 Red Hat Enterprise Linux 7、8 和 9、Fedora 41 和 42 以及 CentOS 7 和 CentOS 8 系统,可以通过软件包格式的 gcloud CLI 进行安装。此软件包仅包含 gcloud、gcloud alpha、gcloud beta、gsutil、和 bq 命令,而不包括 kubectl 或使用 gcloud 命令部署应用所需的 App Engine 扩展程序,您可以按照本部分稍后所述的方法单独安装。
降级 gcloud CLI 版本
如果您想还原到特定版本的 gcloud CLI(其中 VERSION 的格式为 123.0.0),请运行 sudo dnf downgrade google-cloud-cli-VERSION。仓库中始终提供最新的十个版本。注意:对于 371.0.0 之前的版本,该软件包名称为 google-cloud-sdk
| 平台 | 软件包 | 大小 | SHA256 校验和 | 
|---|---|---|---|
| macOS 64 位 (x86_64) | google-cloud-cli-darwin-x86_64.tar.gz | 57.2 MB | b24a11aa4f1816bff3122b3560c909c1eb7109bf8979821251d8bc5679582f10 | 
| macOS 64 位 (ARM64, Apple silicon) | google-cloud-cli-darwin-arm.tar.gz | 57.1 MB | b4d2b8b63593ad226cf1c4da0667ffa4a9cb923bd41ec269e67891491aeb126a | 
| macOS 32 位 (x86) | google-cloud-cli-darwin-x86.tar.gz | 55.7 MB | 6e66bdc92029fd3a3856e6a9bc03f2799079184ff3fe436c7ade1ef1a8f03452 | 
./google-cloud-sdk/bin/gcloud init- 
  Google Cloud CLI 可在 Windows 8.1 及更高版本和 Windows Server 2012 及更高版本上运行。
降级 gcloud CLI 版本
如需还原到特定版本的 gcloud CLI(其中 VERSION 为 123.0.0 形式),请运行以下命令:
sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0
仓库中始终提供最新的十个版本。
注意:对于 371.0.0 之前的版本,该软件包名称为 google-cloud-sdk
可选:安装最新的 Cloud 客户端库
您可以为支持的语言下载 Cloud 客户端库。
初始化 gcloud CLI
使用 gcloud init 命令执行几个常见的 gcloud CLI 设置任务。其中包括授权 gcloud CLI 使用您的用户账号凭据访问 Google Cloud 以及设置默认配置。
运行核心命令
运行核心命令以查看有关您的 gcloud CLI 安装的信息:
清理
为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用,请按照以下步骤操作。