管理 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，因为 使用 安装。使用这些 packages。

列出组件

如需查看可用的组件以及当前安装的组件的列表，请运行 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 模拟器 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 安装程序或 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 安装了 gcloud CLI 或 yum 软件包管理器，还可以安装 其他 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