בעזרת 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 הבאים:
- עריכה של מעקב (
roles/monitoring.editor) -
יצירה ושימוש במדיניות התראות שמבוססת על יומנים:
Logs Configuration Writer (
roles/logging.configWriter)
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
במאמר בקרת גישה באמצעות ניהול זהויות והרשאות גישה מוסבר בהרחבה על התפקידים ב-Cloud Monitoring.
עריכה או מחיקה של מדיניות התראות
כדי לערוך או למחוק מדיניות התראות בפרויקט Google Cloud :
מתקינים ומגדירים את Terraform בפרויקט. בהגדרות של App Hub, בוחרים את פרויקט המארח או את פרויקט הניהול של App Hub.
ב-Cloud Shell, עוברים לספרייה שמכילה את ההגדרות של Terraform.
עורכים את קובץ התצורה, מאתרים את המשאב
google_monitoring_alert_policyשל מדיניות ההתראות, ואז משנים או מוחקים את המשאב הזה.ב-Cloud Shell, מזינים את הפקודה
terraform apply.
ייצוא של הגדרת מדיניות התראות להגדרת Terraform
אתם יכולים לייצא הגדרה של מדיניות התראות מ- Google Cloudלהגדרה של Terraform בתצורת Terraform. התהליך הזה שימושי אם יצרתם מדיניות התראה ב- Google Cloudאחרי שיצרתם את ההגדרות של Terraform.
כדי לייצא את מדיניות ההתראות:
מתקינים ומגדירים את Terraform בפרויקט. להגדרות של App Hub, בוחרים את הפרויקט המארח או את פרויקט הניהול של App Hub.
ב-Cloud Shell, עוברים לספרייה שמכילה את ההגדרות של Terraform.
מוסיפים בלוק
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" }ב-Cloud Shell, מריצים את הפקודה הבאה:
terraform plan -generate-config-out=generated.tf
הפקודה הקודמת יוצרת קובץ בשם
generated.tf, שמאפשר לבדוק את ההגדרה של מדיניות ההתראות לפני שמוסיפים אותה להגדרות של Terraform. אתם יכולים לערוך את ההגדרה, להעביר אותה לקובץ אחר או להשאיר אותה ללא שינוי.ב-Cloud Shell, מזינים
terraform applyכדי לייבא את הגדרת מדיניות ההתראות להגדרות של Terraform.
מידע נוסף על יצירת הגדרות למשאבים שלא נכללים בהגדרות של Terraform זמין במאמר יצירת הגדרות.
המאמרים הבאים
- מידע נוסף על Terraform
- אפשר לנסות דוגמאות קוד שמשתמשות ב-Google Cloud Terraform Provider עם Cloud Monitoring.
- Google Cloud המאגר של Terraform Provider ב-GitHub.
- פתיחת בקשות בקשר לבעיות ב-GitHub כדי לדווח על באג או לשאול שאלה לגבי Terraform.