gcloud 命令行工具备忘单

gcloud 备忘单

gcloud 工具(Google Cloud 的主要命令行工具)的 go-to gcloud 命令名单。

其中还包括:入门介绍了解命令可打印的 PDF

备忘单

开始

开始使用 gcloud 命令行工具。

帮助

Cloud SDK 很乐意提供帮助。

  • gcloud help:在 gcloud 工具参考文档中搜索专用条款。
  • gcloud feedback:为 Cloud SDK 团队提供反馈。
  • gcloud topic:针对非命令主题(如可访问性,过滤和格式化功能)的补充性帮助材料。

个性化

打造您自己的 Cloud SDK;使用属性对配置进行个性化。

凭据

授予和撤消 Cloud SDK 的授权

项目

管理项目访问权限政策

Identity & Access Management

配置 Cloud Identity & Access Management (IAM) 偏好设置和服务帐号

Docker 和 Google Kubernetes Engine (GKE)

在 Kubernetes 上管理容器化应用

虚拟机和 Compute Engine

在 Google 基础架构上创建、运行和管理虚拟机

无服务器和 App Engine

在全托管式的无服务器平台上构建可伸缩性极强的应用

其他

可供您使用的命令

入门介绍

快速入门:开始使用 gcloud 命令行工具。

安装 Cloud SDK

按照这些安装说明安装 Cloud SDK。

标志、参数和其他奇妙添加项

参数可以是位置参数或标志

  • 位置参数:在命令名称后设置;必须遵循位置参数的顺序。
  • 标志:在位置参数之后设置;标志的顺序无关紧要。

    标志可以是:

    • 名称/值对 (--foo=bar),或
    • Boolean (--force/no-force).

    此外,标志还可以是:

    • 必需
    • 可选:在这种情况下,如果未定义标志,则使用默认值

全局标志

某些标志适用于整个 gcloud 命令行工具体验,例如:

  • --help:如果不确定;请显示命令的详细帮助。
  • --project:如果使用在当前项目之外的项目。
  • --quiet:停用交互式提示(并为输入应用默认值)。
  • --verbosity:可以将详尽程度设置为 debuginfowarningerrorcriticalnone
  • --version:显示 gcloud 版本信息。
  • --format:将输出格式设置为 configcsvdefaultdiffdisableflattenedgetjsonlistmultinoneobjecttabletextvalueyaml

清理结果

使用过滤条件、格式、限制和排序依据标志从输出中提取最多内容。

对于前缀为 us 而非机器类型 f1-micro 的 Compute Engine 实例:

gcloud compute instances list --filter="zone ~ ^us AND -machineType:f1-micro"

对于在 2018 年 1 月 15 日当天或之后创建的项目列表,项目按时间顺序(由早到晚)排序并作为表格提供,其中包含项目编号、项目 ID 以及创建时间这几列(日期和时间以本地时区表示):

gcloud projects list --format="table(projectNumber,projectId,createTime.date(tz=LOCAL))"
--filter="createTime>=2018-01-15T12:00:00" --sort-by=createTime

如需查看标签为 my-label(任意值)的 10 个 Compute Engine 实例列表:

gcloud compute instances list --filter="labels.my-label:*" --limit=10

了解命令

gcloud 命令的底层模式;帮助用户找到命令。

查找 gcloud 命令

gcloud 命令行工具是一个树状结构;非叶节点是命令组,叶节点是命令。(此外,Tab 键自动补全功能也适用于命令和资源!)

大多数 gcloud 命令都采用以下格式:

gcloud + release level (optional) + component + entity + operation + positional args + flags

例如:gcloud + compute + instances + create + example-instance-1 + --zone=us-central1-a

版本级别

版本级别是指命令的版本状态。

示例:Alpha 版命令的版本级别为 alpha,Beta 版命令的版本级别为 beta,GA 命令不需要版本级别。

组件

组件是指不同的 Google Cloud 服务。

示例:Compute Engine 的组件为 compute,App Engine 的组件 app 等等。

实体

实体是指元件下复数形式的元素或元素集合。

示例:计算的实体是 disksfirewallsimagesinstancesregionszones

操作

操作是指要对实体执行的操作的命令式动词形式。

示例:常见操作包括 describelistcreate/updatedelete/clearimportexportcopyremoveaddresetrestartrestorerundeploy

位置参数

位置参数是指执行命令所需的必要顺序参数。

示例<INSTANCE_NAMES>gcloud compute instances create 所需的位置参数。

标志

标志是指传递给命令且位于位置参数之后的其他参数 --flag-name(=value)

示例--machine-type=<MACHINE_TYPE>--preemptiblegcloud compute instances create 的可选标志。