本页面介绍了如何安装和初始化 Google Cloud SDK,以及如何通过命令行运行核心 gcloud
命令。
准备工作
创建一个 Google Cloud 项目(如果您还没有的话)。
Cloud SDK 要求安装 Python。受支持的版本有 3.5 到 3.7 版本,以及 2.7.9 或更高版本。如需检查系统上安装的 Python 版本,请执行以下操作:
python -V
下载最适合您的操作系统的归档文件。 大多数机器都可运行 64 位软件包。如果您想检查确认,请运行
uname -m
以验证您是否运行 64 位系统。平台 软件包 大小 SHA256 校验和 Linux 64 位 (x86_64)
google-cloud-sdk-308.0.0-linux-x86_64.tar.gz 85.2 MB 9e8e31d9503340fc912374311ac1fffbfc5b59748d20b681f9aca3de2b68deb5 Linux 32 位 (x86)
google-cloud-sdk-308.0.0-linux-x86.tar.gz 83.4 MB 35f53087034296e9e0275e0e07cded6b9ae20a1535c07a96b6f00dc9bdaecc09 或者,要通过命令行下载 Linux 64 位归档文件,请运行以下命令:
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-308.0.0-linux-x86_64.tar.gz
对于 32 位归档文件,请运行以下命令:
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-308.0.0-linux-x86.tar.gz
将归档解压缩到文件系统上的任意位置;最好是解压缩到您的主文件夹。在 Linux 中,您可以通过运行以下命令来解压缩归档文件:
tar zxvf [ARCHIVE_FILE] google-cloud-sdk
可选 :使用安装脚本将 Cloud SDK 工具添加至您的路径。您还可以在安装过程中选择为您的bash
shell 启用命令补全功能以及选择开启 使用情况统计信息收集功能。使用以下命令运行脚本:./google-cloud-sdk/install.sh
重新启动终端以使更改生效。
或者,在解压缩下载的归档文件后,您可以通过完整路径来调用 Cloud SDK 的可执行文件,从而调用该 SDK。
初始化 SDK
使用 gcloud init
命令可执行一些常见的 SDK 设置任务,其中包括授权 SDK 工具使用您的用户帐号凭据访问 Google Cloud 以及设置默认的 SDK 配置。
要初始化 SDK,请执行以下操作:
在命令提示符处运行以下命令:
gcloud init
问题排查提示:如果遇到与未找到的
gcloud
命令相关的错误,请运行./google-cloud-sdk/install.sh
以使用安装脚本;它会将 Cloud SDK 工具添加到PATH
。重启终端以使更改生效。接受使用您的 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:
如果您启用了 Google 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
可确认您已成功完成设置步骤:gcloud has now been configured! You can use [gcloud config] to change more gcloud settings. Your active configuration is: [default]
(可选)如果您想要获得更精简的屏幕阅读器体验,gcloud 命令行工具会附带
accessibility/screen_reader
属性。如需启用此属性,请运行以下命令:
gcloud config set accessibility/screen_reader true
如需详细了解 gcloud 命令行工具附带的无障碍功能,请参阅 启用无障碍功能 指南。
运行核心 gcloud 命令
运行以下 gcloud
命令可查看您安装的 SDK 的相关信息:
如需列出其凭据存储在本地系统上的帐号,请运行以下命令:
gcloud auth list
gcloud
会显示存储了凭据的帐号列表:Credentialed Accounts ACTIVE ACCOUNT * example-user-1@gmail.com example-user-2@gmail.com
如需列出您的活跃 SDK 配置中的属性,请运行以下命令:
gcloud config list
gcloud
会显示属性列表:[core] account = example-user-1@gmail.com disable_usage_reporting = False project = example-project
要查看您的 Cloud SDK 安装实例和活动 SDK 配置的相关信息,请运行以下命令:
gcloud info
gcloud
会显示您安装的 Cloud SDK 的相关信息摘要。其中包括与系统、已安装的 SDK 组件、活动用户帐号、当前项目以及活动 SDK 配置中的属性有关的信息。如需通过命令行查看有关
gcloud
命令和其他主题的信息,请运行以下命令:gcloud help
例如,如需查看
gcloud compute instances create
的帮助信息,请运行以下命令:gcloud help compute instances create
gcloud
会显示一个帮助主题,其中包含该命令的说明、命令标志和参数的列表以及关于如何使用该命令的示例。
后续步骤
- 请参阅
gcloud
工具指南,以大致了解gcloud
命令行工具,其中包括关键概念的简单介绍、命令格式约定,以及实用提示。 - 请参阅
gcloud
参考指南,以查看可用来在 Google Cloud 上执行各项任务的每个gcloud
命令的相关详情页面,其中包括说明、标志和示例。 - 如需查看常用命令和关键概念的列表,请参阅 gcloud 命令行工具备忘单。
- 使用 Cloud SDK 组件管理器 安装其他组件,例如 App Engine 模拟器或
kubectl
。