什么是组件?
组件是 SDK 的可安装部分。组件可以是命令行工具(gcloud
、bq
和 gsutil
)、一组处于 Alpha 版或 Beta 版 版本级别 的 gcloud CLI 命令,也可以是包含 SDK 中的工具所用依赖项的软件包。
系统会默认安装最常用的组件。如果您以交互方式运行 gcloud alpha
或 gcloud beta
命令并且未安装 alpha
或 beta
组件,则 gcloud CLI 会询问您是否要安装该组件。如果您给予肯定答复,则系统会安装该组件,然后运行该命令。当您运行需要使用其他某些组件的命令时,gcloud CLI 会按需安装这些组件。
默认组件
安装 SDK 时,系统会默认安装以下组件:
ID | 名称 | 说明 |
---|---|---|
gcloud |
默认的 gcloud CLI 命令 | 用于与 Google Cloud 进行交互的工具。只有“正式版”和“预览版”版本级别的命令才会随同该组件一起安装。如果您想使用处于其他版本级别的命令,您必须单独安装 gcloud alpha 命令和/或 gcloud beta 命令组件。 |
bq
| BigQuery 命令行工具 | 用于处理 Google BigQuery 中的数据的工具 |
gsutil |
Cloud Storage 命令行工具 | 用于执行 Google Cloud Storage 的相关任务的工具。 |
core |
Cloud SDK 核心库 | SDK 工具内部使用的库。 |
Alpha 版和 Beta 版组件
SDK 提供了两个包含 gcloud CLI Alpha 版和 Beta 版命令的组件。系统没有默认安装这些组件,但您可以在初始安装 SDK 之后,随时手动安装这些组件。 这些组件如下所示:
ID | 名称 | 说明 |
---|---|---|
alpha |
gcloud CLI Alpha 版命令 | 处于“Alpha 版”版本级别的 gcloud CLI 命令。 |
beta |
gcloud CLI Beta 版命令 | 处于“Beta 版”版本级别的 gcloud CLI 命令。 |
处于“正式版”版本级别的 gcloud CLI 命令是 gcloud CLI 组件的一部分,在您安装 SDK 时,系统将自动安装这些命令。
以下列表列出了所有可用的 其他组件 和 外部软件包管理器 (默认情况下未安装)。
管理 Cloud SDK 组件
您可以根据需要列出、安装、更新和移除 Google Cloud SDK 组件。
列出组件
如需查看可用的组件以及当前安装的组件的列表,请运行 gcloud components list
:
gcloud components list
┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐ │ Components │ ├───────────────┬───────────────────────────────────────────────┬──────────────────────────┬───────────┤ │ Status │ Name │ ID │ Size │ ├───────────────┼───────────────────────────────────────────────┼──────────────────────────┼───────────┤ │ Installed │ App Engine Go Extensions │ app-engine-go │ 97.7 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 │ │ Installed │ Cloud Datastore Emulator (Legacy) │ gcd-emulator │ 38.1 MiB │ │ Installed │ Cloud Pub/Sub Emulator │ pubsub-emulator │ 33.2 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 │ 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 list
。
安装组件
如需在当前安装的 Cloud SDK 版本下安装组件,请运行 gcloud components install
:
gcloud components install [COMPONENT-ID]
gcloud CLI 会安装指定的组件。
例如,如果您想要安装 kubectl
命令,请运行以下命令:
gcloud components install kubectl
更新组件
使用 gcloud components update
命令可将所有已安装的组件更新为 Cloud SDK 的最新可用版本:
gcloud components update
如果您安装了旧版 Cloud SDK,则 gcloud 命令行工具会更新所有已安装的组件。
如果您需要还原到之前已知良好的版本,并且直接安装 SDK(在软件包管理器外部,包括通过交互式安装程序、静态版本、Windows 安装程序或 Homebrew),您可以使用 gcloud components update
还原到指定版本:
gcloud components update --version VERSION
如需降级通过软件包管理器安装的 Cloud SDK 版本,请参阅这些说明,了解如何在通过 apt-get
或 yum
下载时指定版本。
移除组件
使用 gcloud components remove
命令可按 ID 移除指定的组件:
gcloud components remove [COMPONENT-ID]
您可以随时使用 gcloud components install
命令重新安装组件。
其他组件
SDK 中还提供了其他组件,这些组件包含各种 gcloud CLI 命令的依赖项,但默认情况下不会安装这些组件。如需查看详尽的组件列表,可运行 $ gcloud components list。可以安装的其他组件将标记为 Not Installed
状态。
外部软件包管理器
如果您通过 apt
或 yum
软件包管理器安装了 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 |