ניהול חלונות זמן לתחזוקה של מופע 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.

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