התקנה של 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
  • 10 GB של מקום בכונן
  • מערכת הפעלה שמבוססת על Debian (כמו Ubuntu),‏ RHEL 8 או RHEL 9
  • גרסת ליבת Linux‏ 5.3 ואילך
  • Cgroupsv2 enabled
  • ‫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.

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