组件是 Google Cloud CLI 的可安装部分。组件可以是命令行工具(gcloud
、bq
和 gsutil
)、一组处于 Alpha 版或 Beta 版版本级别的 gcloud
CLI 命令,也可以是包含 gcloud
CLI 中工具使用的依赖项的软件包。
系统会默认安装最常用的组件。如果您以交互方式运行 gcloud alpha
或 gcloud beta
命令,并且未安装 alpha
或 beta
组件,则 gcloud
CLI 会询问您是否要安装该组件。如果您给予肯定回复,则系统会安装该组件,然后运行该命令。当您运行需要其他组件的命令时,gcloud
CLI 会按需安装这些组件。
默认组件
安装 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-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-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 |