元件是 Google Cloud CLI 中可安裝的部分,元件可以是指令列工具 (gcloud
、bq
和 gsutil
)、Alpha 版或 Beta 版發布層級的一組 gcloud CLI 指令,或是包含 gcloud CLI 中工具所用依附元件的套件。
安裝 SDK 時,預設會安裝最常使用的元件。如果您以互動方式執行 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 工作的舊版工具。請改用 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
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 |
尚未提供。 | 尚未提供。 |
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 |