管理 gcloud CLI 元件

元件是 Google Cloud CLI 的可安裝部分。元件可以是指令列工具 (gcloud、bq 和 gsutil)、Alpha、Beta 或預先發布版版本級別的一組 gcloud CLI 指令，或包含 gcloud CLI 工具所用依附元件的套件。

安裝 SDK 時，預設會安裝最常使用的元件。如果您以互動方式執行 gcloud alpha、gcloud beta 或 gcloud preview 指令，且未安裝 alpha、beta 或 preview 元件，gcloud CLI 會詢問您是否要安裝。如果回答「是」，系統就會安裝元件，然後執行指令。當您執行需要其他元件的指令時，gcloud CLI 會隨選安裝這些元件。

預設元件

安裝 gcloud CLI 時，系統預設會安裝下列元件：

ID 名稱 說明
gcloud 預設 gcloud CLI 指令 與 Google Cloud互動的工具。這項元件只會安裝正式發布版層級的指令。如要使用其他版本層級的指令，則必須另外安裝 gcloud alpha 指令、gcloud beta 指令和/或 gcloud preview 指令元件。
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 指令。
preview gcloud CLI 預先發布版指令 預先發布版層級的 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。

Status 元件名稱 ID 大小
已安裝 App Engine Go 擴充功能 app-engine-go 97.7 MiB
已安裝 Cloud Bigtable 指令列工具 cbt 4.0 MiB
已安裝 Cloud Bigtable 模擬器 bigtable 3.8 MiB
已安裝 Cloud Datastore 模擬器 cloud-datastore-emulator 17.8 MiB
未安裝 Cloud Firestore 模擬器 cloud-firestore-emulator 60.4 MiB
已安裝 Cloud Pub/Sub 模擬器 pubsub-emulator 33.2 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 核心資料庫 核心 7.2 MiB
已安裝 Cloud Storage 指令列工具 gsutil 3.3 MiB
已安裝 gcloud Alpha 指令 Alpha 版 < 1 MiB
已安裝 gcloud Beta 版指令 Beta 版 < 1 MiB
未安裝 gcloud 預先發布版指令 預覽 < 1 MiB
已安裝 gcloud 應用程式 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 google-cloud-cli-docker-credential-gcr google-cloud-cli-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