בדף הזה מתועדת גרסה 15.5.2 של AlloyDB Omni באמצעות אפשרות הפריסה containers. בוחרים אפשרות פריסה אחרת.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

במאמר הזה נסביר גם איך:

יוצרים מחיצת דיסק חדשה כדי לייעל את אחסון הנתונים.
מגדירים את השרת.
לוודא תאימות ל-Debian,‏ Ubuntu ו-RHEL.

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

דרישות מערכת

‫Debian

מכונה וירטואלית או פיזית שמופעלת בה מערכת הפעלה מבוססת Debian, כמו Debian או Ubuntu.
לפחות 2 מעבדים, עם ארכיטקטורת x86/AMD64.
זיכרון RAM בנפח 2GB לפחות. כדי להשיג ביצועים אופטימליים, מומלץ להקצות 8 GB של RAM לכל CPU.
נפח אחסון זמין של 20GB לפחות.
גישת root ללא הגבלה במערכת ההפעלה.
‫Docker מגרסה 20.10 ואילך.
ליבת Linux מגרסה 4.18 ואילך. לקבלת הביצועים הטובים ביותר, מומלץ להשתמש בגרסת ליבה 5.3 ומעלה.
‫Linux cgroup v2 מופעל.
כברירת מחדל, cgroup v2 מופעל ברוב מערכות Linux המודרניות. כדי לבדוק אם cgroup v2 מופעל, מריצים את הפקודה stat -fc %T /sys/fs/cgroup/ במעטפת. אם cgroup v2 מופעל, בפלט הפקודה יופיע cgroup2fs.
אם רוצים לבצע שילוב עם Vertex AI, צריך להשתמש ב-Google Cloud CLI שזמין בסביבה שלכם.
כדי להתקין את AlloyDB Omni בפלטפורמת ענן, מומלץ להשתמש בסוגי המכונות הבאים:
- ב- Google Cloud, אנחנו ממליצים על מקרים של n2-highmem.
- ב-Amazon Web Services, אנחנו ממליצים על מופעי R6i.
- ב-Microsoft Azure, מומלץ להשתמש במופעי Ebsv5.
מומלץ להשתמש במכשיר אחסון SSD ייעודי לאחסון הנתונים. אם משתמשים במכשיר פיזי למטרה הזו, מומלץ לחבר אותו ישירות למכונת המארח.

RHEL

מכונה וירטואלית או פיזית שמופעלת בה גרסה 8 ואילך של Red Hat Enterprise Linux‏ (RHEL). כדי להשתמש בתכונות של ניהול זיכרון אוטומטי ב-AlloyDB Omni, צריך להשתמש ב-RHEL מגרסה 9 ואילך.
לפחות 2 מעבדים, עם ארכיטקטורת x86/AMD64.
זיכרון RAM בנפח 2GB לפחות. כדי להשיג ביצועים אופטימליים, מומלץ להקצות 8 GB של RAM לכל CPU.
נפח אחסון זמין של 20GB לפחות.
גישת root ללא הגבלה במערכת ההפעלה.
‫Docker מגרסה 20.10 ואילך.
ליבת Linux מגרסה 4.18 ואילך. לקבלת הביצועים הטובים ביותר, מומלץ להשתמש בגרסה 5.3 של ליבת המערכת או בגרסה מתקדמת יותר.
‫Linux cgroup v2 מופעל.
כברירת מחדל, cgroup v2 מופעל ברוב מערכות Linux המודרניות. כדי לבדוק אם cgroup v2 מופעל, מריצים את הפקודה stat -fc %T /sys/fs/cgroup/ במעטפת. אם cgroup v2 מופעל, בפלט הפקודה יופיע cgroup2fs.
אם רוצים לבצע שילוב עם Vertex AI, צריך להשתמש ב-Google Cloud CLI שזמין בסביבה שלכם.
כדי להתקין את AlloyDB Omni בפלטפורמת ענן, מומלץ להשתמש בסוגי המכונות הבאים:
- ב- Google Cloud, אנחנו ממליצים על מקרים של n2-highmem.
- ב-Amazon Web Services, אנחנו ממליצים על מופעי R6i.
- ב-Microsoft Azure, מומלץ להשתמש במופעי Ebsv5.
מומלץ להשתמש במכשיר אחסון SSD ייעודי לאחסון הנתונים. אם משתמשים במכשיר פיזי למטרה הזו, מומלץ לחבר אותו ישירות למכונת המארח.

הורדה והתקנה של AlloyDB Omni

מתקינים את AlloyDB Omni CLI.
משתמשים ב-AlloyDB Omni CLI כדי לוודא שמחשב ה-Linux מוכן להתקנת AlloyDB Omni:
```
sudo alloydb system-check
```
אם צריך, משנים את המערכת עד שהפלט של הפקודה system-check מחזיר בדיקה מוצלחת.
אופציונלי: כדי ליצור מחיצה חדשה באחסון ש-AlloyDB Omni ישתמש בה לאחסון נתונים, מומלץ להשתמש במערכת קבצים מסוג ext4 כדי להשיג ביצועים אופטימליים.
1. כדי ליצור מערכת קבצים מסוג ext4, משתמשים בפקודה הבאה:
```
mkfs.ext4 -m 1 -F "$disk_path"
```
2. כדי לטעון את הדיסק, משתמשים בפקודה הבאה:
```
mount --make-shared -o noatime,discard,errors=panic "$disk_path" "$disk_mountpoint"
```
מתקינים את תוכנת השרת באחת מהדרכים הבאות:

הערה: כדי להתקין את AlloyDB Omni עם פונקציות של למידת מכונה (ML) מופעלות, כולל היכולת לשלוח שאילתות למודלים גדולים של שפה (LLM), אפשר לעיין במאמר התקנה של AlloyDB Omni עם AlloyDB AI.
- כדי להגדיר את השרת כמופע ראשי, מריצים את הפקודה הבאה:
```
sudo alloydb database-server install --data-dir=$(realpath DATA_DIR)
```
  מחליפים את DATA_DIR בספרייה במערכת הקבצים המקומית שבה רוצים ש-AlloyDB Omni יאחסן את הנתונים, המטא-נתונים וקובצי ההגדרות שלו. ‫AlloyDB Omni מנסה ליצור את הספרייה הזו אם היא עדיין לא קיימת. אם לא מציינים את הערך הזה, ברירת המחדל של AlloyDB Omni היא /var/alloydb/main/.
  
  כדי ש-AlloyDB Omni יאזין לחיבורים ביציאת TCP שאינה ברירת המחדל 5432, צריך לכלול את הדגל --pg-port:
```
sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --pg-port=PORT
```
  מחליפים את PORT במספר יציאת ה-TCP שרוצים ש-AlloyDB Omni יקבל דרכה חיבורים.
- כדי להגדיר את השרת כעותק לקריאה, כוללים את הדגלים --replica-source-ip ו---replica-source-port:
```
sudo alloydb database-server install \
    --data-dir=$(realpath DATA_DIR) \
    --replica-source-ip=SOURCE_IP \
    --replica-source-port=SOURCE_PORT
```
  מחליפים את מה שכתוב בשדות הבאים:
  - ‫DATA_DIR: הספרייה במערכת הקבצים המקומית שבה רוצים ש-AlloyDB Omni ישמור את הנתונים, המטא-נתונים וקבצי ההגדרות שלו. ‫AlloyDB Omni מנסה ליצור את הספרייה הזו אם היא עדיין לא קיימת. אם לא מציינים את הערך הזה, ברירת המחדל של AlloyDB Omni היא /var/alloydb/main/.
  - ‫SOURCE_IP: כתובת ה-IP של מכונת AlloyDB Omni הראשית שממנה מתבצעת השכפול.
  - ‫SOURCE_PORT: יציאת ה-TCP של מכונת AlloyDB Omni הראשית שממנה מתבצעת השכפול. אם לא תציינו את הערך הזה, AlloyDB Omni יחיל ערך ברירת מחדל של 5432.
  מידע נוסף על רפליקות לקריאה ב-AlloyDB Omni זמין במאמר בנושא יצירת רפליקה לקריאה בלבד.
אם המערכת שלכם מריצה Red Hat Enterprise Linux, צריך לעדכן את הקובץ /usr/lib/tuned/virtual-guest/tuned.conf באופן הבא:
```
vm.swappiness=1
```

התחברות לשרת מסד הנתונים ושימוש בו

התחברות ל-AlloyDB Omni באמצעות psql:

sudo docker exec -it pg-service psql -h localhost -U postgres

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