什麼是元件?
「元件」為 SDK 中可安裝的部分,可以是一種指令列工具 (例如 gcloud
、bq
及 gsutil
)、版本層級為 Alpha 或 Beta 的一組 gcloud CLI 指令,或是包含 SDK 中某項工具所需依附元件的一個套件。
安裝 SDK 時,預設會安裝最常使用的元件。如果您以互動方式執行 gcloud alpha
或 gcloud beta
指令,且並未安裝 alpha
或 beta
元件,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-get
或 yum
進行下載時指定版本。
移除元件
使用 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 |