管理 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

状态 组件名称 ID 尺寸
已安装 App Engine Go 扩展程序 app-engine-go 97.7 MiB
未安装 AppCtl appctl 21.0 MiB
已安装 Cloud Bigtable 命令行工具 cbt 4.0 MiB
已安装 Cloud Bigtable 模拟器 提供 3.8 MiB
已安装 Cloud Datalab 命令行工具 Datalab 1 MiB
已安装 Cloud Datastore 模拟器 cloud-datastore-模拟器 17.8 MiB
未安装 Cloud Datastore 模拟器 cloud-firestore-模拟器 60.4 MiB
已安装 Cloud Pub/Sub 模拟器 pubsub-模拟器 33.2 MiB
已安装 Cloud SQL 代理 cloud-sql-proxy 7.6 MiB
已安装 Cloud Spanner 模拟器 cloud-spanner-模拟器 21.8 MiB
已安装 Google Cloud Build 本地构建器 cloud-build-local 4.4 MiB
已安装 gcloud app Java 扩展程序 app-engine-java 118.9 MiB
已安装 gcloud app PHP Extensions 扩展程序 app-engine-php 21.9 MiB
已安装 gcloud app Python Extensions(Extra 库) app-engine-python-extras 27.8 MiB
已安装 kubectl kubectl 12.2 MiB
已安装 Cloud BigQuery 命令行工具 bq 1 MiB
已安装 Cloud SDK 核心库 核心 7.2 MiB
已安装 Cloud Storage 命令行工具 gsutil 3.3 MiB
已安装 gcloud Alpha 命令 Alpha 版 1 MiB
已安装 gcloud Beta 版命令 Beta 版 1 MiB
已安装 gcloud app Python Extensions 扩展程序 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 安装程序或 Homecraft),请使用 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-sdk-app-engine-go google-cloud-sdk-app-engine-go
app-engine-java google-cloud-sdk-app-engine-java google-cloud-sdk-app-engine-java
app-engine-python google-cloud-sdk-app-engine-python google-cloud-sdk-app-engine-python
bigtable google-cloud-sdk-bigtable-emulator google-cloud-sdk-bigtable-emulator
cbt google-cloud-sdk-cbt google-cloud-sdk-cbt
cloud-build-local google-cloud-sdk-cloud-build-local google-cloud-sdk-cloud-build-local
datalab google-cloud-sdk-datalab google-cloud-sdk-datalab
docker-credential-gcr 尚未提供。 尚未提供。
gcd-emulator google-cloud-sdk-datastore-emulator google-cloud-sdk-datastore-emulator
kubectl kubectl kubectl
pubsub-emulator google-cloud-sdk-pubsub-emulator google-cloud-sdk-pubsub-emulator