管理 gcloud CLI 元件

元件是 Google Cloud CLI 中可安裝的部分,元件可以是指令列工具 (gcloudbqgsutil)、Alpha 版或 Beta 版發布層級的一組 gcloud CLI 指令,或是包含 gcloud CLI 中工具所用依附元件的套件。

安裝 SDK 時,預設會安裝最常使用的元件。如果您以互動方式執行 gcloud alphagcloud beta 指令,且並未安裝 alphabeta 元件,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,這些操作說明就不適用,因為使用這種方式安裝時會停用 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 模擬器 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 SQL Proxy 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 核心資料庫 核心 7.2 MiB
已安裝 Cloud Storage 指令列工具 gsutil 3.3 MiB
已安裝 gcloud Alpha 版指令 Alpha 版 < 1 MiB
已安裝 gcloud Beta 版指令 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-getyum 下載時指定版本。

移除元件

使用 gcloud components remove 指令,依照元件 ID 移除指定元件:

gcloud components remove [COMPONENT-ID]

您隨時可以使用 gcloud components install 指令重新安裝元件。

附加元件

gcloud CLI 也包含附加元件,這些元件含有 gcloud CLI 指令適用的依附元件,不過預設不會安裝。如需完整元件清單,請執行 gcloud components list。可安裝的其他元件會標示為 Not Installed 狀態。

外部套件管理員

如果您是透過 aptyum 套件管理員安裝 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 尚未提供。 尚未提供。
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