תצוגה מקדימה של הגדרות

בדף הזה מוסבר איך לראות תצוגה מקדימה של קובץ תצורה לפני שיוצרים פריסה. מידע נוסף על הגדרות זמין במאמר סקירה כללית על הגדרות.

אחרי שכותבים קובץ הגדרות, אפשר לראות תצוגה מקדימה של ההגדרות לפני שיוצרים פריסה. תצוגה מקדימה של הגדרה מאפשרת לכם לראות את המשאבים ש-Deployment Manager ייצור, אבל לא יוצרת בפועל משאבים. שירות Deployment Manager מציג תצוגה מקדימה של ההגדרה על ידי:

  1. הרחבת ההגדרה המלאה, כולל תבניות.
  2. יצירת פריסה ומשאבי 'מעטפת'.

כדי לראות תצוגה מקדימה של ההגדרה, משתמשים בפרמטר השאילתה preview כששולחים בקשת insert().

לפני שמתחילים

תצוגה מקדימה של הגדרה חדשה

אפשר לצפות בתצוגה מקדימה של ההגדרה באמצעות Google Cloud CLI או באמצעות שליחת בקשה ישירה אל ה-API.

gcloud

אם אתם משתמשים ב-Google Cloud CLI, מריצים את פקודת המשנה create עם הדגל --preview:

gcloud deployment-manager deployments create example-config --config configuration-file.yaml \
     --preview

השרת מחזיר רשימה של משאבים שהסטטוס שלהם הוא IN_PREVIEW לבדיקה:

The fingerprint of the deployment is ulPDrJON8E5ySHKC5fcukw==
Waiting for create [operation-1492785372594-54dae2ddbff50-58d45d53-12d483cf]...done.
Create operation operation-1492785372594-54dae2ddbff50-58d45d53-12d483cf completed successfully.
NAME                      TYPE                 STATE       ERRORS  INTENT
datadisk-example  compute.v1.disk      IN_PREVIEW  []      CREATE_OR_ACQUIRE
vm-example        compute.v1.instance  IN_PREVIEW  []      CREATE_OR_ACQUIRE

API

ב-API, משתמשים בשיטה insert() עם גוף בקשה שמכיל את השדות target ו-name ואת פרמטר השאילתה preview=true. מזינים את ההגדרה בשדה target.

לדוגמה, בקשת ה-API הבאה מציגה תצוגה מקדימה של תבנית פשוטה:

POST https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments?preview=true

{
 "name": "example-config",
 "target": {
  "config": {
    "content":  "resources:\n- name: vm-created-by-cloud-config\n  type: compute.v1.instance\n  properties:\n    zone: us-central1-a\n    machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/n1-standard-1\n    disks:\n    - deviceName: boot\n      type: PERSISTENT\n      boot: true\n      autoDelete: true\n      initializeParams:\n        diskName: disk-created-by-cloud-config\n        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619\n    networkInterfaces:\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default"
   }
  }
}

כשפריסה נמצאת במצב תצוגה מקדימה, אפשר להמשיך בפריסה באחת משלוש דרכים:

הצגת תצוגות מקדימות מרובות

אם רוצים לשנות את ההגדרה ולבצע תצוגה מקדימה נוספת, משתמשים בפקודה update עם הדגל --preview:

gcloud deployment-manager deployments update example-config \
    --config new-config.yaml --preview

ב-API, שולחים בקשת PUT() עם פריסה קיימת ומספקים את פרמטר השאילתה preview=true. גוף הבקשה צריך להכיל את השדות intent, target ו-name. לדוגמה, בקשת ה-API הבאה מציגה תצוגה מקדימה של עדכון פשוט:

PUT https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments/example-config?preview=true

{
 "target": {
  "config": {
   "content": "resources:\n- name: vm-created-by-cloud-config\n  type: compute.v1.instance\n  properties:\n    zone: us-central1-a\n    machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/n1-standard-1\n    disks:\n    - deviceName: boot\n      type: PERSISTENT\n      boot: true\n      autoDelete: true\n      initializeParams:\n        diskName: disk-created-by-cloud-config\n        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default"
  }
 },
 "name": "example-config"
}

פריסה או ביטול של תצוגה מקדימה

אחרי שצופים בתצוגה מקדימה של פריסה, אפשר להמשיך בפריסה על ידי ביצוע עדכון ואישור התצורה. לדוגמה, נניח שיש לכם פריסה בשם example-config שנמצאת כרגע במצב תצוגה מקדימה. כדי להמשיך בהטמעה, מריצים את הפקודה הבאה:

gcloud deployment-manager deployments update example-config

‫Deployment Manager משתמש בהגדרה האחרונה שהוצגה בתצוגה מקדימה כדי ליצור פריסה.

לחלופין, אם לא רוצים להמשיך בהגדרה, אפשר לבטל את התצוגה המקדימה ואז למחוק את הפריסה:

gcloud deployment-manager deployments cancel-preview example-config

בזמן שפריסה נמצאת במצב תצוגה מקדימה, אי אפשר להמשיך עם הגדרה אחרת. לדוגמה, נניח שיש לכם פריסה בשם example-config שנמצאת במצב תצוגה מקדימה באמצעות הגדרה בשם vm.yaml. אתם מחליטים שאתם רוצים לפרוס הגדרה חדשה בשם two_vms.yaml באותו פריסה, בלי להשתמש בתהליך התצוגה המקדימה. בזמן ש-example-config עדיין במצב תצוגה מקדימה, אי אפשר לפרוס הגדרה חדשה. מבטלים את התצוגה המקדימה ומעדכנים את הפריסה עם ההגדרה החדשה.

המאמרים הבאים