ניהול חלונות זמן לתחזוקה של מופע Apigee

הדף הזה מתייחס ל-Apigee, אבל לא ל-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

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

הגדרת חלון זמן מועדף לתחזוקה

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

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

הערה: 'שבוע 1' ו'שבוע 2' מתייחסים לשלבי ההשקה ולזמני ההודעה המוקדמת (שבוע אחד לעומת שבועיים). המספרים האלה לא מתייחסים לשבוע הראשון או השני ביומן של החודש. לדוגמה, השקה של "שבוע 2" לא בהכרח מתרחשת בשבוע השני של חודש קלנדרי. היא מתרחשת שבוע אחרי ההשקה של 'שבוע 1' עבור הגרסה הספציפית הזו.

  • אם הגדרתם את סדר העדכון לשבוע 1, מערכת Apigee תשלח התראות על תחזוקה לפחות שבוע מראש.
  • אם הגדרתם את סדר העדכון לשבוע 2, מערכת Apigee תשלח התראות על תחזוקה לפחות שבועיים מראש.

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

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

כשמעדכנים את חלון הזמן לתחזוקה, חלון הזמן הקודם יימחק.

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": {
      "maintenanceWindows": [
        {
          "day": "SUNDAY",
          "startTime": {
            "hours": 23
          }
        }
      ],
      "maintenanceChannel": "WEEK1"
    }
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy.maintenanceWindows,maintenanceUpdatePolicy.maintenanceChannel"

כאשר:

  • התחזוקה startTime מוגדרת לפי שעון UTC.
  • ‫maintenanceChannel: הגדרת ערוץ התחזוקה או סדר העדכון (למשל, WEEK1 או WEEK2).
  • ‫ORGANIZATION_ID הוא מזהה הארגון שלכם ב-Apigee.
  • INSTANCE_ID הוא מזהה מופע Apigee.

איך מוצאים הגדרות תחזוקה קיימות ולוחות זמנים לתחזוקה

כדי לאחזר את הגדרות התחזוקה הנוכחיות ולראות אם יש תחזוקה מתוכננת, אפשר לבדוק את השדות maintenanceUpdatePolicy ו-scheduledMaintenance, כמו בדוגמה הבאה של ה-API:

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -H "$AUTH" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID"

כאשר:

  • ‫ORGANIZATION_ID הוא מזהה הארגון שלכם ב-Apigee.
  • INSTANCE_ID הוא מזהה מופע Apigee.

פלט לדוגמה

{
  ...
  "scheduledMaintenance": {
    "startTime": "2025-01-28T23:00:00Z"
  },
  "maintenanceUpdatePolicy": {
    "maintenanceWindows": [
      {
        "day": "SUNDAY",
        "startTime": {
          "hours": 23
        }
      }
    ],
    "maintenanceChannel": "WEEK1"
  }
}

ניקוי הגדרות התחזוקה

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

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": null
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy"

כאשר:

  • ‫ORGANIZATION_ID הוא מזהה הארגון שלכם ב-Apigee.
  • INSTANCE_ID הוא מזהה מופע Apigee.

הסכמה לקבלת התראות לגבי פעולות תחזוקה

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

  1. במסוף Google Cloud , נכנסים לדף User preferences > Communication.

    מעבר אל 'תקשורת'

  2. בשורה של Apigee, חלון זמן לתחזוקה, לוחצים על כפתור הבחירה שמתחת לEmail כדי להעביר אותו למצב On.

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