התקנה של AlloyDB Omni

במדריך למתחילים הזה מוסבר איך להתקין את AlloyDB Omni, שאפשר להריץ אותו בכל סביבה מבוססת UNIX שתומכת בזמני ריצה של קונטיינרים.

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

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

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

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

מדיה מיקומי הורדה ומדריכי התקנה פריסה ב
תמונת Debian DockerHub (תגים)
  • Docker, ‏ Podman. אפשר להריץ את כלי הקונטיינריזציה האלה כקונטיינר בכל מכונה וירטואלית (VM).
תמונת UBI‏ (Red Hat) Red Hat Ecosystem Catalog
  • סביבת Red Hat. הפעלת הפקודה כקונטיינר.

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

חשוב לוודא שאתם עומדים בדרישות המינימום הבאות לחומרה ולתוכנה:

מערכת הפעלה/פלטפורמה חומרה מינימלית תוכנה מינימלית
Linux
  • מעבד x86-64 או Arm (*) עם תמיכה ב-AVX2
  • זיכרון RAM בנפח 2GB
  • נפח אחסון של 10GB
  • מערכת הפעלה שמבוססת על Debian (Ubuntu וכו'), ‫RHEL 8 או 9
  • ליבת Linux מגרסה 5.3 ואילך
  • האפשרות Cgroupsv2 מופעלת
  • ‫Docker Engine 20.10 ואילך או Podman 4.2.0 ואילך
  • macOS
  • מעבד Intel עם תמיכה ב-AVX2 או שבב M
  • זיכרון RAM בנפח 2GB
  • נפח אחסון של 10GB
  • ‫Docker Desktop מגרסה 4.20 ואילך
  • ‫(*) התמיכה ב-Arm היא בגרסת Preview.

    מוודאים ש-cgroupsv2 מופעל

    כדי לבדוק אם cgroupsv2 מופעל במחשב, מריצים את הפקודה הבאה:

    grep cgroup /proc/filesystems
    

    אם המחשב תומך ב-cgroupsv2, תראו את הפלט הבא:

    nodev cgroup
    nodev cgroupsv2
    

    אם המחשב לא תומך ב-cgroupsv2, תראו את הפלט הבא:

    nodev cgroup
    

    התקנת זמן ריצה של קונטיינר

    מתקינים סביבת זמן ריצה של מאגר כמו Docker או Podman. ‫AlloyDB Omni פועל בקונטיינר.

    התקנה של AlloyDB Omni באמצעות Docker

    לא נדרשת גישת root כדי להתקין את AlloyDB Omni.

    Docker

    1. משתמשים בפקודה docker run כדי ליצור מאגר חדש עם AlloyDB Omni בשם my-omni:

        docker run --name my-omni \
          -e POSTGRES_PASSWORD=NEW_PASSWORD \
           -d google/alloydbomni:IMAGE_TAG

      מחליפים את המשתנים הבאים:

      • NEW_PASSWORD: הסיסמה להקצאת משתמש postgres חדש למאגר אחרי שהוא נוצר.
      • IMAGE_TAG: משתמשים ב-16.8.0 כדי לקבל את קובץ האימג' העדכני של Debian או ב-16.8.0-ubi כדי לקבל את קובץ האימג' העדכני של UBI.

    2. מתחברים ל-AlloyDB Omni בקונטיינרים באמצעות psql:

        docker exec -it my-omni psql -h localhost -U postgres

      בחלון הטרמינל מוצג טקסט של psql התחברות שמסתיים בהנחיה postgres=#.

    Podman

    1. משתמשים בפקודה docker run כדי ליצור מאגר חדש עם AlloyDB Omni בשם my-omni:

        podman run --name my-omni \
          -e POSTGRES_PASSWORD=NEW_PASSWORD \
          -d google/alloydbomni:IMAGE_TAG

      מחליפים את המשתנים הבאים:

      • NEW_PASSWORD: הסיסמה להקצאת משתמש postgres חדש למאגר אחרי שהוא נוצר.
      • IMAGE_TAG: משתמשים ב-16.3.0 כדי לקבל את קובץ האימג' העדכני של Debian או ב-16.3.0-ubi כדי לקבל את קובץ האימג' העדכני של UBI.

    2. מתחברים ל-AlloyDB Omni בקונטיינרים באמצעות psql:

      podman exec -it my-omni psql -h localhost -U postgres

      בחלון הטרמינל מוצג טקסט של התחברות psql שמסתיים בהנחיה [0x0A]postgres=#.

    הסרת המשאבים

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

    Docker

    1. עוצרים את קונטיינר AlloyDB Omni שנקרא my-omni:

        docker container stop my-omni
    2. כדי למחוק את הקונטיינר AlloyDB Omni שנקרא my-omni:

        docker container rm my-omni

    Podman

    1. עוצרים את קונטיינר AlloyDB Omni שנקרא my-omni:

        podman container stop my-omni
    2. כדי למחוק את הקונטיינר AlloyDB Omni שנקרא my-omni:

        podman container rm my-omni

    הוראות להתקנת AlloyDB Omni במאגר חדש לשימוש בסביבת ייצור זמינות במאמר התאמה אישית של ההתקנה של AlloyDB Omni.

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