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

תצוגה מקדימה

השימוש בתכונה הזו כפוף לתנאי השימוש במוצרים בשלב טרום-GA, שמפורטים בחלק "תנאי שירות הכלליים" בתנאים הספציפיים של השירות. השימוש בתכונות בגרסת טרום-GA הוא "כפי שהן" (As is), ויכול להיות שהתמיכה בהן תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

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

אפשר להגדיר חלונות זמן לתחזוקה במכונות של Cloud Data Fusion בגרסה 6.8.0 ואילך.

מידע על חלונות זמן לתחזוקה

חלון זמן לתחזוקה ב-Cloud Data Fusion הוא פרק זמן שבו אתם מאפשרים לבצע פעולות תחזוקה, כדי להפחית את הסיכון לשיבושים בשירות בזמני שיא של שימוש. כדי לצמצם את ההשפעה של חלונות הזמן לתחזוקה על המכונות של Cloud Data Fusion ועל הפעלות צינורות עיבוד הנתונים, כדאי לתזמן אותם לשעות שבהן הפעילות נמוכה.

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

• אם חלון הזמן לתחזוקה מוגדר, פעולות התחזוקה מבוצעות על ידי Cloud Data Fusion בפרקי הזמן שהוגדרו.
• אם לא מוגדר חלון זמן לתחזוקה, אפשר לבצע תחזוקה בכל זמן.

מידע על פעולות תחזוקה

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

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

• במהלך חלון הזמן לתחזוקה, יכול להיות שפעולות מסוימות יושפעו. מומלץ להגדיר חלונות זמן לתחזוקה בשעות שבהן השימוש לא בשיא. פעולת התחזוקה יכולה להשפיע על Cloud Data Fusion בדרכים הבאות:

  • יכול להיות שממשק Cloud Data Fusion Studio לא יהיה זמין באופן זמני.
  • יכול להיות שההפעלה של צינור עיבוד הנתונים תושפע, ותגרום לכשל.
  • יכול להיות ששירותי Cloud Data Fusion מושבתים באופן זמני, ולכן הקריאות ל-API נכשלות.
  • יכול להיות שהמכונות לא יפעלו באופן מלא במשך עד שעה במהלך חלון הזמן לתחזוקה. מומלץ להגדיר חלונות זמן לתחזוקה כשהצינורות לא פועלים או לא מתוזמנים לפעול.

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

איך מציינים חלונות זמן לתחזוקה כשיוצרים מכונה

המסוף

כדי להגדיר את חלון הזמן לתחזוקה כשיוצרים מכונה:

1. נכנסים לדף Instances ב-Cloud Data Fusion ולוחצים על Create instance.

   יצירת מכונה

2. מזינים את Instance name ואת Edition. למידע נוסף על כל שדה, קראו את המאמר יצירת מכונה.
3. מרחיבים את הקטע אפשרויות מתקדמות.
4. מרחיבים את הקטע תחזוקה ופועלים לפי השלבים הבאים:
   1. מסמנים את התיבה Enable maintenance window.
   2. בשדה שעת התחלה, מזינים שעה בפורמט נתמך.
   3. ברשימה TimeZone, בוחרים אזור זמן.
   4. ברשימות Days ו-Length, בוחרים את הימים בשבוע ואת משך הזמן של החלון. מידע נוסף על ההגדרות האלה זמין במאמר מידע על פעולות תחזוקה.
   5. לוחצים על יצירה.

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

‫API בארכיטקטורת REST

1. מגדירים את Instance באמצעות ה-API של instance.create:

{
  "name": string,
  "description": string,
  …
  …
  "maintenancePolicy": {
    "maintenanceWindow": {
      "recurringTimeWindow": {
        "window": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
        },
        "recurrence": "MAINTENANCE_RECURRENCE"
      }
    },
  }
}

מחליפים את מה שכתוב בשדות הבאים:

• ‫START_TIME: שעת ההתחלה של חלון הזמן, בפורמט RFC 3339.
• ‫END_TIME: שעת הסיום של חלון הזמן, בפורמט RFC 3339.

• ‫MAINTENANCE_RECURRENCE: RRULE לחזרה של חלון הזמן לתחזוקה. ב-Cloud Data Fusion יש תמיכה רק בפורמטים הבאים:

  • ‫FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA או BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. השדה הזה מציין את החזרה השבועית של החלון בימים שנבחרו, החל מ-startTime, ולמשך הזמן שצוין.

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

בדוגמה הבאה נוצר מכונה עם חלון זמן לתחזוקה של שש שעות בין 10:00 ל-16:00 (UTC) בשבת ובראשון בכל שבוע. מידע נוסף זמין במאמרי העזרה של ה-API של המכונות.

// POST https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances?instanceID=example-instance

{
  "maintenancePolicy": {
      "maintenanceWindow": {
          "recurringTimeWindow": {
              "window": {
                  "startTime": "2024-01-01T10:00:00Z",
                  "endTime": "2024-01-01T16:00:00Z",
              },
              "recurrence": "FREQ=WEEKLY;BYDAY=SA,SU"
          }
      },
  }
}

gcloud

אפשר לציין את חלון הזמן לתחזוקה כשיוצרים מכונה באמצעות הפקודה gcloud beta data-fusion instances create.

צריך להגדיר את הפרמטרים הבאים לחלון זמן לתחזוקה:

• --maintenance-window-start מגדיר את שעת ההתחלה של החלון.
• --maintenance-window-end מגדיר את שעת הסיום של החלון.
• ‫--maintenance-window-recurrence מגדיר RRULE לחזרה של חלון הזמן לתחזוקה.

gcloud beta data-fusion instances create INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

מחליפים את מה שכתוב בשדות הבאים:

• ‫INSTANCE_NAME: שם המכונה.
• ‫PROJECT_NAME: שם הפרויקט.
• ‫LOCATION: שם האזור של המכונה.
• ‫START_TIME: שעת ההתחלה של החלון בפורמט הקלט של תאריך/שעה. המערכת משתמשת רק בשעה שצוינה ומתעלמת מהתאריך שצוין.
• ‫END_TIME: שעת הסיום של החלון בפורמט הקלט של תאריך/שעה. המערכת משתמשת רק בשעה שצוינה ומתעלמת מהתאריך שצוין. התאריך והשעה שצוינו צריכים להיות אחרי שעת ההתחלה.

• ‫MAINTENANCE_RECURRENCE: RRULE לחזרה של חלון הזמן לתחזוקה. ב-Cloud Data Fusion יש תמיכה רק בפורמטים הבאים:

  • ‫FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA או BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. השדה הזה מציין את החזרה השבועית של החלון בימים שנבחרו, החל מהשעה --maintenance-window-start ולמשך הזמן שצוין.

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

הפקודה הבאה יוצרת מכונה עם חלון זמן לתחזוקה של שש שעות בין 12:00 ל-18:00 (UTC) בשבת ובראשון בכל שבוע.

gcloud beta data-fusion instances create example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'

עדכון חלונות הזמן לתחזוקה של מכונה

המסוף

כדי לעדכן את חלון הזמן לתחזוקה במכונה קיימת במסוףGoogle Cloud :

1. נכנסים לדף Instances של Cloud Data Fusion.

   כניסה לדף Instances

2. לוחצים על שם המכונה כדי לראות את הפרטים שלה.

3. בדף Instance details, עוברים לשדה חלון זמן לתחזוקה ולוחצים על Edit.

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

   1. מסמנים את התיבה Enable maintenance window.
   2. בשדה שעת התחלה, מזינים שעה בפורמט נתמך.
   3. ברשימה TimeZone, בוחרים אזור זמן.
   4. ברשימות Days ו-Length, בוחרים את ימי השבוע ואת משך הזמן של החלון. מידע נוסף על ההגדרות האלה זמין במאמר מידע על פעולות תחזוקה.

5. לוחצים על Save.

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

‫API בארכיטקטורת REST

במכונות קיימות, מעדכנים את חלונות הזמן לתחזוקה באמצעות בקשת ה-API‏ instances.patch. הפעולה הזו מבטלת את ההגדרה הקיימת של חלון הזמן לתחזוקה, אם היא קיימת. אחרת, תוגדר תצורה חדשה, כפי שצוין בגוף הבקשה.

יוצרים בקשת API באופן הבא:

1. בפרמטר updateMask, מציינים את המסכה maintenance_policy.
2. בגוף הבקשה, מציינים את חלון הזמן לתחזוקה בהגדרת מדיניות התחזוקה:

{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

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

בדוגמה הבאה מעדכנים את הגדרת מדיניות התחזוקה של המכונה, עם חלון זמן לתחזוקה של ארבע שעות בין 11:00 ל-15:00 (UTC) בימים שישי, שבת וראשון בכל שבוע.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
"maintenancePolicy": {
  "maintenanceWindow": {
    "recurringTimeWindow": {
      "window": {
          "startTime": "2024-01-01T11:00:00Z",
          "endTime": "2024-01-01T15:00:00Z",
        },
      "recurrence": "FREQ=WEEKLY;BYDAY=FR,SA,SU"
    }
  },
}
}

gcloud

אפשר לעדכן את חלון הזמן לתחזוקה של מכונה באמצעות הפקודה gcloud beta data-fusion instances update.

צריך להגדיר את הפרמטרים הבאים לחלון זמן לתחזוקה:

• --maintenance-window-start מגדיר את שעת ההתחלה של החלון.
• --maintenance-window-end מגדיר את שעת הסיום של החלון.
• ‫--maintenance-window-recurrence מגדיר RRULE לחזרה של חלון הזמן לתחזוקה.

gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

מחליפים את מה שכתוב בשדות הבאים:

• ‫INSTANCE_NAME: שם המכונה.
• ‫PROJECT_NAME: שם הפרויקט.
• ‫LOCATION: שם האזור של המכונה.
• ‫START_TIME: שעת ההתחלה של החלון בפורמט הקלט של תאריך/שעה. המערכת משתמשת רק בשעה שצוינה ומתעלמת מהתאריך שצוין.
• ‫END_TIME: שעת הסיום של החלון בפורמט הקלט של תאריך/שעה. המערכת משתמשת רק בשעה שצוינה ומתעלמת מהתאריך שצוין. התאריך והשעה שצוינו צריכים להיות אחרי שעת ההתחלה.

• ‫MAINTENANCE_RECURRENCE: RRULE לחזרה של חלון הזמן לתחזוקה. ב-Cloud Data Fusion יש תמיכה רק בפורמטים הבאים:

  • ‫FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA או BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. השדה הזה מציין את החזרה השבועית של החלון בימים שנבחרו, החל מהשעה --maintenance-window-start ולמשך הזמן שצוין.

הפקודה הבאה מעדכנת את המכונה example-instance עם חלון זמן לתחזוקה של שש שעות בין 12:00 ל-18:00 (UTC) בשבת ובראשון בכל שבוע.

gcloud beta data-fusion instances update example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'

הגדרת זמנים לחלון הזמן לתחזוקה וחזרה (RRULE)

כשמגדירים את זמני ההתחלה והסיום של חלון הזמן לתחזוקה, המערכת מתעלמת מרכיבי התאריך של חותמות הזמן שצוינו. המערכת מתחשבת רק בשעה ביום ובמשך הזמן בין שעת ההתחלה לשעת הסיום. השעות מאוחסנות ב-UTC, אבל אפשר להשתמש ב-UTC או בהיסט של אזור הזמן כשמתזמנים חלונות זמן לתחזוקה באמצעות ה-API בארכיטקטורת REST או ה-CLI של gcloud.

כשמגדירים חזרה, חשוב לזכור ש-RRULE פועל לפי ימים ב-UTC, אז צריך להתאים את ההגדרה אם אזור הזמן שלכם שונה. לדוגמה, אם אזור הזמן שלכם הוא PDT (UTC-7) ואתם רוצים שחלון הזמן לתחזוקה יתחיל בשעה 21:00 בימי רביעי באזור הזמן שלכם (שמקבילה לשעה 4:00 UTC בימי חמישי), ציינו TH במקום WE באפשרות BYDAY של ה-RRULE.

חשוב: מומלץ מאוד להשתמש ב-UTC כשמציינים חלון זמן לתחזוקה באמצעות ה-API בארכיטקטורת REST או ה-CLI של gcloud.

הסרת חלון הזמן לתחזוקה של מכונה

המסוף

כדי להסיר את חלון הזמן לתחזוקה במכונה קיימת במסוףGoogle Cloud :

1. נכנסים לדף Instances של Cloud Data Fusion.

   כניסה לדף Instances

2. לוחצים על שם המכונה כדי לראות את הפרטים שלה.

3. בדף Instance details, עוברים לשדה חלון זמן לתחזוקה ולוחצים על Edit.

4. כדי להסיר את חלון הזמן לתחזוקה מהמכונה, מבטלים את הסימון בתיבה Enable maintenance window.

5. לוחצים על Save.

‫API בארכיטקטורת REST

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

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
    "maintenancePolicy": {}
}

gcloud

כדי להסיר את חלון הזמן לתחזוקה ממכונה, משתמשים בפקודה gcloud beta data-fusion instances update עם הדגל --clear-maintenance-window.

gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --clear-maintenance-window

מחליפים את מה שכתוב בשדות הבאים:

• ‫INSTANCE_NAME: שם המכונה.
• ‫PROJECT_NAME: שם הפרויקט.
• ‫LOCATION: שם האזור של המכונה.

צפייה באירועי תחזוקה וקבלת התראות

ב-Cloud Data Fusion, אירועי תחזוקה מתוזמנים של המכונות מדווחים דרך Unified Maintenance. כדי לראות את האירועים האלה ולקבל עליהם התראות, צריך להגדיר כל אחד מהם בנפרד:

• כדי לראות את אירועי התחזוקה בדף Maintenance ב-Cloud Hub במסוף Google Cloud , או כדי לשלוח שאילתות ישירות ל- Unified Maintenance API, צריך להפעיל את ה-API בפרויקט.
• כדי לקבל התראות, צריך להגדיר מדיניות התראות מבוססות-יומנים ב-Cloud Logging. הפעלת ה-API לא גורמת להרשמה להתראות.

הפעלת Unified Maintenance API

כדי לראות אירועי תחזוקה במסוף Google Cloud , צריך להפעיל בפרויקט את Unified Maintenance API‏ (maintenance.googleapis.com). ב-Unified Maintenance לא מוצגים אירועים היסטוריים שתוזמנו לפני שהפעלתם את ה-API.

המסוף

1. ב-API Library, נכנסים לדף Maintenance API.

   כניסה ל-Maintenance API

2. לוחצים על Enable.

gcloud

משתמשים בפקודה gcloud services enable:

gcloud services enable maintenance.googleapis.com \
    --project=PROJECT_ID

מחליפים את PROJECT_ID במזהה הפרויקט.

הגדרת התראות

הכלי "תחזוקה מאוחדת" כותב באופן אוטומטי יומני אירועי תחזוקה עם מזהה היומן maintenance.googleapis.com/maintenance_events ב-Logging, גם אם Unified Maintenance API לא מופעל. כדי לקבל התראות בערוצים כמו אימייל, Pub/Sub,‏ Slack,‏ PagerDuty או לפעולות לפיתוח, צריך ליצור מדיניות התראות מבוססות-יומנים שתואמת ליומנים האלה. למידע נוסף, קראו את המאמר הגדרת התראות.

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

• עיינו במאמרי העזרה של ה-API של המכונות.
• איך רואים את פעילויות התחזוקה ב-Cloud Hub
• איך מגדירים התראות לאירועי תחזוקה
• מידע נוסף על Unified Maintenance