本頁說明如何建立 Config 資源。Config 資源是一個 API 物件,可將變數儲存為鍵/值組合。您必須有 Config 資源後才能設定和取得變數。建立 Config 資源後,您能夠建立可用於儲存資料的任意變數。
如要進一步瞭解設定、變數和 Runtime Configurator 服務,請參閱 Runtime Configurator 基礎知識一文。
事前準備
- 如要使用本指南提供的指令列範例,請安裝 `gcloud` 指令列工具。
- 如要使用本指南提供的 API 範例,請設定 API 存取權。
- 參閱 Runtime Configurator 基礎知識一文。
- 啟用 Runtime Configurator API。
建立設定
您可以使用 Deployment Manager、gcloud
指令列工具,或直接使用 Runtime Configurator API 來建立 Config 資源。
Deployment Manager
如要在 Deployment Manager 中建立設定,請指定 RuntimeConfig 類型:
runtimeconfig.v1beta1.config
在資源的 properties
中,視需要提供 name
和其他選用屬性:
resources:
- name: [CONFIG_NAME]
type: runtimeconfig.v1beta1.config
properties:
config: [CONFIG_NAME]
description: [DESCRIPTION]
其中:
[CONFIG_NAME]
是設定的名稱。[DESCRIPTION]
是這個設定的說明 (選用)。
gcloud
透過 Google Cloud CLI 使用 gcloud beta runtime-config configs create
指令:
gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]
其中:
[CONFIG_NAME]
是設定的名稱。[DESCRIPTION]
是這個設定的說明 (選用)。
gcloud
會傳回類似下方的回應:
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
如需這個 gcloud
指令的完整參考資料,請參閱 runtime-config configs create
參考說明文件。
API
在 REST API 中,向下列的 URI 發出 POST
要求:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/
其中 [PROJECT_ID]
是這項要求的專案 ID。這項要求的酬載如下所示:
{
"name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
"description": "[DESCRIPTION]"
}
其中:
[PROJECT_ID]
是這項要求的專案 ID。[CONFIG_NAME]
是這個 RuntimeConfig 的名稱。[DESCRIPTION]
是這個設定的說明 (選用)。如要進一步瞭解這個方法,請參閱
configs().create
說明文件。
刪除 RuntimeConfig 資源
刪除 RuntimeConfig 資源時,系統將會刪除該資源包含的所有資源,包括所有變數和等候程序。
Deployment Manager
請使用下列其中一種方法,刪除屬於部署作業的 RuntimeConfig 資源:
- 更新部署作業以省略該設定並重新進行部署。
- 刪除部署作業及其包含的資源。
gcloud
透過 Google Cloud CLI 使用 gcloud beta runtime-config configs delete
指令:
gcloud beta runtime-config configs delete [CONFIG_NAME]
其中 [CONFIG_NAME]
是設定物件的名稱。
gcloud CLI 會傳回類似下方的回應:
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
如需 gcloud
的完整參考資料,請參閱 runtime-config configs delete
參考說明文件。
API
在 REST API 中,向下列的 URI 發出 DELETE
要求:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]
其中:
[PROJECT_ID]
是這項要求的專案 ID。[CONFIG_NAME]
是設定的名稱。如要進一步瞭解這個方法,請參閱
configs().delete
說明文件。
後續步驟
- 接下來,建立一些變數並瞭解如何設定和取得資料。
- 瞭解如何在特定變數上設定監看指令碼。
- 建立等候程序,該程序會在變數達到基數條件時回傳。
- 參閱 v1beta1 參考資料一文。
- 參閱 Runtime Configurator 的配額一文。
- 瞭解 Runtime Configurator。