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

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

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

בדף הזה אנחנו מניחים שאתם מכירים את Terraform. פרטים נוספים זמינים במאמר בנושא Terraform ו-Infrastructure Manager.

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

  1. מפעילים את Infra Manager.
  2. מוודאים שיש לכם את הרשאות ה-IAM שנדרשות לייצוא תצוגות מקדימות: roles/config.admin.
  3. יוצרים פריסת תצוגה מקדימה.

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

כדי לבדוק את התוצאות של תצוגה מקדימה, צריך קודם לייצא את התוצאות. לאחר מכן, צופים בתוצאות המיוצאות באמצעות כלי מתאים.

כדי לייצא תצוגה מקדימה, המצב שלה צריך להיות SUCCEEDED או STALE. אפשר לראות את המצב הנוכחי של תצוגה מקדימה באמצעות הפקודות describe או list.

מייצאים את התוצאות של התצוגה המקדימה ושומרים אותן באופן מקומי באמצעות הפקודה הבאה:

gcloud infra-manager previews export projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

מחליפים את:

  • ‫PROJECT_ID: מזהה הפרויקט שבו פועל Infrastructure Manager.
  • ‫LOCATION: המיקום שבו פועל Infra Manager. ראו מיקומי Infrastructure Manager לקבלת רשימת המיקומים התקפים.
  • ‫PREVIEW_ID: מזהה התצוגה המקדימה שציינתם. פרטים על אילוצים לגבי מזהה התצוגה המקדימה מופיעים בקטע שם התצוגה המקדימה.

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

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

בדיקת קובץ התוכנית הבינארי

כדי להציג את קובץ התוכנית הבינארי:

  1. מוודאים שTerraform CLI מותקן.

  2. מוודאים שההגדרות של Terraform שבהן השתמשתם כדי ליצור את התצוגה המקדימה נמצאות באופן מקומי ועברו הפעלה באמצעות terraform init.

  3. מדפיסים את התוכנית המוצעת באמצעות terraform show.

בדיקת הייצוג ב-JSON

כדי לראות את הייצוג ב-JSON, אפשר להשתמש בסביבת הפיתוח המשולבת (IDE) או בכלים כמו jq.

כדי לאכוף אילוצי מדיניות, אפשר להשתמש בייצוג JSON עם כלים כמו Terraform vet.

הצגת פרטים על שינויים וסחף במשאבים

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

כשיוצרים תצוגה מקדימה, משתמשים ב-Infra Manager API כדי לראות את השינויים במשאבים בזמן שמעדכנים את הפריסות.

הצגת שינויים במשאבים

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

gcloud infra-manager resource-drifts list --preview=projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

מחליפים את:

  • ‫PROJECT_ID: המזהה של Google Cloud הפרויקט שבו נמצאת פריסת התצוגה המקדימה.
  • ‫LOCATION: האזור או התחום של פריסת התצוגה המקדימה.
  • ‫PREVIEW_ID: המזהה של פריסת התצוגה המקדימה.

הצגת פרטים של סחף

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

gcloud infra-manager resource-drifts describe projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID/resourceDrifts/RESOURCE_DRIFT_ID

מחליפים את:

  • ‫PROJECT_ID: המזהה של Google Cloud הפרויקט שבו נמצאת פריסת התצוגה המקדימה.
  • ‫LOCATION: האזור או התחום של פריסת התצוגה המקדימה.
  • ‫PREVIEW_ID: המזהה של פריסת התצוגה המקדימה.
  • ‫RESOURCE_DRIFT_ID: המזהה של הסחף.

תצוגה מקדימה של שינויים במשאבים

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

צפייה בשינויים במשאבים

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

gcloud infra-manager resource-changes list --preview=projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID

מחליפים את:

  • ‫PROJECT_ID: המזהה של Google Cloud הפרויקט שבו נמצאת פריסת התצוגה המקדימה.
  • ‫LOCATION: האזור או התחום של פריסת התצוגה המקדימה.
  • ‫PREVIEW_ID: המזהה של פריסת התצוגה המקדימה.

הצגת הפרטים של שינוי במשאב

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

gcloud infra-manager resource-changes describe projects/PROJECT_ID/locations/LOCATION/previews/PREVIEW_ID/resourceChanges/RESOURCE_CHANGE_ID

מחליפים את:

  • ‫PROJECT_ID: המזהה של Google Cloud הפרויקט שבו נמצאת פריסת התצוגה המקדימה.
  • ‫LOCATION: האזור או התחום של פריסת התצוגה המקדימה.
  • ‫PREVIEW_ID: המזהה של פריסת התצוגה המקדימה.
  • RESOURCE_CHANGE_ID: המזהה של שינוי המשאב.

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