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

בוחרים גרסה של התיעוד:

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

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

סקירה כללית

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

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

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

אתם צריכים גישה אל:

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

  • הכלי kubectl.

  • כלי לניהול חבילות של helm.

  • Google Cloud CLI.

    אם אתם צריכים להתקין את ה-CLI של gcloud, שימו לב שהשלב של הפעלת הפקודה gcloud init הוא אופציונלי. התקנת AlloyDB Omni לא מחייבת אימות באמצעות חשבון Google.

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

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

שימוש בתרשימי Helm

אפשר להשתמש בתרשימי Helm ממאגר alloydb-omni-samples כדי לפרוס את הרכיבים שמוצגים במדריך הזה.

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

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

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

    export GCS_BUCKET=alloydb-omni-operator
export HELM_PATH=$(gcloud storage cat gs://$GCS_BUCKET/latest)
export OPERATOR_VERSION="${HELM_PATH%%/*}"

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

    gcloud storage cp gs://$GCS_BUCKET/$HELM_PATH ./ --recursive

  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 והוא נמצא בספריית העבודה הנוכחית.

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

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

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

apiVersion: v1
kind: Secret
metadata:
  name: db-pw-DB_CLUSTER_NAME
type: Opaque
data:
  DB_CLUSTER_NAME: "ENCODED_PASSWORD"
---
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
  databaseVersion: "15.5.2"
  primarySpec:
    adminUser:
      passwordRef:
        name: db-pw-DB_CLUSTER_NAME
    resources:
      cpu: CPU_COUNT
      memory: MEMORY_SIZE
      disks:
      - name: DataDisk
        size: DISK_SIZE
        storageClass: standard

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

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

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

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

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

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

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

למידע נוסף על מניפסטים של Kubernetes ואיך להחיל אותם, ראו ניהול משאבים.

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