管理 gcloud CLI 组件

组件是 Google Cloud CLI 的可安装部分。组件可以是命令行工具(gcloudbqgsutil)、一组处于 Alpha 版或 Beta 版版本级别的 gcloud CLI 命令,也可以是包含 gcloud CLI 中工具所用依赖项的软件包。

系统会默认安装最常用的组件。如果您以交互方式运行 gcloud alphagcloud beta 命令并且未安装 alphabeta 组件,则 gcloud CLI 会询问您是否要安装该组件。如果您给予肯定答复,则系统会安装该组件,然后运行该命令。当您运行需要其他组件的命令时,gcloud CLI 会按需安装这些组件。

自行试用

如果您是 Google Cloud 新手,请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。

免费开始使用

默认组件

安装 gcloud CLI 时,默认情况下会安装以下组件:

ID 名称 说明
gcloud 默认的 gcloud CLI 命令 用于与 Google Cloud 进行交互的工具。只有“正式版”和“预览版”版本级别的命令才会随同该组件一起安装。如果您想使用处于其他版本级别的命令,您必须单独安装 gcloud alpha 命令和/或 gcloud beta 命令组件。
bq BigQuery 命令行工具 用于处理 BigQuery 中的数据的工具
gsutil Cloud Storage 命令行工具 用于执行 Cloud Storage 的相关任务的工具。
core gcloud CLI 核心库 gcloud CLI 工具在内部使用的库。

Alpha 版和 Beta 版组件

gcloud CLI 提供了两个包含 gcloud CLI Alpha 版和 Beta 版命令的组件。默认情况下,系统不会安装这些组件,但您可以在初始 gcloud CLI 安装之后随时手动安装。这些组件如下所示:

ID 名称 说明
alpha gcloud CLI Alpha 版命令 处于“Alpha 版”版本级别的 gcloud CLI 命令。
beta gcloud CLI Beta 版命令 处于“Beta 版”版本级别的 gcloud CLI 命令。

处于正式版级别的 gcloud CLI 命令是 gcloud CLI 组件的一部分,在您安装 gcloud CLI 时,系统会自动安装这些命令。

下文列出了默认不安装的所有可用的其他组件外部软件包管理器

管理 gcloud CLI 组件

您可以根据自己的需求列出、安装、更新和移除 gcloud CLI 组件。

列出组件

如需查看可用的组件以及当前安装的组件的列表,请运行 gcloud components list

gcloud components list

以下示例未完全列出所有可用组件。如需查看提供的最新组件,请更新 gcloud CLI 安装,然后运行 gcloud components list

Status 组件名称 ID 大小
已安装 App Engine Go 扩展程序 app-engine-go 97.7 MiB
未安装 AppCtl appctl 21.0 MiB
已安装 Cloud Bigtable 命令行工具 cbt 4.0 MiB
已安装 Cloud Bigtable Emulator bigtable 3.8 MiB
已安装 Cloud Datastore Emulator cloud-datastore-emulator 17.8 MiB
未安装 Cloud Firestore 模拟器 cloud-firestore-emulator 60.4 MiB
已安装 Cloud Pub/Sub Emulator pubsub-emulator 33.2 MiB
已安装 Cloud SQL 代理 cloud_sql_proxy 7.6 MiB
已安装 Cloud Spanner 模拟器 cloud-spanner-emulator 21.8 MiB
已安装 Google Cloud Build 本地构建工具 cloud-build-local 4.4 MiB
已安装 gcloud app Java 扩展程序 app-engine-java 118.9 MiB
已安装 gcloud app PHP 扩展程序 app-engine-php 21.9 MiB
已安装 gcloud app Python 扩展程序(额外库) app-engine-python-extras 27.8 MiB
已安装 kubectl kubectl 12.2 MiB
已安装 Cloud BigQuery 命令行工具 bq < 1 MiB
已安装 Cloud SDK 核心库 core 7.2 MiB
已安装 Cloud Storage 命令行工具 gsutil 3.3 MiB
已安装 gcloud Alpha 版命令 alpha < 1 MiB
已安装 gcloud Beta Commands Beta 版 < 1 MiB
已安装 gcloud app Python 扩展程序 app-engine-python 6.1 MiB

安装组件

如需在当前安装的 gcloud CLI 版本下安装组件,请运行 gcloud components install

gcloud components install [COMPONENT-ID]

gcloud CLI 会安装指定的组件。

例如,如果您想要安装 kubectl 命令,请运行以下命令:

gcloud components install kubectl

更新组件

使用 gcloud components update 命令将所有已安装的组件更新为最新可用版本的 gcloud CLI:

gcloud components update

如果您安装了旧版 gcloud CLI,则 gcloud CLI 会更新所有已安装的组件。

如果您需要还原到之前已知的良好版本并直接安装 gcloud CLI(在软件包管理器之外,包括使用交互式安装程序、静态版本、Windows 安装程序或 Home 表现),请使用 gcloud components update 还原到指定版本:

gcloud components update --version VERSION

如需将使用软件包管理器安装的 gcloud CLI 降级,请参阅有关在使用 apt-getyum 下载时指定版本的说明。

移除组件

使用 gcloud components remove 命令可按 ID 移除指定的组件:

gcloud components remove [COMPONENT-ID]

您可以随时使用 gcloud components install 命令重新安装组件。

其他组件

gcloud CLI 中提供了包含 gcloud CLI 命令依赖项的其他组件,但默认情况下不会安装这些组件。如需查看组件的详尽列表,请运行 gcloud components list。可以安装的其他组件均标记为 Not Installed 状态。

外部软件包管理器

如果您通过 aptyum 软件包管理器安装了 gcloud CLI,则还可以使用这些软件包管理器安装其他 gcloud CLI 组件。如果软件包管理器找不到这些软件包,请参阅使用 apt 安装使用 yum 安装指南,了解如何将 https://packages.cloud.google.com/ 配置为软件包源。

gcloud CLI 组件 APT 软件包 YUM 软件包
app-engine-go google-cloud-cli-app-engine-go google-cloud-cli-app-engine-go
app-engine-java google-cloud-cli-app-engine-java google-cloud-cli-app-engine-java
app-engine-python google-cloud-cli-app-engine-python google-cloud-cli-app-engine-python
bigtable google-cloud-cli-bigtable-emulator google-cloud-cli-bigtable-emulator
cbt google-cloud-cli-cbt google-cloud-cli-cbt
cloud-build-local google-cloud-cli-cloud-build-local google-cloud-cli-cloud-build-local
docker-credential-gcr 尚未提供。 尚未提供。
gcd-emulator google-cloud-cli-datastore-emulator google-cloud-cli-datastore-emulator
kubectl kubectl kubectl
pubsub-emulator google-cloud-cli-pubsub-emulator google-cloud-cli-pubsub-emulator