管理 Cloud SDK 组件

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

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

自行试用

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

免费开始使用

默认组件

安装 Cloud SDK 时,系统会默认安装以下组件:

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

Alpha 版和 Beta 版组件

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

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

处于“正式版”版本级别的 gcloud 工具命令是 gcloud 工具组件的一部分,在您安装 Cloud SDK 时,系统将自动安装这些命令。

以下列表列出了所有可用的 其他组件外部软件包管理器 (默认情况下未安装)。

管理 Cloud SDK 组件

您可以根据需要列出、安装、更新和移除 Cloud SDK 组件。

列出组件

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

gcloud components list

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


┌────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                  Components                                         │
├───────────────┬─────────────────────────────────────────────────┬──────────────────────────┬───────────┤
│     Status   │                         Name                   │            ID           │    Size   │
├───────────────┼─────────────────────────────────────────────────┼──────────────────────────┼───────────┤
│ Installed     │ App Engine Go Extensions                      │ app-engine-go            │  97.7 MiB │
│ Not Installed │ AppCtl                                        │ appctl                   │  21.0 MiB │
│ Installed     │ Cloud Bigtable Command Line Tool              │ cbt                      │   4.0 MiB │
│ Installed     │ Cloud Bigtable Emulator                       │ bigtable                 │   3.8 MiB │
│ Installed     │ Cloud Datalab Command Line Tool               │ datalab                  │   < 1 MiB │
│ Installed     │ Cloud Datastore Emulator                      │ cloud-datastore-emulator │  17.8 MiB │
| Not Installed | Cloud Datastore Emulator                      | cloud-firestore-emulator | 60.4 MiB  |
│ Installed     │ Cloud Pub/Sub Emulator                        │ pubsub-emulator          │  33.2 MiB │
│ Installed     │ Cloud SQL Proxy                               │ cloud-sql-proxy          │   7.6 MiB │
│ Installed     │ Cloud Spanner Emulator                        │ cloud-spanner-emulator   │  21.8 MiB │
│ Installed     │ Emulator Reverse Proxy                        │ emulator-reverse-proxy   │  14.5 MiB │
│ Installed     │ Google Cloud Build Local Builder              │ cloud-build-local        │   4.4 MiB │
│ Installed     │ gcloud app Java Extensions                    │ app-engine-java          │ 118.9 MiB │
│ Installed     │ gcloud app PHP Extensions                     │ app-engine-php           │  21.9 MiB │
│ Installed     │ gcloud app Python Extensions (Extra Libraries)│ app-engine-python-extras │  27.8 MiB │
│ Installed     │ kubectl                                       │ kubectl                  │  12.2 MiB │
│ Installed     │ Cloud BigQuery Command Line Tool              │ bq                       │   < 1 MiB │
│ Installed     │ Cloud SDK Core Libraries                      │ core                     │   7.2 MiB │
│ Installed     │ Cloud Storage Command Line Tool               │ gsutil                   │   3.3 MiB │
│ Installed     │ gcloud Alpha Commands                         │ alpha                    │   < 1 MiB │
│ Installed     │ gcloud Beta Commands                          │ beta                     │   < 1 MiB │
│ Installed     │ gcloud app Python Extensions                  │ app-engine-python        │   6.1 MiB │
└────────────────┴────────────────────────────────────────────────┴───────────────────────────┴───────────┘

安装组件

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

gcloud components install [COMPONENT-ID]

gcloud 工具会安装指定的组件。

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

gcloud components install kubectl

更新组件

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

gcloud components update

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

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

gcloud components update --version VERSION

如需降级使用软件包管理器安装的 Cloud SDK 版本,请参阅这些说明,了解如何在使用 apt-getyum 下载时指定版本。

移除组件

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

gcloud components remove [COMPONENT-ID]

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

其他组件

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

外部软件包管理器

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

Cloud SDK 组件 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