התקנה של AlloyDB Omni ב-Kubernetes

בוחרים גרסה של מאמר העזרה: 16.3.0

• 16.3.0
• 15.7.1
• 15.7.0
• 15.5.5
• 15.5.4
• 15.5.2

בדף הזה מופיעה סקירה כללית של אופרטור AlloyDB Omni Kubernetes, עם הוראות לשימוש בו כדי לפרוס את AlloyDB Omni באשכול Kubernetes. בדף הזה אנחנו מניחים שיש לכם היכרות בסיסית עם הפעולה של Kubernetes.

הוראות להתקנת AlloyDB Omni בסביבת Linux רגילה מפורטות במאמר התקנת AlloyDB Omni.

סקירה כללית

כדי לפרוס את AlloyDB Omni באשכול Kubernetes, צריך להתקין את אופרטור AlloyDB Omni, תוסף ל-Kubernetes API שסופק על ידי Google.

אתם מגדירים ושולטים באשכול מסדי נתונים של AlloyDB Omni שמבוסס על Kubernetes על ידי שיוך של קובצי מניפסט הצהרתיים לכלי kubectl, בדיוק כמו בכל פריסה אחרת שמבוססת על Kubernetes. אתם לא משתמשים ב-AlloyDB Omni CLI, שנועד לפריסות במכונות Linux בודדות ולא באשכולות Kubernetes.

תמונת הבסיס

החל מגרסה 1.5.0, קובצי האימג' של אופרטור AlloyDB Omni Kubernetes מבוססים על Universal Base Image ‏ (UBI) 9 של Red Hat. המעבר הזה משפר את האבטחה, העקביות והתאימות של הפריסות שלכם.

תאימות לאופרטור AlloyDB Omni מגרסה 1.1.0 (ומגרסאות מאוחרות יותר)

גרסה 1.1.0 של אופרטור AlloyDB Omni לא תואמת לגרסאות 15.5.3 ו-15.5.4 של AlloyDB Omni. אם אתם משתמשים באחת מהגרסאות האלה של AlloyDB Omni, יכול להיות שתקבלו שגיאה דומה לזו שמופיעה בהמשך:

Error from server (Forbidden): error when creating "[...]/dbcluster.yaml": admission webhook "vdbcluster.alloydbomni.dbadmin.goog" denied the request: unsupported database version 15.5.3

הערה: כדי לפרוס את AlloyDB Omni באשכול Kubernetes עם אופרטור AlloyDB Omni 1.1.0, צריך להשתמש ב-AlloyDB Omni מגרסה 15.5.5 ואילך.

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

לפני שמתקינים את AlloyDB Omni באשכול Kubernetes באמצעות אופרטור AlloyDB Omni, צריך לוודא שאתם עומדים בדרישות הבאות.

בחירת אפשרות להורדה או להתקנה

כשמנהלים עומסי עבודה באשכול Kubernetes כללי, אפשר להשתמש ב-Helm או ב-OLM. ‫Helm הוא מנהל חבילות אוניברסלי שמשתמש בתרשימי Helm כדי להתקין כל עומס עבודה, כולל אופרטורים, בכל הווריאציות של Kubernetes. ‫OLM – הבחירה המועדפת והסטנדרטית בפלטפורמות OpenShift – מנהל את מחזורי החיים של האופרטורים באמצעות חבילות OLM ייעודיות.

בהתאם לסביבה ולכלים שלכם, בוחרים אחת משיטות הפריסה הבאות:

מדיה	מיקומי הורדה ומדריכי התקנה	פריסה אל
אופרטור AlloyDB Omni עם תרשים Helm	התקנת AlloyDB Omni ב-Kubernetes	סביבת קונטיינרים של Kubernetes משלכם – למשל, מקומית, עננים ציבוריים, GKE,‏ Amazon EKS ו-Azure AKS. כדאי לדעת: אם כלי ה-CD (פיתוח רציף) שלכם משולבים עם Helm, כדאי להשתמש באפשרות הזו.
אופרטור AlloyDB Omni עם חבילת OLM	OperatorHub.io	סביבת קונטיינרים של Kubernetes משלכם – למשל, מקומית, בעננים ציבוריים, ב-Google Kubernetes Engine, ב-Amazon EKS וב-Azure AKS. כדי להשתמש בחבילת OLM, צריך להתקין את OLM באשכול Kubernetes לפני שמתקינים את האופרטור. מידע נוסף זמין בכתובת olm.operatorframework.io. כדאי לדעת: אם כלי ה-CD (פיתוח רציף) שלכם כבר משתמשים ב-OLM, בוחרים באפשרות הזו.
‫OpenShift Operator עם חבילת OLM	מסוף האינטרנט של Openshift Container Platform	סביבת OpenShift ‫OpenShift, גרסה של Kubernetes, משתמשת ב-OLM כשיטה סטנדרטית ומובנית לאריזה ולפריסה של אופרטורים.

אימות הגישה

ודאו שיש לכם גישה ל:

• אשכול Kubernetes שפועלת בו התוכנה הבאה:

  • ‫Kubernetes גרסה 1.21 ואילך.
  • שירות cert-manager, שהותקן באמצעות Helm.
  הערה: באשכולות GKE Autopilot, צריך להתקין את cert-manager עם הדגל הזה: --set global.leaderElection.namespace=cert-manager

• הכלי kubectl.

• מנהל החבילות helm או מנהל מחזור החיים של האופרטורים.

עמידה בדרישות החומרה והתוכנה

לכל צומת באשכול Kubernetes צריכים להיות:

• לפחות שני מעבדי x86 או AMD64.
• זיכרון RAM בנפח 8GB לפחות.
• גרסת ליבת Linux‏ 4.18 ואילך.
• הופעלה קבוצת בקרה (cgroup) v2.

התקנת אופרטור AlloyDB Omni

הערה: אם אתם רוצים לפרוס את AlloyDB Omni בסביבת הייצור שלכם, כדאי לעיין במאמר הרצת AlloyDB Omni בסביבת ייצור.

אפשר להתקין את האופרטור AlloyDB Omni באמצעות שיטות שונות, כולל Helm ו-Operator Lifecycle Manager‏ (OLM).

Helm

כדי להתקין את האופרטור של AlloyDB Omni, פועלים לפי השלבים הבאים:

1. מגדירים את משתני הסביבה הבאים:

   export HELM_PATH=$(curl https://storage.googleapis.com/alloydb-omni-operator/latest)
   export OPERATOR_VERSION="${HELM_PATH%%/*}"
   

2. מורידים את האופרטור AlloyDB Omni:

   curl -X GET -o "./alloydbomni-operator-${OPERATOR_VERSION}.tgz" "https://storage.googleapis.com/storage/v1/b/alloydb-omni-operator/o/$(echo ${HELM_PATH} | sed 's/\//%2F/g')?alt=media"
   

3. מתקינים את אופרטור AlloyDB Omni:

   helm install alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
   --create-namespace \
   --namespace alloydb-omni-system \
   $(helm install --help | grep -q -- '--rollback-on-failure' && echo '--rollback-on-failure' || echo '--atomic') \
   --timeout 5m
   

   אם ההתקנה הושלמה בהצלחה, הפלט הבא מוצג:

   NAME: alloydbomni-operator
   LAST DEPLOYED: CURRENT_TIMESTAMP
   NAMESPACE: alloydb-omni-system
   STATUS: deployed
   REVISION: 1
   TEST SUITE: None
   

4. כדי לנקות, מוחקים את קובץ ההתקנה של אופרטור AlloyDB Omni שהורד. שם הקובץ הוא alloydbomni-operator-VERSION_NUMBER.tgz והוא נמצא בספריית העבודה הנוכחית.

OLM

כדי להתקין את אופרטור AlloyDB Omni באמצעות Operator Lifecycle Manager, מבצעים את השלבים הבאים:

1. עוברים לדף אופרטור AlloyDB Omni.

2. לוחצים על התקנה. אם עדיין לא עשיתם את זה, פועלים לפי ההוראות להתקנה של OLM operator ושל קטלוג OperatorHub.io בלבד.

3. יוצרים את מרחב השמות alloydb-omni-system אם הוא לא קיים.

   kubectl create ns alloydb-omni-system
   

4. מגדירים את OLM OperatorGroup כדי לוודא שהאופרטור הוא ברמת האשכול.

   kubectl apply -f - <<EOF
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: operator-sdk-og
     namespace: alloydb-omni-system
   spec:
     upgradeStrategy: Default
   EOF
   

5. מתקינים את האופרטור באמצעות משאב מינוי OLM.

   kubectl apply -f - <<EOF
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: my-alloydb-omni-operator
     namespace: alloydb-omni-system
   spec:
     channel: stable
     name: alloydb-omni-operator
     source: operatorhubio-catalog
     sourceNamespace: olm
   EOF
   

6. מתקינים את אישור ברירת המחדל ClusterIssuer. השלב הזה הוא אופציונלי אם משתמשים במנפיקי אישורים בהתאמה אישית.

   kubectl apply -f - <<EOF
   apiVersion: cert-manager.io/v1
   kind: ClusterIssuer
   metadata:
     name: alloydbomni-selfsigned-cluster-issuer
   spec:
     selfSigned: {}
   EOF
   

OLM

הערה: צריך להפעיל את community-operators CatalogSource כי האופרטור AlloyDB Omni זמין רק כאופרטור קהילתי. במסמכי Red Hat מצוין שאפשר להשבית את קטלוג הקהילה אם צריך.

כדי להתקין את האופרטור AlloyDB Omni בסביבת Red Hat OpenShift באמצעות OLM, נכנסים למסוף האינטרנט של Red Hat OpenShift.

1. בוחרים באפשרות Operators (אופרטורים) > OperatorHub.

2. חיפוש אופרטור AlloyDB Omni באמצעות שדה החיפוש.

3. בחלונית של אופרטור AlloyDB Omni, לוחצים על Install (התקנה).

4. מתקינים את אישור ברירת המחדל ClusterIssuer. השלב הזה הוא אופציונלי אם משתמשים במנפיקי אישורים בהתאמה אישית.

   kubectl apply -f - <<EOF
   apiVersion: cert-manager.io/v1
   kind: ClusterIssuer
   metadata:
     name: alloydbomni-selfsigned-cluster-issuer
   spec:
     selfSigned: {}
   EOF
   

הגדרת אחסון ב-GDC במודל מחובר

כדי להתקין את האופרטור AlloyDB Omni ב-GDC במודל מחובר, צריך לבצע שלבים נוספים להגדרת האחסון כי באשכולות GDC במודל מחובר לא מוגדר סוג אחסון (storage class) כברירת מחדל. צריך להגדיר סוג אחסון כברירת מחדל לפני שיוצרים אשכול מסד נתונים של AlloyDB Omni.

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

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

יצירת אשכול של מסד נתונים

חשוב: אל תיצרו אשכול מסדי נתונים במרחב השמות alloydb-omni-system. מרחב השמות alloydb-omni-system שמור לאופרטור AlloyDB Omni.

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

כדי ליצור אשכול מסדי נתונים של AlloyDB Omni, פועלים לפי השלבים הבאים:

1. יוצרים מרחב שמות ייעודי לאשכול מסד הנתונים. כך משפרים את הבידוד והאבטחה.

   kubectl create namespace DB_CLUSTER_NAMESPACE
   

   מחליפים את DB_CLUSTER_NAMESPACE במרחב השמות שבו רוצים ליצור את אשכול מסד הנתונים – לדוגמה, my-db-cluster-namespace.

2. יוצרים קובץ מניפסט בשם db-cluster.yaml עם התוכן הבא. קובץ המניפסט הזה מגדיר גם את הסוד של סיסמת מסד הנתונים וגם את משאב DBCluster עצמו.

   apiVersion: v1
   kind: Secret
   metadata:
     name: db-pw-DB_CLUSTER_NAME
     namespace: DB_CLUSTER_NAMESPACE
   type: Opaque
   data:
     DB_CLUSTER_NAME: "ENCODED_PASSWORD"
   ---
   apiVersion: alloydbomni.dbadmin.goog/v1
   kind: DBCluster
   metadata:
     name: DB_CLUSTER_NAME
     namespace: DB_CLUSTER_NAMESPACE
   spec:
     databaseVersion: "16.3.0"
     # Optional: Specify the base OS type for the database image.
     # Valid values are "Debian" and "UBI9".
     # If not specified, the operator defaults to "Debian" for databaseVersion < 16.9.0
     # and "UBI9" for databaseVersion 16.9.0 or later.
     # databaseImageOSType: "OS_TYPE"
     primarySpec:
       adminUser:
         passwordRef:
           name: db-pw-DB_CLUSTER_NAME
       resources:
         cpu: CPU_COUNT
         memory: MEMORY_SIZE
         disks:
         - name: DataDisk
           size: DISK_SIZE
   

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

   • ‫DB_CLUSTER_NAME: השם של אשכול מסד הנתונים הזה, לדוגמה my-db-cluster.

   • ‫OS_TYPE: אופציונלי. סוג מערכת ההפעלה הבסיסית של תמונת מסד הנתונים. הערכים התקפים הם Debian ו-UBI9. אם לא מציינים את האפשרות הזו, האופרטור מגדיר אותה באופן אוטומטי ל-Debian אם databaseVersion קטן מ-16.9.0, ול-UBI9 אם databaseVersion גדול מ-16.9.0 או שווה לו.

   • ‫ENCODED_PASSWORD: סיסמת ההתחברות למסד הנתונים עבור תפקיד המשתמש שמוגדר כברירת מחדל postgres, בקידוד base64. לדוגמה, Q2hhbmdlTWUxMjM= עבור ChangeMe123.

   • ‫CPU_COUNT: מספר המעבדים הזמינים לכל מופע של מסד נתונים באשכול מסדי הנתונים הזה.

   • ‫MEMORY_SIZE: כמות הזיכרון לכל מופע של מסד נתונים באשכול מסדי הנתונים הזה. מומלץ להגדיר את הערך הזה ל-8 גיגה-בייט לכל מעבד. לדוגמה, אם הגדרתם את cpu ל-2 מוקדם יותר במניפסט הזה, מומלץ להגדיר את memory ל-16Gi.

   • ‫DISK_SIZE: גודל הדיסק לכל מופע של מסד נתונים, לדוגמה 10Gi.

3. מחילים את המניפסט על אשכול Kubernetes:

   kubectl apply -f db-cluster.yaml
   

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

הערה: החל מגרסה 1.1.0 של אופרטור AlloyDB Omni, הסוד של סיסמת האדמין לא נמחק יותר אחרי שמגדירים אותו. חובה לשמור את הסוד שהוגדר למשך כל משך החיים של אשכול מסד הנתונים של AlloyDB Omni.

מידע נוסף על מניפסטים של Kubernetes ועל אופן היישום שלהם זמין במאמר בנושא ניהול משאבים.

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

• הפעלה וחיבור ל-AlloyDB Omni
• ניהול AlloyDB Omni
• ניהול זמינות גבוהה ב-Kubernetes