管理 SDK 元件

什麼是元件?

「元件」為 SDK 中可安裝的部分,可以是一種指令列工具 (例如 gcloudbqgsutil)、版本層級為 Alpha 或 Beta 的一組 gcloud CLI 指令,或是包含 SDK 中某項工具所需依附元件的一個套件。

安裝 SDK 時,預設會安裝最常使用的元件。如果您以互動方式執行 gcloud alphagcloud beta 指令,且並未安裝 alphabeta 元件,gcloud CLI 會詢問您是否要安裝。如果您的回應為肯定,系統就會安裝元件並接著執行指令。其他元件會在您執行的指令需要這些元件時由 gcloud CLI 隨選安裝。

預設元件

當您安裝 SDK 時,預設會安裝下列元件:

ID 名稱 說明
gcloud 預設 gcloud CLI 指令 用於與 Google Cloud Platform 互動的工具。只有正式發行版和搶先版層級的指令會安裝這個元件。如果您想要使用其他版本層級的指令,您必須個別安裝 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 CLI 會更新所有安裝的元件。

如果您需要還原至已知可正常運作的版本,並直接安裝 SDK (在套件管理員以外安裝,包含透過互動式安裝程式、靜態版本、Windows 安裝程式或 Homebrew),您可以使用 gcloud components update 還原至指定版本:

gcloud components update --version VERSION

如需將透過套件管理員安裝的 Cloud SDK 版本降級,請參閱相關操作說明,瞭解如何在透過 apt-getyum 進行下載時指定版本。

移除元件

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

gcloud components remove [COMPONENT-ID]

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

附加元件

SDK 也包含附加元件,這些元件含有各種 gcloud CLI 指令適用的依附元件,不過預設不會安裝。以下為其中的部分元件 (執行 $ gcloud 元件清單取得完整清單):

ID 名稱 說明
app-engine-python gcloud App Python 延伸模組 適用於 Python 的 Google App Engine SDK 套件。當您使用 gcloud app deploy 指令在 App Engine 上部署 Python 應用程式時安裝。
app-engine-java gcloud App Java 延伸模組 適用於 Java 的 Google App Engine SDK 套件。當您使用 gcloud app deploy 指令在 App Engine 上部署 Java 應用程式時安裝。
app-engine-go gcloud App Go 延伸模組 適用於 Go 的 Google App Engine SDK 套件。 當您使用 gcloud app deploy 指令在 App Engine 上部署 Go 應用程式時安裝。
gcd-emulator Cloud Datastore 模擬器 適用於 Google Cloud Datastore 的模擬器。當您使用 gcloud beta emulators datastore 指令群組中的指令時安裝。
pubsub-emulator Cloud Pub/Sub 模擬器 適用於 Google Cloud Pub/Sub 的模擬器。當您使用 gcloud beta emulators pubsub 指令群組中的指令時安裝。
cbt Cloud Bigtable CLI Google Cloud Bigtable 指令列工具。
cloud-build-local Cloud Build 本機建構工具 Google Cloud Build 本機建構工具。
bigtable Cloud Bigtable 模擬器 適用於 Google Cloud Bigtable 的模擬器。當您使用 gcloud beta emulators bigtable 指令群組中的指令時安裝。
kubectl kubectl Kubernetes 指令列工具。當您執行 gcloud container 指令列群組中的指令時,系統會提示您安裝此元件。建立容器叢集不需要 kubectl,不過執行時則為必要項目。
docker-credential-gcr docker-credential-gcr 適用於 Google Container Registry 的 Docker 憑證輔助程式。安裝之後,請執行 docker-credential-gcr configure-docker 以啟用憑證輔助程式。如需更多資訊,請查看 GitHub 上的專案
datalab datalab Cloud Datalab 指令列工具。
cloud-build-local Google Cloud Build Local Cloud Build 適用的本機建構工具。安裝之後,您可以在本機電腦上執行編譯好的程式。詳情請參閱在本機上建構和偵錯

外部套件管理員

如果您使用像是 APT (透過 deb 格式) 或 YUM 等外部套件管理員來安裝 Cloud SDK,您可以使用下列資料表安裝附加元件。

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
本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud SDK 說明文件