gcloud 指令列工具總覽

這個頁面針對 gcloud 指令列工具及其常見的指令模式和相關問題提供了基本的說明。

什麼是 gcloud 指令列工具?

gcloud 指令列介面是一個工具,可將主要 CLI 提供給 Google Cloud Platform。您可以從指令列或是在指令碼和其他自動化機制中使用這項工具,執行許多常見的平台工作。

例如,您可以使用 gcloud CLI 建立及管理下列項目:

  • Google Compute Engine 虛擬機器執行個體和其他資源
  • Google Cloud SQL 執行個體
  • Google Kubernetes Engine 叢集
  • Google Cloud Dataproc 叢集和工作
  • Google Cloud DNS 代管區域和記錄集
  • Google Cloud Deployment 管理員部署

您也可以使用 gcloud CLI 部署 App Engine 應用程式並執行其他工作:請閱讀 gcloud CLI 參考資料,進一步瞭解這項工具的功能。

gcloud CLI 與 Cloud SDK

gcloud CLI 是 Google Cloud SDK 的一部分。您必須先在系統中下載並安裝 SDK,然後初始化 SDK,才能使用 gcloud 指令列工具。

根據預設,SDK 僅會安裝屬於正式發行版和搶先版層級的這些 gcloud CLI 指令。名稱為 alphabeta 的 SDK 元件會提供額外的功能。這些元件允許您在 Google Cloud Bigtable、Google Cloud Dataflow 以及 Cloud Platform 的其他服務中使用 gcloud CLI (僅適用於正式發行版的之前的版本層級)。

gcloud CLI 版本與 SDK 有相同的版本號碼,目前的 SDK 為 245.0.0。您可以從下載封存檔中下載並安裝 SDK 先前的版本。

下載 gcloud 指令列工具

您可以從下載頁面下載最新版本的 Cloud SDK,其中包含 gcloud 指令列工具。

版本層級

gcloud CLI 指令有下列版本層級:

版本層級 標籤 描述
正式發行版 指令能夠穩定運作且可用於正式版本。如果有任何指令會造成現有功能失效,會預先提出警告,並記錄在版本資訊中。
Beta 版 beta 指令功能完整,不過可能仍有一些未解決的問題。這些指令可能有重大變更,而不另行通知。
Alpha 版 alpha 指令為早期版本,且未來可能有所異動,而不另行通知。
搶先版 preview 指令的運作可能不穩定,且未來可能有所異動,而不另行通知。

根據預設,alphabeta 元件並不會在您安裝 SDK 時一併安裝,您必須使用 gcloud components install 指令個別安裝這些元件。如果您嘗試執行 Alpha 版或 Beta 版指令,且並未安裝相應的元件,gcloud 指令列工具將提示您安裝元件。

指令群組

在每個版本中,gcloud CLI 指令會歸類為巢狀階層指令群組,每個群組會呈現 Cloud Platform 功能性子群組中的一項產品或功能。

例如:

指令群組 描述
gcloud compute Compute Engine 的相關指令,可開放一般使用者使用。
gcloud compute instances Compute Engine 執行個體的相關指令,可開放一般使用者使用。
gcloud beta compute Beta 版中和 Compute Engine 相關的指令。
gcloud alpha app Alpha 版中與管理 App Engine 部署相關的指令。

執行 gcloud CLI 指令

您可以像使用其他指令列工具一樣,從指令列執行 gcloud CLI 指令。您也可以從指令碼和其他自動化項目中執行 gcloud CLI 指令,例如使用 Jenkins 自動進行 Cloud Platform 工作。

屬性

gcloud CLI 屬性可影響 gcloud CLI 和其他 Cloud SDK 工具的行為,其中部分屬性可以通用或指令標記來設定;在此情況下,系統會優先採用標記所設的值。

如要查看可用的屬性清單,請按這裡

設定

設定為 gcloud CLI 屬性的命名集。基本上它的功能跟「設定檔」一樣。

開始使用 Cloud SDK 時,您會用到名為 default 的單一配置,接著您可以執行 gcloud initgcloud config set 來設定屬性。這個單一預設配置可適用於大多數的用途。

如果您想要使用多個專案或授權帳戶,您可用 gcloud config configurations create 設定多重配置並視情況切換配置。

如需這些概念的詳細說明,請參閱設定及其管理設定說明文章。

通用標記

gcloud CLI 提供一組適用於所有項目的 gcloud CLI 標記,可以管理指令在每次叫用時的行為。標記會覆寫在 SDK 屬性中設定的任何值。

位置引數和標記

雖然位置引數和標記都會影響 gcloud CLI 指令的輸出,不過兩者的用途還是有細微的不同之處。位置引數用於定義以指令運算的實體,而標記則需要在指令行為中設定一個變化類型。

使用 stdout 和 stderr

成功輸出的 gcloud CLI 指令會寫入 stdout,所有其他類型的回應,如提示、警告和錯誤會寫入 stderr。請注意,任何寫入 stderr 的指令並不穩定,不應針對這種情況撰寫指令碼。

如需查看處理輸出的規範清單,請參閱本節

提示

為了防止意外的破壞性動作發生,gcloud CLI 在執行 gcloud projects delete 指令前會確認您的意願。

您要建立 Google Compute Engine 虛擬機器執行個體時也會出現提示,例如使用 gcloud compute instances create test-instance「測試執行個體」的情況,系統將要求您選取要建立執行個體的區域。

若想要停用提示,請使用 --quiet 標記。

請注意,提示中的字詞可變更,因此不應要求撰寫指令碼。

略過提示、寫入終端機和登入

gcloud CLI 的 --quiet 標記 (或 -q) 可在執行 gcloud CLI 指令時停用所有互動式提示,並在撰寫指令碼時派上用場。在需要輸入的情況下,系統會使用預設值,如果沒有任何預設值,就會發出錯誤。

若想在終端機上略過將指令輸出列印至標準輸出,以及略過標準錯誤,請使用 --no-user-output-enabled 標記。

如果是想要調整記錄的仔細程度,請使用 --verbosity 標記並定義適當的層級。

決定輸出結構

根據預設,當 gcloud CLI 指令傳回資源清單時,這些資源為有效列印至標準輸出。如要產生更具意義的輸出內容,您可以透過格式、篩選器和投影標記來微調輸出。

如果您只想定義輸出的格式,請使用 --format 標記來產生表格式或整併式版本的輸出內容 (做為互動式顯示),或是機器可解讀的輸出版本 (jsoncsvyamlvalue 等)。

如要設定可選取資源資料值的索引鍵清單格式,請使用 projections。如要進一步將輸出內容修正至您想定義的條件,請使用 filter

如果您想要參加互動式快速教學課程來幫助您熟悉篩選器和格式功能,請點選下方連結。

在 Cloud Shell 中開啟

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

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

這個網頁
Cloud SDK 說明文件