gcloud CLI 备忘单

Google Cloud 的主要命令行工具 Google Cloud CLI 的参考命令清单。

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

备忘单

使用入门

开始使用 gcloud CLI。

帮助

gcloud CLI 非常乐意为您提供帮助。

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

个性化

构建您自己的 gcloud CLI;通过属性对您的配置进行个性化设置。

授权和凭据

授予和撤消对 gcloud CLI 的授权,以及管理凭据。

项目

管理项目访问权限政策。

IAM

配置 Identity and Access Management (IAM) 偏好设置和服务账号。

Docker 和 Google Kubernetes Engine (GKE)

在 Kubernetes 上管理容器化应用。

虚拟机和 Compute Engine

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

无服务器和 App Engine

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

其他

可供您使用的命令

入门介绍

gcloud CLI 快速入门。

安装 Google Cloud CLI

按照这些安装说明安装 Google Cloud CLI。

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

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

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

    标志可以是:

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

    此外,标志还可以是:

    • 必需
    • 可选:如果未定义可选标志,则使用默认值

全局标志

有些标志在整个 gcloud CLI 体验中都可用, 例如:

  • --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 CLI 命令的底层模式;可帮助用户自行查找命令。

查找 gcloud CLI 命令

gcloud CLI 是一个树状结构非叶节点是命令组 和叶节点是命令 (此外,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 的可选标志。