התקנה של 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 שמסתיים בהנחיה [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.

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