管理 gcloud CLI 設定

設定為 Google Cloud CLI 屬性的命名集。這些屬性是鍵/值組合,以區段形式整理,用於管理 gcloud CLI 的行為。

通常儲存在設定中的屬性包括預設 Compute Engine 區域、詳細程度、用量報告、專案 ID,以及有效使用者或服務帳戶。您可透過設定,將這些和其他設定定義為一組並啟用。

設定會儲存在使用者設定目錄中 (通常是 MacOS 和 Linux 上的 ~/.config/gcloud,或是 Windows 上的 %APPDATA%\gcloud)。您可以執行 gcloud info --format='value(config.paths.global_config_dir)' 找出設定目錄的位置。您可以設定 CLOUDSDK_CONFIG 環境變數,變更設定目錄。此外,請注意,設定目錄必須啟用寫入功能。不過,如果您使用 Cloud Shell,gcloud CLI 偏好設定會儲存在臨時 tmp 資料夾中,僅適用於目前的 Cloud Shell 分頁,不會在工作階段之間保留。

如果您有多個設定,可以選擇切換設定,或使用特定設定執行指令 (透過 --configuration 旗標)。如要進一步瞭解如何切換設定,請參閱下方的「啟用設定」一節。

如要透過指令列讀取設定 (以及可用屬性的完整清單和所屬區段),請執行 gcloud topic configurations

預設設定

gcloud CLI 一開始會為您提供名為 default 的單一設定,您可以執行 gcloud init 指令或直接執行 gcloud config set,在設定中設定屬性。

舉例來說,如要停用編寫指令碼的提示,請執行:

gcloud config set disable_prompts true

多重配置

單一 default 設定適用於許多用途。不過您也可以建立其他配置,並視情況需要,使用 gcloud config configurations activate 進行切換。初始 default 設定沒有特別之處,只是為了方便而建立。您可以隨意命名這項配置或任何其他配置。

如果您想執行下列事項,多重配置就相當實用:

  • 使用多重專案:您可以為每個專案建立個別配置,並依照需求在其中切換。
  • 使用多重授權帳戶
  • 執行一般獨立工作:例如,您可以在一個專案中針對 App Engine 應用程式使用一個配置,並管理其他專案中的不相關 Compute Engine 執行個體。

建立設定

如要建立設定,請執行