תכנון של סדרת שחזורים

במאמר הזה מוסבר איך ליצור, לערוך ולמחוק תוכנית שחזור ב-Google Distributed Cloud (GDC)‎ עם air gap.

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

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

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

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

בקשת תפקידים ב-IAM

כדי ליצור תוכנית שחזור, בקשו ממנהל החשבון הארגוני שלכם ב-IAM להקצות לכם את התפקיד אדמין גיבוי של אשכול משתמשים (user-cluster-backup-admin). התפקיד הזה יוצר, מקבל, מציג, צופה, מעדכן, מתקן ומוחק משאבי גיבוי כמו תוכניות גיבוי ותוכניות שחזור באשכולות של משתמשים.

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

אזהרה: בגלל בעיה מוכרת שמתרחשת כשיוצרים תוכניות שחזור באמצעות מסוף GDC או ה-API, אל תשתמשו באפשרות All namespaced resources או בשדה ה-API‏ allNamespaces. במקום זאת, השתמשו באפשרות Selected namespaced resources או בשדה ה-API‏ selectedNamespaces כדי לשחזר מרחבי שמות של משתמשים.

יצירת תוכנית שחזור

יוצרים תוכנית שחזור באמצעות מסוף GDC או ה-API.

המסוף

1. נכנסים למסוף GDC.
2. בתפריט הניווט, לוחצים על Backup for Clusters.
3. לוחצים על Create Restore Plan.
4. בקטע Restore plan basics, מבצעים את הפעולות הבאות ולוחצים על Next:
   1. בקטע Restore plan name, מזינים את שם תוכנית השחזור.
   2. (אופציונלי) בשדה Restore plan description, מזינים תיאור לתוכנית השחזור.
   3. ברשימה Source cluster, בוחרים את אשכול המקור לתוכנית השחזור.
   4. ברשימה Project, בוחרים את הפרויקט של תוכנית השחזור.
   5. בוחרים את הפרויקט שמצורף לאשכול המקור.
   6. בשדה תוכנית גיבוי, בוחרים תוכנית גיבוי לאשכול קיים שתואמת לגיבויים שרוצים לשחזר.
   7. בשדה Target cluster, בוחרים את אשכול היעד שבו רוצים לשחזר את הגיבוי.
5. בקטע Choose namespaced resources, מבצעים את הפעולות הבאות ולוחצים על Next:
   1. בוחרים אילו מרחבי שמות לשחזר:
      1. לוחצים על Selected namespaced resources כדי לציין את מרחבי השמות בגיבוי שרוצים לשחזר.
         1. לוחצים על Edit cluster namespaces ואז על Add cluster namespace כדי להזין מרחב שמות.
      2. לוחצים על Selected protected applications כדי להוסיף משאבים על ידי ציון מרחב השמות ושם האפליקציה.
   2. בוחרים איך לטפל בהתנגשויות:
      1. לוחצים על Fail on conflict (non-destructive) כדי שהשחזור ייכשל אם מרחבי השמות שמיועדים לשחזור מגיבוי כבר קיימים באשכול היעד.
      2. לוחצים על Rollback (destructive) כדי למחוק את מרחבי השמות הקיימים לפני שמשחזרים את מרחבי השמות החדשים, אם מרחבי שמות כלשהם שמיועדים לשחזור מגיבוי כבר קיימים באשכול היעד.
   3. בוחרים איך לשחזר את נתוני הנפח:
      1. לוחצים על Provision new volumes and restore volume data from backup כדי לשחזר את נתוני אמצעי האחסון מהגיבוי בדיסק אחסון מתמיד חדש.
      2. לוחצים על Don't restore volume data כדי להקצות נפח אחסון מתמיד חדש. אם אשכול היעד מכיל אמצעי אחסון קבוע לא מאוגד שעומד בדרישות של PersistentVolumeClaim, האשכול מאוגד לאמצעי האחסון.
      3. לוחצים על Reuse existing volumes containing your data כדי לא לשחזר את נתוני הגיבוי של אמצעי האחסון. כל PersistentVolumeClaims קשורים לאמצעי אחסון שמפנים לדיסקים קיימים מסוג Persistent Disk.
6. אופציונלי: בקטע Choose cluster-scoped resources, מבצעים את הפעולות הבאות ולוחצים על Next:
   1. לוחצים על Don't restore cluster-scoped resources כדי להשאיר את הגרסה הקיימת של המשאב ללא שינוי.
   2. כדי לשחזר את המשאבים האלה, לוחצים על Restore cluster-scoped resources לפי GroupKind.
      1. לוחצים על Edit GroupKinds כדי להוסיף עוד משאבים ברמת האשכול. מזינים את קבוצת ה-API ואת סוג האובייקט כדי להתאים משאבים בסוגים האלה.
   3. לוחצים על Preserve existing resources כדי ליצור משאבים אם הם לא קיימים באשכול היעד.
   4. לוחצים על Overwrite resources in target cluster כדי למחוק משאב אם הוא כבר קיים באשכול היעד, ולשחזר את העותק מהגיבוי.
7. אופציונלי: בקטע Add substitution rules, מבצעים את השלבים הבאים ולוחצים על Next:
   1. לוחצים על הוספת כלל חדש.
   2. בתיבה Cluster namespaces, מקלידים רשימה של מרחבי שמות כדי להתאים משאבים בתוך מרחבי השמות האלה.
   3. כדי להוסיף GroupKinds, לוחצים על Add GroupKind ומזינים את API group ואת Object kind כדי להתאים משאבים בתוך הסוגים האלה.
   4. בשדה JSON path, מקלידים את נתיב ה-JSON שמזהה את השדות במשאבים התואמים שעליהם חלה ההחלפה.
   5. בשדה תבנית הערך המקורי, מקלידים את התבנית המקורית להשוואה עם הערך החדש.
   6. בשדה ערך חדש, מקלידים את הערך החדש שיחליף את הערך הנוכחי של המאפיינים התואמים.
   7. לוחצים על Save.
8. לוחצים על יצירה.

API

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

apiVersion: backup.gdc.goog/v1
kind: ClusterRestorePlan
metadata:
  name: RESTORE_PLAN_NAME
  namespace:  PROJECT_NAME
spec:
  targetCluster:
    targetClusterType: UserCluster
    targetClusterName:
      kind: "Cluster"
      name: CLUSTER_NAME
  description: RESTORE_PLAN_DESCRIPTION
  clusterBackupPlanName: CLUSTER_BACKUP_PLAN_NAME
  clusterRestoreConfig:
    volumeDataRestorePolicy: RestoreVolumeDataFromBackup
    clusterResourceConflictPolicy: UseBackupVersion
    namespacedResourceRestoreMode: DeleteAndRestore
    namespacedResourceRestoreScope:
      selectedNamespaces:
        namespaces: [NAME_SPACE]
    clusterBackupRepositoryRef: CLUSTER_BACKUP_REPOSITORY
    substitutionRules:
      - newValue: NEW_CONFIG_VALUE
        originValuePattern: VALUE_PATTERN
        target:
          groupKinds:
          jsonPath: '{.metadata.name}'
          namespaces:
          - NAME_SPACE
      - newValue: NEW_CONFIG_VALUE
        originValuePattern: VALUE_PATTERN
        target:
          groupKinds:
          jsonPath: '{.metadata.name}'
          namespaces:
          - NAME_SPACE

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

• מחליפים את RESTORE_PLAN_NAME בשם של תוכנית השחזור.
• מחליפים את PROJECT_NAME בשם הפרויקט ב-GDC.
• מחליפים את CLUSTER_NAME בשם של האשכול.

בדוגמה הזו נעשה שימוש בערכים הבאים:

ערך	מאפיין	תיאור
targetClusterName		שם אשכול המקור בפרויקט שמשויך לתוכנית הזו.
description		תיאור שהמשתמש סיפק למטרה של ClusterRestorePlan.
clusterBackupPlanName		שם ה-ClusterBackupPlan שרוצים לשחזר. ה-ClusterBackupPlan חייב להיות באותו מרחב שמות של ה-ClusterRestorePlan.
clusterRestoreConfig		הגדרת תהליך השחזור.
	volumeDataRestorePolicy	מציינים אחת מהאפשרויות הבאות: ‫NoVolumeDataRestoration: לא מתבצע שחזור של PV/PVC. ‫RestoreVolumeDataFromBackup: נוצרים PVs ו-PVCs חדשים מהגיבוי. ‫ReuseVolumeHandleFromBackup: יוצרת PVs חדשים, אבל מנסה לשחזר PVCs באמצעות ה-PVs המקוריים שלהם. האפשרות הזו מיועדת לשחזור לאותו אשכול שממנו בוצע הגיבוי.
	clusterResourceConflictPolicy	מציינת את ההתנהגות לטיפול בקונפליקטים במשאבי האשכול, למשל אם המשאב כבר קיים באשכול. מציינים אחת מהאפשרויות הבאות: ‫UseExistingVersion: לא מחליף משאבים קיימים במקרה של התנגשות ‫UseBackupVersion: מחיקה ויצירה מחדש של משאבי אשכול קיימים במהלך התנגשות. משאבים קיימים ברמת האשכול באשכול היעד יוחלפו בגרסאות מהגיבוי. זו אפשרות מסוכנת שעלולה לגרום לאובדן נתונים לא מכוון אם משתמשים בה בצורה לא נכונה. לדוגמה, מחיקה של הגדרת משאב בהתאמה אישית גורמת ל-Kubernetes למחוק את כל המשאבים בהתאמה אישית מהסוג הזה.
	namespacedResourceRestoreMode	מטפל במצב שבו קבוצות המשאבים עם מרחב השמות שמשוחזרות כבר קיימות באשכול היעד. מציינים אחת מהאפשרויות הבאות: ‫DeleteAndRestore: כשנתקלים במשאבים סותרים ברמה העליונה, כמו Namespaces או ProtectedApplications, קודם כל נמחק המשאב הסותר וכל המשאבים שמפנים אליו, ורק אחר כך משוחזרים המשאבים מ-Backup. השתמשו במצב הזה רק אם אתם מתכוונים להחזיר חלק מהאשכול למצב קודם. ‫FailOnConflict: אם בתחילת תהליך השחזור או במהלכו נתקלים במשאבים מתנגשים ברמה העליונה, כמו המשאב Namespace או ProtectedApplication, הפעולה Restore נכשלת. ‫MergeSkipOnConflict: אם במהלך תהליך השחזור יש משאבים עם התנגשויות, המצב הזה מדלג על שחזור המשאבים האלה מהגיבוי וממשיך לשחזר משאבים אחרים שלא נמצאים באשכול. ‫MergeReplaceOnConflict: אם נתקלים במשאבים מתנגשים במהלך תהליך השחזור, המצב הזה מחליף את המשאבים המתנגשים מהגיבוי וממשיך לשחזר משאבים אחרים שלא נמצאים באשכול.
	namespacedResourceRestoreScope	מציינת אילו Namespaces או ProtectedApplications מותר לשחזר. ‫selectedApplications משייך אפליקציות מוגנות לשחזור הזה. ‫selectedNamespaces מכיל את NAME_SPACE, שמציין את מרחב השמות שצריך לשחזר מהגיבוי.
	clusterBackupRepositoryRef	מציין את המאגר שבו יאוחסנו המשאבים של Restore. המאגר הזה יכול להיות שונה מהמאגר שממנו הגיע הגיבוי. המאגר חייב להיות מאגר ReadWrite באשכול.
	substitutionRules	כללים להחלפת ערכים במשאבי Kubernetes שגובו במהלך השחזור. רשימה ריקה פירושה שלא תתבצע החלפה. כללי ההחלפה מופעלים ברצף לפי הסדר שבו הם מוגדרים. הסדר הזה חשוב, כי שינויים שבוצעו על ידי כלל מסוים עשויים להשפיע על לוגיקת ההתאמה של הכלל הבא. כל כלל מציין target, originValuePattern להתאמה (VALUE_PATTERN) וnewValue (NEW_CONFIG_VALUE) להחלפה. ה-target יכול לכלול namespaces כדי להגדיר את היקף הכלל (NAME_SPACE).

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

הצגת תוכנית שחזור

איך מציגים תוכנית שחזור באמצעות מסוף GDC:

1. נכנסים למסוף GDC.
2. בתפריט הניווט, לוחצים על Backup for Clusters.
3. לוחצים על Select project כדי לבחור ארגון או פרויקט, בהתאם לתפקיד שלכם:
   1. אדמין לגיבוי של אשכול משתמשים: בוחרים ארגון כדי לראות את כל תוכניות השחזור בארגון, או בוחרים פרויקט כדי לראות את כל תוכניות השחזור בפרויקט.
   2. Backup Creator: בוחרים פרויקט כדי לראות את כל תוכניות השחזור בפרויקט.
4. לוחצים על הכרטיסייה Restore Plans.
5. לוחצים על תוכנית שחזור ברשימה כדי לראות את הפרטים שלה.

עריכה של תוכנית שחזור

אם למאגר הגיבויים שמשויך לתוכנית השחזור שרוצים לערוך יש ערך בשדה Linked Cluster(read-only) כשתוכנית השחזור נוצרת, היא נוצרת פעמיים. תוכנית השחזור מופצת גם לאשכולות לקריאה וכתיבה וגם לאשכולות לקריאה בלבד.

כשעורכים את תוכנית השחזור שבבעלות מאגר גיבויים שמוגדרים בו גם אשכולות לקריאה-כתיבה וגם אשכולות לקריאה בלבד, צריך לערוך את תוכנית השחזור שבה TARGET CLUSTER מוגדר לאשכול לקריאה-כתיבה.

אזהרה: אם עורכים תוכנית שחזור כשהאפשרות TARGET CLUSTER מוגדרת לאשכול לקריאה בלבד, תתקבל הודעת שגיאה.

עריכת תוכנית שחזור באמצעות מסוף GDC:

1. נכנסים למסוף GDC.
2. בתפריט הניווט, לוחצים על Backup for Clusters.
3. לוחצים על Select project כדי לבחור ארגון או פרויקט, בהתאם לתפקיד שלכם:
   1. אדמין לגיבוי של אשכול משתמשים: בוחרים ארגון כדי לראות את כל תוכניות השחזור בארגון, או בוחרים פרויקט כדי לראות את כל תוכניות השחזור בפרויקט.
   2. Backup Creator: בוחרים פרויקט כדי לראות את כל תוכניות השחזור בפרויקט.
4. לוחצים על הכרטיסייה Restore Plans.
5. לוחצים על השם של תוכנית השחזור שרוצים לערוך.
6. לוחצים על הכרטיסייה הגדרת התוכנית כדי לראות את השדות שאפשר לשנות.

7. לוחצים על סמל העריכה לצד Namespaced resources כדי לערוך את המשאב:

   1. בקטע Choose namespaced resources, בוחרים את המשאבים עם מרחב השמות בגיבוי שרוצים לשחזר:

      1. בוחרים באפשרות Selected namespaced resources כדי לשחזר משאבים ממרחבי השמות שנבחרו בגיבוי:

         1. בוחרים באפשרות Edit Cluster Namespaces כדי לבחור את מרחב השמות של האשכול.
         2. בשדה Cluster namespace 1, מזינים את השם של מרחב השמות.
         3. לוחצים על הלחצן שמירה.

      2. בוחרים באפשרות Selected protected applications כדי לשחזר משאבים מהאפליקציות המוגנות שנבחרו בגיבוי:

         1. בוחרים באפשרות Edit Protected Applications כדי לבחור את מרחב השמות ואת האפליקציה המוגנת.
         2. בשדה מרחב שמות 1, מזינים את השם של מרחב השמות.
         3. בשדה Protected application 1, מזינים את שם האפליקציה המוגנת.
         4. לוחצים על הלחצן שמירה.

8. לוחצים על סמל העריכה לצד Cluster-scoped resources כדי לערוך את המשאב:

   1. אופציונלי: בקטע Choose cluster-scoped resources, בוחרים את המשאבים ברמת האשכול שרוצים לשחזר על ידי ציון קבוצות ה-API ו-GroupKinds, ומחליטים איך לפתור את ההתנגשויות:

      1. בוחרים באפשרות Don't restore cluster-scoped resources כדי להסיר משאבים ברמת האשכול מתהליך השחזור.

      2. בוחרים באפשרות Restore cluster-scoped resources by GroupKind כדי לשחזר את המשאבים לפי ה-GroupKind שצוין:

      3. כדי לציין GroupKind, לוחצים על הכפתור Edit GroupKind.

      4. לוחצים על הכפתור Add GroupKind.

      5. מזינים את השם של GroupKind.

      6. לוחצים על הלחצן שמירה.

   2. בקטע Conflict handling, בוחרים איזו פעולה לבצע אם המשאב כבר קיים באשכול היעד:

      1. בוחרים באפשרות Preserve existing resources כדי ליצור משאבים אם הם עדיין לא קיימים באשכול.
      2. בוחרים באפשרות החלפת משאבים קיימים כדי למחוק את כל המשאבים הקיימים שנמצאו, ולהחליף את המשאב הזה במשאב ששוחזר.

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

9. בקטע Substitution rules, לוחצים על הכפתור Add New Rule כדי להוסיף כלל החלפה חדש:

   1. בשדה Cluster namespaces, מזינים את השם של מרחב השמות של האשכול שעליו רוצים להחיל את כלל ההחלפה.
   2. לוחצים על הכפתור Add GroupKind כדי להחיל את הכלל הזה על אובייקט GroupKind מסוים.
   3. בשדה JSON path, מזינים את הנתיב למאפיין המשאב שרוצים להחליף, בפורמט JSON.
   4. בשדה תבנית הערך המקורי, מזינים ביטוי רגולרי שתואם לערך המקורי של המאפיין.
   5. בשדה ערך חדש, מזינים את הערך שיוחלף בשדה היעד. אם השדה הזה ריק, שדה היעד יוסר מהמשאב.
   6. לוחצים על Save כדי לסיים את יצירת כלל ההחלפה החדש.

10. בקטע כללי החלפה, לוחצים על סמל העריכה כדי לערוך כלל החלפה קיים.

11. בקטע Substitution rules, לוחצים על סמל המחיקה כדי למחוק כלל החלפה קיים.

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

אפשר למחוק את RestorePlans דרך מסוף GDC או על ידי מחיקת המשאב ישירות משרת ה-API של Kubernetes. הפעולה הזו מנקה את כל פריטי המידע שמשויכים ל-RestorePlan ממאגר האובייקטים.

המסוף

1. נכנסים למסוף GDC.
2. בתפריט הניווט, לוחצים על Backup for Clusters.
3. לוחצים על Select project כדי לבחור ארגון או פרויקט, בהתאם לתפקיד שלכם:
   1. ‫User Cluster Backup Admin: בוחרים ארגון כדי לראות את כל תוכניות השחזור בארגון, או בוחרים פרויקט כדי לראות את כל תוכניות השחזור בפרויקט.
   2. יוצר הגיבוי: בוחרים פרויקט כדי לראות את כל תוכניות השחזור בפרויקט.
4. לוחצים על הכרטיסייה Restore Plans.
5. לוחצים על השם של תוכנית השחזור שרוצים למחוק.
6. לוחצים על הלחצן מחיקה.
7. מזינים את שם תוכנית השחזור בשדה.
8. לוחצים על Delete כדי לאשר את המחיקה של תוכנית השחזור.

API

מוחקים את המשאב של תוכנית השחזור:

kubectl delete clusterRestoreplan RESTORE_PLAN_NAME -n NAMESPACE

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

• ‫RESTORE_PLAN_NAME: השם של תוכנית השחזור.
• ‫NAMESPACE: מרחב השמות שמכיל את תוכנית השחזור.

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

• סקירה כללית של שחזור ידני
• הצגה ומחיקה של שחזור