Google Cloud CLI 为每个受支持的平台提供安装程序,可以通过交互方式或非交互方式进行部署。
交互式安装
使用安装程序,您可以以交互模式下载、安装和设置最新版本的 Google Cloud CLI。当您运行安装程序时,它会下载 Google Cloud CLI 组件并将其安装在本地系统上。安装程序还会执行其他设置任务,例如,将 gcloud CLI 组件添加到 PATH 以及在 shell 中启用命令补全功能。
-
运行以下命令:
curl https://sdk.cloud.google.com | bash
- 出现提示时,请在文件系统中选择
google-cloud-sdk子目录的位置。默认值为您的主目录。 - 如需发送匿名使用情况统计信息以帮助改进 gcloud CLI,请在出现提示时回答
Y。 - 如需将 gcloud CLI 命令行工具添加到您的
PATH并启用命令补全功能,请在出现提示时回答Y。
- 出现提示时,请在文件系统中选择
-
重启 shell:
exec -l $SHELL
-
运行
gcloud init以初始化、授权和配置 gcloud CLI。
Windows 上的 Google Cloud CLI 需要 Windows 8.1 及更高版本或 Windows Server 2012 及更高版本。
-
或者,打开 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 CLI。 - 默认安装不包括使用
gcloud命令部署应用所必需的 App Engine 扩展程序。您可以使用 gcloud CLI 组件管理器安装这些组件。
问题排查提示
- 如果由于
find命令未被识别而导致安装失败,请确保您的PATH环境变量设置为将包含find的文件夹包括在内。通常,此文件夹为C:\WINDOWS\system32;。 - 如果您卸载了 gcloud CLI,则必须先重新启动系统,然后才能再次安装 gcloud CLI。
- 如果解压缩失败,请以管理员身份运行安装程序。
您还可以通过下载的 .zip 文件安装最新版本:
-
下载 google-cloud-sdk.zip 并解压缩。 (右键点击下载的文件,然后选择 全部解压缩 (Extract All)。)
-
启动
google-cloud-sdk\install.bat脚本并按照安装提示操作。 -
安装完成后,重启命令提示符 (
cmd.exe)。 -
运行
gcloud init:C:\> gcloud init
非交互式(静默)部署
您可以使用安装脚本自动执行 Google Cloud CLI 安装。
对于 Linux 和 MacOS:
将安装脚本保存在本地,而不是将其连接到 bash。
-
在命令提示符处输入以下内容:
curl https://sdk.cloud.google.com > install.sh
-
运行脚本,并按如下所示传递参数:
bash install.sh --disable-prompts
install.sh 选项包括:
--disable-prompts- 停用提示。--install-dir=DIRECTORY- 将安装根目录设置为DIRECTORY。Google Cloud CLI 已安装在DIRECTORY/google-cloud-sdk中。默认为 $HOME。
对于 Windows:
/S- 静默安装。不显示安装程序页面。可使用标志来更改安装设置。/D- 设置默认安装目录。它必须是命令行中所使用的最后一个参数,且不能包含任何引号,即便路径包含空格也是如此。仅支持绝对路径,例如/D=C:\CloudSDK/allusers- 为所有用户安装/singleuser- 为当前用户安装(默认)/screenreader- 开启屏幕阅读器模式(默认设置为关闭)/reporting- 启用使用情况报告(默认为关闭使用情况报告)/noreporting- 停用使用情况报告(默认为关闭使用情况报告)/nostartmenu- 不创建开始菜单快捷方式(默认为创建快捷方式)/nodesktop- 不创建桌面快捷方式(默认为创建快捷方式)