本文件提供 Runtime Configurator 功能總覽,並說明 Runtime Configurator 相關的重要概念。如要瞭解如何建立 RuntimeConfig 資源,請參閱建立和刪除 RuntimeConfig 資源。
什麼是 Runtime Configurator?
Runtime Configurator 功能可讓您定義資料,並將其儲存為 Google Cloud Platform 中的鍵/值組合階層。這些鍵/值組合可用於以下作業:
- 動態設定服務
- 通訊服務狀態
- 傳送變更通知到資料
- 在多個服務級別之間共用資訊
舉例來說,假設您有一個用於執行啟動程序的節點叢集。在啟動期間,您可以設定讓節點向 Runtime Configurator 回報自身狀態,並設定其他應用程式查詢 Runtime Configurator,然後根據節點的狀態執行特定工作。
Runtime Configurator 也提供監看指令碼服務和等候程序服務。監看指令碼服務可以監控特定的金鑰組,並在金鑰組變更傳回回應。等候程序服務則會等待特定的結束條件,並在符合結束條件時傳回回應。
您可以透過 gcloud CLI 使用 Runtime Configurator,或將 Runtime Configurator 做為獨立的 API 使用。
概念
Config 資源
Config 資源包含變數的階層式清單。您可以建立不同的設定供各種用途使用。例如,您可以根據以下條件設定不同配置:環境 (實際工作、開發、測試);應用程式或服務的不同級別 (後端、前端);實體 (每位應用程式使用者各一種設定)。
變數
變數是屬於 RuntimeConfig 資源的鍵/值組合。變數金鑰具備以下格式:
projects/[project_id]/configs/[CONFIG_ID]/variables/[VARIABLE_NAME]
您可以設定、取得和監看變數值,以便與應用程式交流資訊、傳送完成狀態信號或傳送資料變更通知等。變數採用階層式結構,讓變數金鑰能在多個層級中使用。請參考下方的變數金鑰範例:
webserver-1/users/name webserver-1/users/favorite_color
監看指令碼
您可以使用
watch()
方法監看變數,並在變數更動、監看指令碼逾時或監看指令碼遭到刪除時傳回回應。此外,您也可以使用watch()
功能根據資料變更內容,以動態方式設定您的應用程式。等候程序
如果您建立了等候程序資源用於監看特定的路徑前置字串,該等候程序會在前置字串底下的變數達到一定數量時傳回回應。這稱為基數條件。
例如,如果您為路徑
/foo
設定條件,並將路徑數量設為 2,則下列設定將滿足條件:/foo/variable1 = "value1"
/foo/variable2 = "value2"
/bar/variable3 = "value3" # Not /foo path
您可以為等候程序同時設定失敗和成功條件。
建立等候程序後,服務會傳回輪詢作業物件以完成工作。符合下列任一條件時,作業便會完成:
- 符合
success
條件。 - 符合
failure
條件。 - 等候程序達到在初始要求中指定的逾時期限。
等候程序很適合在在啟動系統時使用,因為您在這段期間可能需要暫停部署作業,直到一定數量的服務開始執行為止。
後續步驟
- 建立 RuntimeConfig 資源。
- 設定和取得資料。
- 監看特定變數。
- 建立等候程序。
- 參閱 v1beta1 參考資料。
- 參閱 Runtime Configurator 的配額一文。