התאמה אישית של ההתקנה של AlloyDB Omni

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

‫AlloyDB Omni נפרס באמצעות קובץ אימג' של Docker, שמאפשר צורות שונות של התאמה אישית. בדף הזה מוצגים כמה מההתאמות האישיות הנפוצות.

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

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

בטבלה הבאה מפורטות הגדרות החומרה והתוכנה המומלצות ל-AlloyDB Omni.

מערכת הפעלה או פלטפורמה הגדרת החומרה המומלצת הגדרת תוכנה מומלצת
Linux
  • מעבד x86-64 או Arm (*) עם תמיכה ב-AVX2
  • ‫8GB של RAM לכל מעבד שהוקצה ל-AlloyDB Omni
  • מקום בכונן בנפח 20GB ומעלה
    		•
  • מערכת הפעלה שמבוססת על Debian (כמו Ubuntu) או RHEL 9
  • ליבת Linux בגרסה 6.1 ומעלה, או כל ליבת Linux בגרסה ישנה יותר מ-5.3 שתומכת בהוראות MADV_COLLAPSE ו-MADV_POPULATE_WRITE
  • Cgroupsv2 enabled
  • ‫Docker Engine מגרסה 25.0.0 ואילך או Podman מגרסה 5.0.0 ואילך
    		•
    macOS
  • מעבד Intel עם תמיכה ב-AVX2 או שבב M
  • ‫8GB של RAM לכל מעבד שהוקצה ל-AlloyDB Omni
  • מקום בכונן של 20GB ומעלה
    		•
  • ‫Docker Desktop מגרסה 4.30 ואילך
    		•
    ‫(*) התמיכה ב-Arm נמצאת בגרסת טרום-השקה (Preview).

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

    שרת יחיד

    התקנה של ספריית נתונים חיצונית

    כברירת מחדל, הפקודה במדריך למתחילים: התקנת AlloyDB Omni מאחסנת את נתוני מסד הנתונים באזור שמנוהל על ידי Docker. זה נוח כשמתחילים, אבל מקשה על מציאת ספריית הנתונים והשימוש בה. במקום זאת, אפשר להגדיר bind mount כדי למפות את ספריית הנתונים למיקום מוכר בדיסק.

    docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
-v DATA_DIR:/var/lib/postgresql/data \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

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

    • ‫CONTAINER_NAME: השם שיוקצה לקונטיינר החדש של AlloyDB Omni ב-Container Registry של המכונה המארחת – לדוגמה, my-omni.

    • ‫NEW_PASSWORD: הסיסמה שהוקצתה למשתמש postgres של הקונטיינר החדש אחרי שהוא נוצר.

    • ‫DATA_DIR: הנתיב של מערכת הקבצים שרוצים ש-AlloyDB Omni ישתמש בו לספריית הנתונים.

    • ‫HOST_PORT: יציאת ה-TCP במחשב המארח שאליה הקונטיינר צריך לפרסם את יציאה 5432 שלו. כדי להשתמש ביציאת ברירת המחדל של PostgreSQL גם במכונת המארח, מציינים 5432.

    הפעלת ulimits

    הפרמטרים של ulimit מציינים מגבלות שונות על תהליכים שמותר להשתמש בהן בקונטיינר של Docker. כדי להשיג ביצועים אופטימליים, AlloyDB Omni משנה את העדיפויות של התהליכים כדי לאפשר לתהליכים קריטיים של PostgreSQL לפעול בעדיפות גבוהה יותר, כלומר הם מקבלים הקצאה גדולה יותר של מעבדי CPU זמינים. כדי לאפשר את זה, צריך לציין את -20:-20, שמסיר את המגבלות על מאגר AlloyDB Omni.

    docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--ulimit=nice=-20:-20 \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

    ציון מנהל התקן לרישום ביומן

    כברירת מחדל, Docker לא מבצע החלפת יומנים. זה עלול לתפוס הרבה מקום בכונן, ובסופו של דבר לגרום לניצול מלא של המקום בכונן. אפשר להגדיר את Docker כך שישתמש במנהל התקן אחר לרישום ביומן. לדוגמה, כדי לרשום ביומן של journald:

    docker run --name CONTAINER_NAME \
-e POSTGRES_PASSWORD=NEW_PASSWORD \
--log-driver=journald \
-p HOST_PORT:5432 -d google/alloydbomni:15.5.4

    למידע נוסף על Docker ועל מנהלי התקנים של רישום ביומן, קראו את המאמר הגדרת מנהלי התקנים של רישום ביומן במסמכי התיעוד של Docker.

    אפשר גם להגדיר רישום ביומן באמצעות PostgreSQL. מידע נוסף זמין במסמכי התיעוד של PostgreSQL בנושא דיווח על שגיאות ורישום ביומן.

    טעינת אמצעי אחסון של זיכרון משותף

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

    Linux

    כדי שהזיכרון המשותף יהיה זמין לקונטיינר, צריך לטעון את /dev/shm:

       docker run --name CONTAINER_NAME \
     -e POSTGRES_PASSWORD=NEW_PASSWORD \
     -p HOST_PORT:5432 \
     -v /dev/shm:/dev/shm \
     -d google/alloydbomni:15.5.4

    macOS

    כדי שהזיכרון המשותף יהיה זמין לקונטיינר, צריך לכלול את הדגל --shm-size:

     docker run --name CONTAINER_NAME \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -p HOST_PORT:5432 \
    --shm-size=SHARED_MEMORY_SIZE \
    -d google/alloydbomni:15.5.4

    מחליפים את SHARED_MEMORY_SIZE בגודל שרוצים להגדיר ל-/dev/shm במאגר, בפורמט שמתואר במאמר בנושא הרצת קונטיינרים. לדוגמה, כדי לציין ג'יגה-בייט אחד, משתמשים בערך 1g.

    מומלץ להגדיר את גודל הזיכרון המשותף למספר מגה-בייטים ששווה לפחות לערך של מסד הנתונים של הדגל google_job_scheduler.max_parallel_workers_per_job, כפול 250. מידע נוסף על המנוע מבוסס-העמודות זמין במאמר הגדרת המנוע מבוסס-העמודות ב-AlloyDB Omni.

    לדוגמה, אם הדגל google_job_scheduler.max_parallel_workers_per_job של מסד הנתונים מוגדר לערך ברירת המחדל שלו 2, כדאי להוסיף דגל של --shm-size=500m או יותר כשמפעילים את שרת מסד הנתונים.

    מידע נוסף על הדגל --shm-size זמין במאמר הפעלת קונטיינרים.