管理 SDK 屬性

什麼是屬性?

屬性是控制 gcloud CLI 行為和其他 SDK 工具的設定。

屬性可用於定義每項產品或每項服務的設定,例如 gcloud CLI 使用的帳戶和用於授權的其他 Cloud SDK 工具、使用 Google Compute Engine 資源時的預設區域,甚至是關閉 Cloud SDK 元件更新的自動選項。屬性可用於定義 gcloud 指令列工具偏好設定,例如細項等級和 gcloud CLI 指令提示設定。

屬性與標記

gcloud CLI 支援一些與 SDK 屬性效果相同的通用標記與指令標記。例如,gcloud CLI 支援 --project 標記與 project 屬性。屬性可允許您在指令執行期間維持相同的設定,而標記則在每次叫用時套用指令行為。請注意,同時設定兩者時,標記會覆寫屬性。

設定

設定為具有名稱的 SDK 屬性集。gcloud CLI 使用名為 default 的設定做為初始使用的設定。default 能適用於大多數的情況。不過,您也可以建立其他設定並視需求在兩者間切換。

列出屬性

如要列出使用設定中的屬性,請執行 gcloud config list

gcloud config list

gcloud CLI 會傳回屬性清單:

[compute]
region = us-east1
zone = us-east1-d
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project
[metrics]
command_name = gcloud.config.list

設定屬性

如要設定使用設定中的一項屬性,請執行 gcloud config set

gcloud config set project [PROJECT]

如要設定不在 core 屬性區段的屬性,則必須在屬性名稱前指定帶有正斜線的區段:

gcloud config set compute/zone us-east1-b

取消屬性設定

如要取消使用設定中的一項屬性設定,請使用 gcloud config unset

gcloud config unset disable_usage_reporting

屬性類型

SDK 屬性會歸入不同區段,這些分類後的相關屬性能讓您檢視屬性清單時更加方便。

核心屬性

core 區段包含適用於 gcloud 指令的配置屬性。

名稱 說明
account 使用者帳戶或 gcloud CLI 和授權的其他 SDK 工具所使用的服務帳戶。
disable_color 設為 True 可防止 gcloud CLI 將彩色訊息輸出到終端機。
disable_prompts 如果設為 True 會禁止所有 gcloud CLI 指令的提示並假定為預設答案。如果指令需要使用者輸入資訊且無法使用預設值,gcloud CLI 會回報錯誤。等同於通用 --quiet 標記。
disable_usage_reporting 如果設為 True,系統會停止收集 SDK 使用情形的匿名統計資料。雖然您在安裝配置 SDK 已配置特定的值;不過,您可以隨時更改。
log_http 如果設為 True 會啟用 HTTP 要求的寫入和記錄的回應數。如果您想在終端機中查看這些訊息,請使用 verbosity 屬性或通用 --verbosity 標記調整您的細項設定。
project 目前 Cloud Platform 專案的專案 ID。您可以透過通用 --project 標記來覆寫這個值。
trace_token Google 支援所提供的符記,可轉送服務要求的追蹤記錄以便調查問題。
user_output_enabled 啟用指令輸出的列印至標準輸出,以及在終端機上的標準錯誤。如果設為 False 會禁止輸出。
verbosity 記錄下列用於 gcloud CLI 指令的細項。gcloud CLI 支援下列標準細項等級:
  • debug
  • info
  • warning
  • error
  • critical
  • none
等同於使用通用 --verbosity 標記。

元件管理員屬性

component_manager 區段包含管理 SDK 元件所用的屬性。

名稱 說明
component_manager/additional_repositories 用來檢查元件的其他存放區半形逗號分隔清單。 這個屬性由 gcloud components repositories 指令群組中的指令自動[代管。
component_manager/disable_update_check 如果為 True,SDK 不需要自動檢查更新。

App Engine 屬性

app 區段包含用於指定 gcloud app deploy 指令行為的屬性。

名稱 說明
app/stop_previous_version 在部署應用程式的新版本時,如果設為 True 會停止之前的部署版本。如果為 False,則在部署前就必須手動停止舊版本。

Compute Engine 屬性

compute 區段包含在 Google Compute Engine 資源中執行的 gcloud CLI 指令所用的屬性。

名稱 說明
compute/region 使用 Compute Engine 資源時所用的預設區域。如果 gcloud CLI 指令要求 --region 標記卻無法滿足,即採用此值。
compute/zone 使用 Compute Engine 資源時所用的預設區域。如果 gcloud CLI 指令要求 --zone 標記卻無法滿足,即採用此值。

Kubernetes Engine 屬性

container 區段包含在 Google Kubernetes Engine 叢集上執行的 gcloud CLI 指令所用的屬性。

名稱 說明
container/cluster 請命名預設要使用的叢集。

網路 Proxy 屬性

proxy 區端包含 gcloud 指令所用的網路 Proxy 相關屬性。

名稱 說明
proxy/type Proxy 伺服器的類型。支援的 Proxy 類型為:
  • http
  • http_no_tunnel
  • socks4
  • socks5
proxy/address Proxy 伺服器的主機名稱或 IP 位址。
proxy/port 用來連線至 Proxy 伺服器的通訊埠。
proxy/username 如有需要,用來連線至 Proxy 伺服器的使用者名稱。
proxy/password 如有需要,用來連線至 Proxy 伺服器的密碼。
proxy/rdns 如果為 True (預設),DNS 查詢將不會在本機上執行,改為送至 Proxy 解析。

後續步驟

  • 請閱讀 SDK 設定一文,進一步瞭解設定。
本頁內容對您是否有任何幫助?請提供意見:

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

這個網頁
Cloud SDK 說明文件