התקנה של AlloyDB Omni באמצעות קונטיינרים

בחירת גרסה של מאמר העזרה:

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

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

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

בקשת גישה לאימג' של AlloyDB Omni

כדי לקבל גישה לאימג' של PostgreSQL 18, צריך למלא את טופס ההרשמה לתמריצים של AlloyDB Omni.

תכנון ההתקנה

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

  1. מידע נוסף על תכנון ההתקנה של AlloyDB Omni במכונה וירטואלית
  2. קוראים את המאמר הפעלת AlloyDB Omni עם הרשאות בסיס או בלי הרשאות בסיס ומבצעים את השלבים הנדרשים בהתאם לסביבה שבחרתם.

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

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

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

הפעלת AlloyDB Omni עם הרשאות רוט או בלי הרשאות רוט

אתם יכולים להריץ את AlloyDB Omni באמצעות Docker או Podman. אפשר להריץ את מנועי הקונטיינרים האלה עם הרשאות רוט או בלי הרשאות רוט. המונח "עם הרשאות בסיס" מתייחס להרצת Docker או Podman כמשתמש Root, והמונח "ללא הרשאות בסיס" מתייחס להרצת קובצי אימג' של קונטיינרים אלה כמשתמש ללא הרשאות Root או ללא הרשאות.

המצב שתבחרו תלוי בדרישות ובהעדפות שלכם לגבי הסביבה. אם פשטות חשובה לכם, יכול להיות ש-rootful מתאים לכם. אם אתם צריכים את האבטחה של משתמש ללא הרשאות, יכול להיות ש-rootless היא הבחירה הנכונה.

אם מחליטים להריץ סביבה עם הרשאות root, צריך להחליט איך לנהל את מיפוי המשתמשים בין הקונטיינר למכונת המארח. בפועל, AlloyDB Omni מריץ תהליכים כמשתמש postgres, עם מזהה משתמש (UID) ומזהה קבוצה (GID) של 999. יש שתי אפשרויות לניהול מיפוי המשתמשים:

  • לא לעשות כלום. ‫postgres ימשיך לא להיות משויך לאף משתמש במחשב המארח.
  • יוצרים משתמש וקבוצת משתמשים עם UID ו-GID של 999, כדי ש-postgres ימופה למשתמש ולקבוצת המשתמשים האלה.

בסביבות ללא הרשאות root, ‏ postgres ממופה ל-sub-UID ול-sub-GID שלמשתמש המארח ולקבוצת המשתמשים יש גישה אליהם (כפי שמוגדר בקובצי /etc/subuid ו-/etc/subgid). המשמעות היא שלא צריך לנהל את מיפוי המשתמשים.

(Rootless) הגדרת טווחים של sub-UID ו-sub-GID

  1. אם אתם משתמשים ב-RHEL, ב-CentOS או ב-Fedora, בצעו את הפעולות הבאות:

    1. מריצים את הפקודה sudo dnf install -y iptables כדי להתקין את תוכנת השירות של שורת הפקודה iptables.
    2. בכל גרסה של RHEL שקודמת ל-9, מתקינים את החבילה fuse-overlayfs באמצעות הפקודה sudo dnf install -y fuse-overlayfs.

  2. אם באימג' של Linux לא מוגדרים טווחי sub-UID ו-sub-GID למשתמש ללא הרשאות, צריך להגדיר את הטווחים האלה כדי להריץ את AlloyDB Omni ללא הרשאות בסיס.

  3. אם אתם משתמשים במערכת Debian, צריך להתקין קבצים בינאריים של newuidmap ושל newgidmap.

    apt-get install -y uidmap

  4. מוסיפים רשומה של subuid למשתמש ללא הרשאות Root.

    echo "ROOTLESS_USER:SUB_UID_RANGE_START:SUB_UID_RANGE_COUNT" >> /etc/subuid

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

    • ‫ROOTLESS_USER: המשתמש שרוצים להריץ את AlloyDB Omni בתורו.
    • ‫SUB_UID_RANGE_START: המספר הנמוך בטווח של מזהי ה-UID המשניים שרוצים לרשום למשתמש.
    • ‫SUB_UID_RANGE_COUNT: מספר מזהי המשנה שאתם רוצים לרשום למשתמש. הערך חייב להיות לפחות 999.

  5. מוסיפים רשומה של subgid למשתמש ללא הרשאות Root.

    echo "ROOTLESS_USER:SUB_GID_RANGE_START:SUB_GID_RANGE_COUNT" >> /etc/subgid

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

    • ‫ROOTLESS_USER: המשתמש שרוצים להריץ את AlloyDB Omni בתורו.
    • ‫SUB_GID_RANGE_START: המספר הנמוך ביותר בטווח של מזהי ה-GID המשניים שרוצים לרשום למשתמש.
    • ‫SUB_GID_RANGE_COUNT: מספר מזהי ה-GID המשניים שרוצים לרשום למשתמש. הערך חייב להיות לפחות 999.

  6. אם רוצים שמופע AlloyDB Omni יפעל גם כשהמשתמש לא מחובר, מריצים את הפקודה הבאה.

    loginctl enable-linger ROOTLESS_USER

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

    • ‫ROOTLESS_USER: המשתמש שרוצים להריץ את AlloyDB Omni בתורו.

  7. אם אתם משתמשים ב-Docker, הריצו את הפקודה הבאה בתור ROOTLESS_USER:

    /usr/bin/dockerd-rootless-setuptool.sh install

  8. פותחים מעטפת חדשה כדי שהשינויים ב-sub-UID וב-sub-GID ייכנסו לתוקף.

יצירת ספרייה שבה AlloyDB Omni מאחסן נתונים

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

מערכת קבצים קיימת

Docker

mkdir -p DATA_DIR

Docker

mkdir -p DATA_DIR

Podman

mkdir -p DATA_DIR

Podman

mkdir -p DATA_DIR

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

  • ‫DATA_DIR: הנתיב לספרייה המארחת שבה הנתונים מאוחסנים.

מכשיר ייעודי

  1. יוצרים ספרייה במארח שבו הדיסק ייטען.

    mkdir -p MOUNT_POINT

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

    • ‫MOUNT_POINT: הנתיב של הספרייה ברמה העליונה שצריכה להכיל את המכונה של AlloyDB Omni.

  2. יוצרים טבלת מחיצות GPT עם מחיצה אחת במכשיר הדיסק.

    parted -s DEVICE_PATH mklabel gpt
parted -s DEVICE_PATH mkpart primary 0% 100%

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

    • ‫DEVICE_PATH: הנתיב שהוקצה על ידי מערכת ההפעלה למכשיר הדיסק.

  3. יוצרים מערכת קבצים בדיסק. אנחנו ממליצים להשתמש במערכת הקבצים ext4 ב-AlloyDB Omni.

    mkfs.ext4 -q -m 1 -L FS_LABEL -F PARTITION_PATH

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

    • ‫FS_LABEL: תווית למערכת הקבצים. האורך המקסימלי של תווית מערכת קבצים ב-ext4 הוא 16 תווים.
    • ‫PARTITION_PATH: הנתיב למחיצת הדיסק שמשמשת לאחסון הנתונים של הקונטיינר.

  4. מגדירים את המכשיר ויוצרים רשומה בקובץ /etc/fstab כדי שהדיסק יוגדר אחרי הפעלה מחדש.

    echo -e "LABEL=FS_LABEL\tMOUNT_POINT\text4\tdefaults\t0 0" | tee -a /etc/fstab
systemctl daemon-reload
mount MOUNT_POINT

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

    • ‫FS_LABEL: תווית למערכת הקבצים. האורך המקסימלי של תווית מערכת קבצים ב-ext4 הוא 16 תווים.
    • ‫MOUNT_POINT: הנתיב לספרייה ברמה העליונה שצריכה להכיל את מופע AlloyDB Omni.

  5. יוצרים ספריית נתונים במערכת הקבצים הספציפית של הקונטיינר.

    Rootful

    mkdir -p DATA_DIR

    Rootless

    mkdir -p DATA_DIR
chown ROOTLESS_USER:ROOTLESS_GROUP DATA_DIR

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

    • ‫DATA_DIR: הנתיב לספרייה המארחת שבה הנתונים מאוחסנים.
    • ‫ROOTLESS_USER: אם אתם משתמשים בסביבה ללא הרשאות בסיס, זה המשתמש שאתם רוצים שיהיה הבעלים של הספרייה.
    • ‫ROOTLESS_GROUP: אם אתם משתמשים בסביבה ללא הרשאות בסיס, זו הקבוצה שאתם רוצים שתהיה הבעלים של הספרייה.

יצירת הקונטיינר

Docker

docker run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 \
--restart=always \
-d IMAGE_URI

Docker

docker run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 \
--restart=always \
-d IMAGE_URI

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 \
--restart=always \
-d IMAGE_URI

Podman

podman run -d --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 \
--restart=always \
-d IMAGE_URI

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

  • ‫CONTAINER_NAME: השם שבו השתמשתם עבור הספרייה ביצירת ספרייה שבה AlloyDB Omni מאחסן נתונים.
  • ‫NEW_PASSWORD: הסיסמה שהוקצתה למשתמש postgres של הקונטיינר החדש אחרי שהוא נוצר.
  • ‫DATA_DIR: הנתיב לספרייה המארחת שבה הנתונים מאוחסנים.
  • ‫HOST_PORT: יציאת TCP במחשב המארח שאליה הקונטיינר צריך לפרסם את היציאה שלו 5432. כדי להשתמש ביציאת ברירת המחדל של PostgreSQL גם במחשב המארח, מציינים את 5432.
  • ‫IMAGE_URI: מחליפים במיקום התמונה שצוין באימייל שקיבלתם אחרי שביקשתם גישה.

התחברות למכונה

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

חיבור מקומי

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

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

חיבור מרחוק

psql -U postgres -p HOST_PORT -h IP_ADDRESS_OR_FQDN

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

  • ‫HOST_PORT: יציאת ה-TCP שבה השתמשתם ביצירת הקונטיינר.
  • ‫IP_ADDRESS_OR_FQDN: כתובת ה-IP או שם הדומיין שמוגדר במלואו של המארח שבו פועל AlloyDB Omni.

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

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