gcloud Installing Cloud SDK

https://cloud.google.com/sdk/gcloud/

gcloud 概览

本页面概况介绍了 gcloud 命令行工具及其常见命令模式和用法。

什么是 gcloud?

gcloud 是一种工具,它为 Google Cloud Platform 提供了主要的命令行界面。借助此工具,您可以通过命令行或在脚本和其他自动化功能中执行许多常见平台任务。

例如,您可以使用 gcloud 创建和管理以下内容:

  • Google Compute Engine 虚拟机实例和其他资源
  • Google Cloud SQL 实例
  • Google Kubernetes Engine 集群
  • Google Cloud Dataproc 集群和作业
  • Google Cloud DNS 托管地区和记录集
  • Google Cloud Deployment Manager 部署

您还可以使用 gcloud 来部署 App Engine 应用并执行其他任务。如需详细了解此工具的功能,请参阅 gcloud 参考

gcloud 和 SDK

gcloud 是 Google Cloud SDK 的一部分。您必须首先在系统中下载并安装 SDK初始化 SDK,然后才能使用 gcloud

默认情况下,SDK 仅安装处于“正式版”和“预览版”级别的 gcloud 命令。名为 alpha 和 beta 的 SDK 组件中提供了额外的功能。这些组件允许您将 gcloud 用于版本级别低于“正式版”的 Google Cloud Bigtable、Google Cloud Dataflow 以及 Cloud Platform 的其他组件。

gcloud 版本与 SDK 具有相同的版本号。当前 SDK 版本是 226.0.0。您可以从下载归档下载并安装 SDK 的先前版本。注意:Google Cloud Shell 中自动提供了 gcloud。如果您使用 Cloud Shell,则无需手动安装 gcloud 即可使用此工具。

下载 gcloud

您可以从下载页面下载最新版本的 Cloud SDK(包括 gcloud)。

版本级别

gcloud 命令具有以下版本级别:

版本级别标签说明
正式版命令被视为完全稳定,并且可以在生产环境中使用。对于那些破坏当前功能的命令,我们会提前发出警告,并会在版本说明中记录这些警告。
测试版beta命令在功能上是完整的,但可能仍然存在一些未解决的问题。我们可能会对这些命令做出重大更改,恕不另行通知。
Alpha 版alpha命令处于早期版本阶段,我们可能会对命令做出更改,恕不另行通知。
预览版preview命令可能不稳定,我们可能会对命令做出更改,恕不另行通知。

安装 SDK 时,系统默认不会安装 alpha 和 beta 组件。您必须使用 gcloud components install 命令单独安装这些组件。如果您尝试运行 alpha 版或测试版命令,并且您没有安装相应的组件,gcloud 将提示您安装该组件。

命令组

在每个版本级别中,gcloud 命令都会整理到一个由命令组构成的嵌套层次结构中,每个命令组都代表 Cloud Platform 或其子功能组的一个产品或功能。

例如:

命令组说明
gcloud compute与 Compute Engine 相关的命令(正式版)
gcloud compute instances与 Compute Engine 实例相关的命令(正式版)
gcloud beta compute与 Compute Engine 相关的命令(测试版)
gcloud alpha app与管理 App Engine 部署有关的命令(alpha 版)

运行 gcloud 命令

您可以像使用其他命令行工具一样,通过命令行运行 gcloud 命令。您还可以通过脚本和其他自动化功能运行 gcloud 命令,例如使用 Jenkins 自动执行 Cloud Platform 任务时运行这些命令。注意gcloud 参考文档和示例使用反斜杠 \ 表示长命令。您可以按原样执行这些命令(Windows 用户可以使用 ^ 代替 \)。如果您想移除反斜杠,请务必也移除换行符,以确保命令作为单一行读取。

属性

gcloud 属性是可对 gcloud 和其他 Cloud SDK 工具的行为产生影响的设置。您可以通过全局标志或命令标志设置其中一些属性 – 在这种情况下,系统将优先采用由标志设置的值。

请访问此处查看可用属性的列表。

配置

配置是一组指定的 gcloud 属性。它的工作原理从本质上类似于配置文件。

从 Cloud SDK 开始,您将使用一个名为 default 的配置,您可以通过运行 gcloud init 或 gcloud config set 来设置属性。这个单一的默认配置适用于大多数用例。

如果您想处理多个项目或使用多个授权帐号,您可以使用 gcloud config configurations create 设置多个配置并在这些配置之间进行相应切换。

如需查看这些概念的详细说明,请参阅这些与配置及其管理方式有关的探索内容。

全局标志

gcloud 提供了一组在整个 gcloud 范围内适用的标志,这些标志可对每次调用命令时的命令行为进行管理。标志会替换 SDK 属性中设置的值。

位置参数和标志

尽管位置参数和标志都会影响 gcloud 命令的输出结果,但它们的用例之间存在细微的差异。位置参数用于定义在其上运行命令的实体,同时需要使用标志来设置命令行为的变动。

使用 stdout 和 stderr

gcloud 命令的成功输出将被写入 stdout。所有其他类型的响应 – 提示、警告和错误 – 都会被写入 stderr。请注意,写入 stderr 的所有内容均不稳定,您不应针对这些内容编写脚本。

要查看与处理输出有关的准则清单,请参阅本章节

提示

为了防止操作造成意外损坏,gcloud 会在执行 gcloud projects delete 等命令之前确认您的意图。

如果您要使用 gcloud compute instances create test-instance 来创建 Google 计算引擎虚拟机实例(例如“test-instance”),则系统也会显示提示。系统将要求您选择创建的实例所在的地区。

要停用提示,请使用 --quiet 标志。

请注意,提示的用语可能会发生更改,您不应针对这些用语编写脚本。

禁止提示、对终端执行写入操作以及日志记录功能

gcloud 的 --quiet 标志(也可写作 -q)可停用运行 gcloud 命令时的所有互动提示,此功能在编写脚本时十分有用。在需要输入的情况下,系统将使用默认值。如果没有默认值,系统会出现错误。

要禁止在终端的标准输出和标准错误中显示命令输出,请使用 --no-user-output-enabled 标志。

要调整日志的详尽程度,请使用 --verbosity 标志并定义适当的级别。

确定输出结构

默认情况下,当 gcloud 命令返回资源列表时,这些资源将整齐显示到标准输出。为了生成更有意义的输出,您可以通过格式、过滤器和投影标志对输出进行微调。

如果您只想定义输出的格式,请使用 --format 标志来生成输出的表格式或展平版本(用于交互显示),或生成输出的机器可读版本(jsoncsvyamlvalue)。

要设置用于选择资源数据值的键列表的格式,请使用 projections。要进一步将输出结果细化为符合您想要定义的条件,请使用 filter

如果您想通过快速互动教程来帮助您熟悉过滤器和格式功能,请点击以下链接。

在 Cloud Shell 中打开

Leave a Reply

Your email address will not be published. Required fields are marked *