管理 gcloud CLI 组件

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

系统会默认安装最常用的组件。如果您以交互方式运行 gcloud alpha 或 gcloud beta 命令并且未安装 alpha 或 beta 组件，则 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 任务的旧版工具。请改用 gcloud 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 组件。

注意：如果您已使用 APT 或 yum 等软件包管理器安装了 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 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 Emulator 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 测试版 < 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 安装程序或 Homebrew），请使用 gcloud components update 还原到指定版本：

gcloud components update --version VERSION
如需降级使用软件包管理器安装的 gcloud CLI 版本，请参阅这些说明，了解如何在使用 apt-get 或 yum 下载时指定版本。

移除组件

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

gcloud components remove [COMPONENT-ID]

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

其他组件

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

外部软件包管理器

如果您通过 apt 或 yum 软件包管理器安装了 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