安装 Google Cloud CLI
本快速入门将指导您安装和初始化 Google Cloud CLI 并运行一些核心 gcloud CLI 命令。
如需在 Google Cloud 控制台中直接遵循有关此任务的分步指导,请点击操作演示:
准备工作
- 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手,请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
完成本文档中描述的任务后,您可以通过删除所创建的资源来避免继续计费。如需了解详情,请参阅清理。
安装最新的 gcloud CLI 版本 (488.0.0)
- 确认您拥有受支持的 Python 版本。Google Cloud CLI 需要 Python 3.8 到 3.12。请注意,x86_64 Linux 软件包中包含默认首选的捆绑式 Python 解释器。如需了解如何选择和配置 Python 解释器,请参阅
gcloud topic startup
。 - 下载以下内容之一:
平台 软件包名称 大小 SHA256 校验和 Linux 64 位 (x86_64)
google-cloud-cli-linux-x86_64.tar.gz 130.3 MB 29e19b666935c05f81862324fbbda3d798a49909606b45512f732ae642553759 Linux 64 位 (Arm)
google-cloud-cli-linux-arm.tar.gz 52.7 MB 36e3c4e47cec39a4cf0e85aa156f7c61f096db6b698d644a2ef4b48c4210f19d Linux 32 位 (x86)
google-cloud-cli-linux-x86.tar.gz 52.7 MB 87cec76678aa9fe8ee28846c4c9ba4413036620eec72db38856d6e24c49e338a 如需下载 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 添加到路径中。使用以下命令从解压缩到的文件夹的根目录运行安装脚本:
./google-cloud-sdk/install.sh
也可以通过提供偏好设置作为标志以非交互方式(例如使用脚本)完成此操作。如需查看可用标志,请运行以下命令:./google-cloud-sdk/install.sh --help
可选:- 如需发送匿名使用情况统计信息以帮助改进 gcloud CLI,请在出现提示时回答
Y
。 - 如需将 gcloud CLI 添加到您的
PATH
并启用命令补全功能,请在出现提示时回答Y
。
- 如需发送匿名使用情况统计信息以帮助改进 gcloud CLI,请在出现提示时回答
- 打开新终端,以使更改生效。
- 如需初始化 gcloud CLI,请运行
gcloud init
: - 可选:使用组件管理器安装其他组件。
./google-cloud-sdk/bin/gcloud init
软件包内容
对于 Debian 和 Ubuntu 系统,可以通过软件包格式的 gcloud CLI 进行安装。此软件包仅包含 gcloud
、gcloud alpha
、gcloud beta
、gsutil
、和 bq
命令,而不包括 kubectl
或使用 gcloud
命令部署应用所需的 App Engine 扩展程序。如果您需要这些组件,则必须单独安装。
在安装 gcloud CLI 之前,请确保您的操作系统满足以下要求:
- 这是尚未达到服务终止期限的 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 | sudo 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 版本
如需还原到特定版本的 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 33 和 34 以及 CentOS 7 和 CentOS 8 系统,可以通过软件包格式的 gcloud CLI 进行安装。此软件包仅包含 gcloud
、gcloud alpha
、gcloud beta
、gsutil
、和 bq
命令,而不包括 kubectl
或使用 gcloud
命令部署应用所需的 App Engine 扩展程序,您可以按照本部分稍后所述的方法单独安装。
- 使用 gcloud CLI 仓库信息更新 DNF。以下示例命令适用于与 Red Hat Enterprise Linux 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
-
如果您要在 Fedora 34 或 35 上安装,请安装
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
降级 gcloud CLI 版本
如果您想还原到特定版本的 gcloud CLI(其中 VERSION
的格式为 123.0.0
),请运行 sudo dnf downgrade google-cloud-cli-VERSION
。仓库中始终提供最新的十个版本。注意:对于 371.0.0 之前的版本,该软件包名称为 google-cloud-sdk
- 确认您拥有受支持的 Python 版本:
-
如需查看当前的 Python 版本,请运行
python3 -V
或python -V
。支持的版本是 Python 3.8 到 3.12。 - 主安装脚本可安装 CPython 的 Python 3.11。
- 否则,如需安装支持的 Python 版本,请访问 Python.org 适用于 macOS 的 Python 版本。
- 如果您的机器上安装了多个 Python 解释器,请在 shell 中设置 CLOUDSDK_PYTHON 环境变量,使其指向首选解释器的路径。
-
如需详细了解如何选择和配置 Python 解释器,请参阅
gcloud topic startup
。
-
如需查看当前的 Python 版本,请运行
- 下载以下内容之一:
-
将归档解压缩到文件系统上的任意位置(最好是解压缩到您的主目录)。在 macOS 上,此操作可通过打开下载到首选位置的
.tar.gz
归档文件来实现。如需替换现有安装,请移除现有的
google-cloud-sdk
目录,然后将归档解压缩到同一位置。 - (可选)使用安装脚本将 gcloud CLI 工具添加到您的
PATH
。您还可以选择为 shell 启用命令补全功能、使用情况统计信息收集功能,并安装 Python 3.11。使用以下命令运行脚本(从您在上一步中解压缩的文件夹的根目录运行):
./google-cloud-sdk/install.sh
This can also be done non-interactively (for example, using a script) by providing preferences as flags. To describe the available flags, run:./google-cloud-sdk/install.sh --help
To run the install script with screen reader mode on:./google-cloud-sdk/install.sh --screen-reader=true
Open a new terminal so that the changes take effect. -
To initialize the gcloud CLI, run
gcloud init
: - Optional. Install additional components using the component manager.
平台 | 软件包 | 大小 | SHA256 校验和 |
---|---|---|---|
macOS 64 位
(x86_64) |
google-cloud-cli-darwin-x86_64.tar.gz | 52.8 MB | d9b947600e67350f86edd28b97bed7b98ab4f5076bea9b9b4b8717284a819d2a |
macOS 64 位
(ARM64, Apple M1 silicon) |
google-cloud-cli-darwin-arm.tar.gz | 52.7 MB | 487296f593a775ebefd12e9f127e9b15244bb2ddca9ad750e0a7e7f29396038e |
macOS 32 位
(x86) |
google-cloud-cli-darwin-x86.tar.gz | 51.5 MB | f2797a434a7cb4060ca86de2f0a3cda683e70d84bff20b643e90891c4005bfae |
./google-cloud-sdk/bin/gcloud init
-
The Google Cloud CLI works on Windows 8.1 and later and Windows Server 2012 and later.
-
Download the Google Cloud CLI installer.
Alternatively, open a PowerShell terminal and run the following PowerShell commands:
(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.8 到 3.12。默认情况下,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 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:
gcloud init
接受使用您的 Google 用户账号进行登录的选项:
To continue, you must log in. Would you like to log in (Y/n)? Y
在浏览器中,根据提示登录您的 Google 用户账号,然后点击允许以授权访问 Google Cloud 资源。
在命令提示符处,从列表中选择一个 Google Cloud 项目 拥有 Owner、Editor 或 Viewer 权限的项目数量:
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 CLI 安装的信息:
列出其凭据存储在本地系统上的账号:
gcloud auth list
gcloud CLI 会显示存储了凭据的账号的列表:
Credentialed Accounts ACTIVE ACCOUNT * [email protected] [email protected]
列出活跃 gcloud CLI 配置中的属性:
gcloud config list
gcloud CLI 会显示属性列表:
[core] account = [email protected] disable_usage_reporting = False project = example-project
查看有关您的 gcloud CLI 安装和活跃 配置:
gcloud info
gcloud CLI 会显示 安装。其中包括与系统、已安装的组件、活动用户账号、当前项目以及活动配置中的属性有关的信息。
查看有关
gcloud
命令和其他主题的信息:gcloud help
例如,如需查看
gcloud compute instances create
的帮助信息,请运行以下命令:gcloud help compute instances create
gcloud CLI 会显示一个帮助主题,其中包含 命令说明、命令标志和参数列表;以及 示例,了解如何使用命令。
清理
为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用,请按照以下步骤操作。
- 在 Google Cloud 控制台中,进入管理资源页面。
- 在项目列表中,选择要删除的项目,然后点击删除。
- 在对话框中输入项目 ID,然后点击关闭以删除项目。
后续步骤
- 如需简要了解以下内容,请参阅 gcloud CLI 指南 gcloud CLI,其中包括关键 概念、命令规范和实用提示
- 阅读 gcloud CLI 参考指南 了解每个 gcloud CLI 命令的详细信息,包括 说明、标志和示例,可用于对 Google Cloud 上执行任务。
- 请参阅 gcloud CLI 备忘单 查看常用命令和关键概念的列表。
- 安装其他组件,例如 App Engine 模拟器或
kubectl
(使用 gcloud CLI 组件管理器。