פיצול מאגר לכמה מאגרים

מוודאים של-RootSync single-root-sync יש ערך הערה של Orphan או שהוא לא מוגדר.configsync.gke.io/deletion-propagation-policy ערך ברירת המחדל כשלא מוגדר כלום זהה לערך Orphan. ההגדרה הזו מבטיחה שאובייקטים לא יימחקו.

מחיקת RootSync single-root-sync:

kubectl delete rootsync single-root-sync -n config-management-system

כדי להגדיר את המאגרים החדשים:

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

שומרים ודוחפים את השינוי:

git commit -am 'add configuration for the new root repository'

החלת האובייקטים root-sync-1 ו-root-sync-2 RootSync. כך מתבצע סנכרון של המאגר או הספרייה החדשים, כך שהאובייקטים הקיימים באשכול מנוהלים על ידי אובייקטי RootSync החדשים root-sync-1 ו-root-sync-2:

 apiVersion: configsync.gke.io/v1beta1
 kind: RootSync
 metadata:
   name: ROOT_SYNC_NAME
   namespace: config-management-system
 spec:
   sourceFormat: unstructured
   git:
     repo: NEW_ROOT_REPOSITORY
     revision: NEW_ROOT_REVISION
     branch: NEW_ROOT_BRANCH
     dir: "NEW_ROOT_DIRECTORY"
     auth: ROOT_AUTH_TYPE
     gcpServiceAccountEmail: ROOT_EMAIL
     # secretRef should be omitted if the auth type is none, gcenode, or gcpserviceaccount.
     secretRef:
       name: git-creds

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

• ‫NEW_ROOT_REPOSITORY: כתובת ה-URL של מאגר Git שבו רוצים להשתמש כמאגר הבסיס החדש. אפשר להזין כתובות URL באמצעות פרוטוקול HTTPS או פרוטוקול SSH. לדוגמה, ‫https://github.com/GoogleCloudPlatform/anthos-config-management-samples משתמש בפרוטוקול HTTPS. אם לא מזינים פרוטוקול, המערכת מתייחסת לכתובת ה-URL כאל כתובת URL מסוג HTTPS.
• ‫NEW_ROOT_REVISION: (אופציונלי) מספר התיקון ב-Git (תג או hash) של מאגר הבסיס החדש שרוצים להוציא.
• ‫NEW_ROOT_BRANCH: (אופציונלי) הענף של מאגר הבסיס החדש שממנו יתבצע הסנכרון.
• ‫NEW_ROOT_DIRECTORY: (אופציונלי) הנתיב במאגר Git לספריית הבסיס החדשה שמכילה את ההגדרה שרוצים לסנכרן.
• ‫ROOT_AUTH_TYPE: הערך הזה צריך להיות זהה לערך של אובייקט RootSync/root-sync הקיים.
• ‫ROOT_EMAIL: הערך הזה צריך להיות זהה לערך של אובייקט RootSync/root-sync הקיים.

ממתינים עד שאובייקט RootSync החדש root-sync-1 יסונכרן. אפשר לבדוק את הסטטוס באמצעות הפקודה הבאה:

nomos status

במאגר הבסיסי הקיים, בוחרים את המשאבים שרוצים להעביר למאגר או לספרייה אחרים ומוסיפים להם את ההערה configmanagement.gke.io/managed: disabled. ההערה הזו מוודאת שהאובייקטים הקיימים באשכול לא יושפעו כשמעבירים את ההגדרה שלהם ממאגר אחד למאגר אחר. אם אתם משתמשים בפורמט Kustomize או בתרשימי helm, אתם יכולים לבחור בערך מחצית מהבסיסים ולהוסיף את ההערה הנפוצה לקובץ kustomization.yaml, כמו בדוגמה הזו:

# kustomization.yaml
commonAnnotations:
  configmanagement.gke.io/managed: disabled

שומרים ודוחפים את השינוי: sh git commit -am 'disable Config Sync management on subset of the configuration'

מחכים שאובייקט RootSync הקיים root-sync יסונכרן באמצעות הפקודה הבאה:

nomos status

כדי להגדיר את המאגר השני:

1. יוצרים מאגר חדש או ספרייה חדשה במאגר Git הקיים.
2. מעתיקים את המשאבים עם ההערה configmanagement.gke.io/managed: disabled למאגר החדש או לספרייה החדשה.
3. מסירים את ההערה configmanagement.gke.io/managed: disabled במאגר או בספרייה החדשים.
4. אם אתם מפצלים את מאגר הבסיס ליותר משני מאגרים, חוזרים על השלבים האלה לפי הצורך.

שומרים ודוחפים את השינוי:

git commit -am 'add configuration for the new root repository'

מחילים אובייקט root-sync-1 RootSync כדי לסנכרן את המאגר או הספרייה החדשים, כך שהאובייקטים הקיימים באשכול ינוהלו על ידי אובייקט root-sync-1 RootSync חדש.

 apiVersion: configsync.gke.io/v1beta1
 kind: RootSync
 metadata:
   name: root-sync-1
   namespace: config-management-system
 spec:
   sourceFormat: unstructured
   git:
     repo: NEW_ROOT_REPOSITORY
     revision: NEW_ROOT_REVISION
     branch: NEW_ROOT_BRANCH
     dir: "NEW_ROOT_DIRECTORY"
     auth: ROOT_AUTH_TYPE
     gcpServiceAccountEmail: ROOT_EMAIL
     # secretRef should be omitted if the auth type is none, gcenode, or gcpserviceaccount.
     secretRef:
       name: git-creds

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

• ‫NEW_ROOT_REPOSITORY: כתובת ה-URL של מאגר Git שבו רוצים להשתמש כמאגר הבסיס החדש. אפשר להזין כתובות URL באמצעות פרוטוקול HTTPS או פרוטוקול SSH. לדוגמה, ‫https://github.com/GoogleCloudPlatform/anthos-config-management-samples משתמש בפרוטוקול HTTPS. אם לא מזינים פרוטוקול, המערכת מתייחסת לכתובת ה-URL כאל כתובת URL מסוג HTTPS.
• ‫NEW_ROOT_REVISION: (אופציונלי) מספר התיקון ב-Git (תג או hash) של מאגר הבסיס החדש שרוצים להוציא.
• ‫NEW_ROOT_BRANCH: (אופציונלי) הענף של מאגר הבסיס החדש שממנו יתבצע הסנכרון.
• ‫NEW_ROOT_DIRECTORY: (אופציונלי) הנתיב במאגר Git לספריית הבסיס החדשה שמכילה את ההגדרה שרוצים לסנכרן.
• ‫ROOT_AUTH_TYPE: הערך הזה צריך להיות זהה לערך של אובייקט RootSync/root-sync הקיים.
• ‫ROOT_EMAIL: הערך הזה צריך להיות זהה לערך של אובייקט RootSync/root-sync הקיים.

ממתינים עד שאובייקט RootSync החדש root-sync-1 יסונכרן. אפשר לבדוק את הסטטוס באמצעות הפקודה הבאה:

nomos status

מסירים את המשאבים עם ההערה configmanagement.gke.io/managed: disabled מהמאגר המקורי. שומרים ודוחפים את השינוי:

git commit -am 'remove configuration managed by the new root repository'

מחכים שאובייקט root-sync RootSync הקיים יסונכרן באמצעות הפקודה הבאה:

nomos status