ניהול תיקוני גרסאות של מופעים

בדף הזה מפורטים מידע והנחיות לניהול עדכוני תיקונים במופע של Cloud Data Fusion.

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

תיקוני הפאצ' כוללים עדכוני אבטחה קריטיים ותיקוני באגים במופעים שלכם. תיקון (patch) חל רק על הפלטפורמה בלי לשנות את צינורות העיבוד או את התוספים. תהליך השדרוג כולל השבתה של המכונה ושל צינור הנתונים.

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

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

  • לפני שמשדרגים לגרסת תיקון, כדאי לעיין בהערות לגבי הגרסה כדי לקבל מידע על התיקונים הספציפיים שהיא כוללת. חשוב להבין איך הם יכולים להשפיע על המקרים שלכם.
  • מכינים את הסביבה:
    • מגדירים זמן השבתה לתיקון.
    • מומלץ: לפני השדרוג, צריך להפסיק את כל צינורות הנתונים הפעילים ולהשבית את כל הטריגרים במעלה הזרם, כמו טריגרים של Managed Service for Apache Airflow. כשהשדרוג מתחיל, כל צינורות הנתונים הפעילים מפסיקים לפעול.

שדרוג מופע לעומת תיקון גרסה

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

שדרוג לגרסת תיקון של מכונת Cloud Data Fusion

כדי לשדרג לגרסת תיקון של מופע Cloud Data Fusion, פועלים לפי השלבים הבאים במסוף Google Cloud , ב-Google Cloud CLI או ב-API בארכיטקטורת REST.

המסוף

  1. במסוף Google Cloud , נכנסים לדף Cloud Data Fusion.

  2. לוחצים על Instances (מכונות) ומסמנים את התיבה לצד שם המכונה.

    כניסה לדף Instances

  3. לוחצים על שדרוג.

  4. בוחרים את הגרסה האחרונה של התיקון ולוחצים על שדרוג.

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

  6. כדי לוודא שהשדרוג בוצע בהצלחה, במסוף Google Cloud , טוענים מחדש את הדף Instance details. בודקים את השדה Version (גרסה) כדי לראות את העדכון.

gcloud

  1. כדי לעדכן לגרסת תיקון זמינה, מריצים את הפקודה הבאה ב-CLI של gcloud מטרמינל מקומי או מסשן של Cloud Shell:

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=AVAILABLE_PATCH_REVISION

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

    • ‫INSTANCE_ID: השם של המכונה.
    • ‫PROJECT_ID: מזהה הפרויקט שמכיל את מכונת Cloud Data Fusion.
    • ‫LOCATION_NAME: המיקום של המכונה.
    • ‫CURRENT_INSTANCE_VERSION: הגרסה הנוכחית.

    • ‫AVAILABLE_PATCH_REVISION: גרסת התיקון של הטלאי שאליו רוצים לשדרג.

    • אופציונלי: אם רלוונטי למופע שלכם, מוסיפים את הדגלים --enable_stackdriver_logging, --enable_stackdriver_monitoring, ו- ‎--labels.

    • אופציונלי: אפשר להעביר את מאפייני CDAP, כמו enable.unrecoverable.reset, בתור ‎--options.

    למידע נוסף, אפשר לעיין במדריך העזר ל-CLI של gcloud.

  2. כדי לוודא שהשדרוג הצליח, פועלים לפי השלבים הבאים:

    1. כדי לקבל את פרטי המופע, מריצים את הפקודה הבאה ב-CLI של gcloud ממסוף מקומי או מסשן של Cloud Shell:

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. בודקים שהשדה PATCH_REVISION בפרטי המופע עודכן לגרסה שצוינה.

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

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

דוגמאות

בדוגמאות הבאות מוצגות דרכים לשדרוג של מופע לגרסת תיקון באמצעות ה-API בארכיטקטורת REST.

שדרוג מכונה לגרסה ספציפית של תיקון

מבצעים קריאה ל-patch():

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

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

  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את מכונת Cloud Data Fusion.
  • ‫LOCATION_NAME: המיקום של המכונה.
  • ‫INSTANCE_ID: השם של המכונה.

משתמשים בתוכן הבקשה הבא בפורמט JSON:

{
  "version": VERSION_NUMBER,
  "patchRevision": PATCH_REVISION_NUMBER
}

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

לדוגמה, כדי לשדרג מופע בגרסה 6.7.3 לתיקון 6.7.3.1, משתמשים בגוף הבקשה הבא בפורמט JSON:

{
  "version": 6.7.3,
  "patchRevision": 6.7.3.1
}

שדרוג מכונה לגרסת תיקון ברירת המחדל

מבצעים קריאה ל-patch():

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

משתמשים בתוכן הבקשה הבא בפורמט JSON:

{
  "version": VERSION_NUMBER
}

מחליפים את VERSION_NUMBER בגרסה של המופע, כמו 6.7.3:

{
  "version": 6.7.3
}

חזרה לגרסה קודמת של תיקון

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

gcloud

  1. כדי לחזור לגרסה קודמת של תיקון, מריצים את הפקודה הבאה ב-CLI של gcloud מטרמינל מקומי או מסשן של Cloud Shell:

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=STABLE_PATCH_REVISION

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

    • ‫INSTANCE_ID: השם של המכונה.
    • ‫PROJECT_ID: מזהה הפרויקט שמכיל את מכונת Cloud Data Fusion.
    • ‫LOCATION_NAME: המיקום של המכונה.
    • ‫CURRENT_INSTANCE_VERSION: הגרסה הנוכחית.

    • ‫STABLE_PATCH_REVISION: מספר הגרסה של התיקון שרוצים לחזור אליו.

    • אופציונלי: אם רלוונטי למופע שלכם, מוסיפים את הדגלים --enable_stackdriver_logging, --enable_stackdriver_monitoring, ו- ‎--labels.

    • אופציונלי: אפשר להעביר את מאפייני CDAP, כמו enable.unrecoverable.reset, בתור ‎--options.

    למידע נוסף, אפשר לעיין במדריך העזר ל-CLI של gcloud.

  2. כדי לוודא שהחזרה לגרסה הקודמת הצליחה:

    1. כדי לקבל את פרטי המופע, מריצים את הפקודה הבאה ב-CLI של gcloud ממסוף מקומי או מסשן של Cloud Shell:

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. בודקים שהשדה PATCH_REVISION בפרטי המופע חזר לגרסה שצוינה.

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

כדי לבטל תיקון גרסה במכונת Cloud Data Fusion, מפעילים את ה-method patch(). מגדירים את השדה patchRevision בבקשה לכל תיקון יציב קודם.

דוגמה

בדוגמה הזו מוצג איך להחזיר למצב קודם (roll back) מכונה מגרסת התיקון 6.7.3.1 לגרסת התיקון 6.7.3 באמצעות ה-API בארכיטקטורת REST.

מבצעים קריאה ל-patch():

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

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

  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את מכונת Cloud Data Fusion.
  • ‫LOCATION_NAME: המיקום של המכונה.
  • ‫INSTANCE_ID: השם של המכונה.

משתמשים בתוכן הבקשה הבא בפורמט JSON:

{
  "version": VERSION_NUMBER,
  "patchRevision": STABLE_PATCH_REVISION
}

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

לדוגמה, כדי להחזיר את המופע מתיקון הגרסה 6.7.3.1 לתיקון הגרסה 6.7.3, משתמשים בגוף הבקשה הבא בפורמט JSON:

{
  "version": 6.7.3,
  "patchRevision": 6.7.3
}

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