בדף הזה מוסבר איך ליצור משאב Config. משאב Config הוא אובייקט API שמאחסן משתנים כצמדי מפתח-ערך. כדי להגדיר משתנים ולקבל אותם, צריך משאב Config. אחרי שיוצרים משאב Config, אפשר ליצור משתנים שרירותיים שאפשר להשתמש בהם כדי לאחסן נתונים.
מידע נוסף על הגדרות, משתנים ושירות Runtime Configurator זמין במאמר יסודות של Runtime Configurator.
לפני שמתחילים
- אם רוצים להשתמש בדוגמאות לשורת הפקודה במדריך הזה, צריך להתקין את כלי שורת הפקודה`gcloud`.
- כדי להשתמש בדוגמאות ל-API במדריך הזה, צריך להגדיר גישה ל-API.
- מומלץ לקרוא את המאמר יסודות של כלי ההגדרה בזמן ריצה.
- מפעילים את Runtime Configurator API.
יצירת הגדרה
אפשר ליצור משאב Config באמצעות Deployment Manager, כלי שורת הפקודה gcloud או ישירות באמצעות Runtime Configurator API.
Deployment Manager
כדי ליצור הגדרה ב-Deployment Manager, מציינים את הסוג RuntimeConfig:
runtimeconfig.v1beta1.config
ב-properties של המשאב, מציינים את name ומאפיינים אופציונליים אחרים, אם רוצים:
resources:
- name: [CONFIG_NAME]
type: runtimeconfig.v1beta1.config
properties:
config: [CONFIG_NAME]
description: [DESCRIPTION]
where:
-
[CONFIG_NAME]הוא השם של ההגדרה הזו. -
[DESCRIPTION]הוא התיאור של ההגדרה הזו (אופציונלי).
gcloud
ב-Google Cloud CLI, משתמשים בפקודה gcloud beta runtime-config configs create:
gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]
where:
-
[CONFIG_NAME]הוא השם של ההגדרה הזו. -
[DESCRIPTION]הוא התיאור של ההגדרה הזו (אופציונלי).
gcloud מחזירה תשובה כמו:
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
למידע נוסף על הפקודה gcloud, תוכלו לקרוא את מאמרי העזרה של runtime-config configs create.
API
ב-API בארכיטקטורת REST, שולחים בקשת POST ל-URI הבא:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/
כאשר [PROJECT_ID] הוא מזהה הפרויקט של הבקשה הזו. המטען הייעודי (payload) של הבקשה נראה כך:
{
"name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
"description": "[DESCRIPTION]"
}
where:
-
[PROJECT_ID]הוא מזהה הפרויקט של הבקשה הזו. -
[CONFIG_NAME]הוא השם של RuntimeConfig.
[DESCRIPTION]הוא התיאור של ההגדרה הזו (אופציונלי).מידע נוסף על השיטה הזו זמין במאמרי העזרה בנושא
configs().create.
מחיקת משאב RuntimeConfig
מחיקה של משאב RuntimeConfig מוחקת את כל המשאבים שהמשאב הזה מכיל, כולל כל המשתנים וה-waiters.
Deployment Manager
כדי למחוק משאב RuntimeConfig שמהווה חלק מפריסה, משתמשים באחת מהשיטות הבאות:
- מעדכנים את הפריסה כדי להשמיט את ההגדרה ולפרוס מחדש את הפריסה.
- מחיקת הפריסה והמשאבים שהיא מכילה.
gcloud
ב-Google Cloud CLI, משתמשים בפקודה gcloud beta runtime-config configs delete:
gcloud beta runtime-config configs delete [CONFIG_NAME]
כאשר [CONFIG_NAME] הוא השם של אובייקט ההגדרה.
ה-CLI של gcloud מחזיר תשובה כמו:
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
לעיון במאמרי העזרה המלאים של gcloud, אפשר לקרוא את מאמרי העזרה של runtime-config configs delete.
API
ב-API בארכיטקטורת REST, שולחים בקשת DELETE ל-URI הבא:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]
where:
-
[PROJECT_ID]הוא מזהה הפרויקט של הבקשה הזו.
[CONFIG_NAME]הוא השם של ההגדרה הזו.מידע נוסף על השיטה הזו זמין במאמרי העזרה בנושא
configs().delete.
המאמרים הבאים
- לאחר מכן, יוצרים כמה משתנים וקוראים איך מגדירים נתונים ומקבלים אותם.
- איך מגדירים Watcher למשתנה ספציפי
- יוצרים Waiter שמוחזר כשמשתנה מגיע לתנאי Cardinality.
- מידע נוסף זמין במאמר בנושא v1beta1.
- אפשר לעיין במכסות של Runtime Configurator.
- מידע על הכלי להגדרת זמן ריצה