ניהול מדיניות ההתראות באמצעות Terraform

בעזרת Google Cloud Terraform Provider אתם יכולים לערוך, למחוק ולייצא מדיניות התראות בפרויקט ב- Google Cloud . כדי להגדיר מדיניות התראות וערוצי התראות, משתמשים במשאבים google_monitoring_alert_policy ו-google_monitoring_notification_channel.

‫Terraform משתמשת בקובצי תצורה כדי לבנות, לשנות ולנהל גרסאות של הרכיבים שנדרשים להפעלת אפליקציה יחידה או התשתית כולה. מידע נוסף על השימוש ב-Terraform זמין במסמכי התיעוד של Terraform ב- Google Cloud , במאמרי העזרה של Google Cloud Terraform Provider ובמאמר תחילת העבודה – Google Cloud.

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

כדי לקבל את ההרשאות שדרושות לשינוי של מדיניות התראות באמצעות Terraform, צריך לבקש מהאדמין להקצות לכם בפרויקט את תפקידי ה-IAM הבאים:

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

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

במאמר בקרת גישה באמצעות ניהול זהויות והרשאות גישה מוסבר בהרחבה על התפקידים ב-Cloud Monitoring.

עריכה או מחיקה של מדיניות התראות

כדי לערוך או למחוק מדיניות התראות בפרויקט Google Cloud :

  1. מתקינים ומגדירים את Terraform בפרויקט. בהגדרות של App Hub, בוחרים את פרויקט המארח או את פרויקט הניהול של App Hub.

  2. ב-Cloud Shell, עוברים לספרייה שמכילה את ההגדרות של Terraform.

  3. עורכים את קובץ התצורה, מאתרים את המשאב google_monitoring_alert_policy של מדיניות ההתראות, ואז משנים או מוחקים את המשאב הזה.

  4. ב-Cloud Shell, מזינים את הפקודה terraform apply.

ייצוא של הגדרת מדיניות התראות להגדרת Terraform

אתם יכולים לייצא הגדרה של מדיניות התראות מ- Google Cloudלהגדרה של Terraform בתצורת Terraform. התהליך הזה שימושי אם יצרתם מדיניות התראה ב- Google Cloudאחרי שיצרתם את ההגדרות של Terraform.

כדי לייצא את מדיניות ההתראות:

  1. מתקינים ומגדירים את Terraform בפרויקט. להגדרות של App Hub, בוחרים את הפרויקט המארח או את פרויקט הניהול של App Hub.

  2. ב-Cloud Shell, עוברים לספרייה שמכילה את ההגדרות של Terraform.

  3. מוסיפים בלוק import לקובץ בהגדרות ב-Terraform. בלוק הייבוא כולל את הארגומנטים הבאים:

    • ‫to: כתובת המשאב כפי שצוינה בהגדרות של Terraform. הפורמט של השדה הזה הוא google_monitoring_alert_policy.RESOURCE_NAME, כאשר RESOURCE_NAME הוא ערך שאתם בוחרים. מומלץ לבחור שם משאב שמתאר בבירור את מדיניות ההתראות.

    • id: השם של מדיניות ההתראות. השדה הזה הוא בפורמט project/PROJECT_ID/alertPolicies/ALERT_POLICY_ID.

    לדוגמה, אם רוצים לייצא מדיניות התראות שעוקבת אחרי השימוש במעבד, צריך להגדיר את RESOURCE_NAME לערך cpu_usage_threshold. לאחר מכן מגדירים את id כשם של מדיניות ההתראות:

    import {
    to = google_monitoring_alert_policy.cpu_usage_threshold
    id = "projects/my-alerting-project/alertPolicies/7160801095019277297"
    }
    
  4. ב-Cloud Shell, מריצים את הפקודה הבאה:

    terraform plan -generate-config-out=generated.tf
    

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

  5. ב-Cloud Shell, מזינים terraform apply כדי לייבא את הגדרת מדיניות ההתראות להגדרות של Terraform.

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

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