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

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

התקנה של AlloyDB Omni

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

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

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

בטבלה הבאה מפורטות דרישות המינימום של החומרה והתוכנה ל-AlloyDB Omni.

מערכת הפעלה/פלטפורמה	חומרה מינימלית	תוכנה מינימלית
Linux	מעבד x86-64 או Arm (*) עם תמיכה ב-AVX2 זיכרון RAM בנפח 2GB 10 GB של מקום בכונן	מערכת הפעלה שמבוססת על Debian (כמו Ubuntu) או 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).

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

משתמשים בפקודה docker run כדי ליצור קונטיינר חדש עם AlloyDB Omni בשם my-omni:
```
  docker run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:15.5.5
```
מחליפים את NEW_PASSWORD בסיסמה כדי להקצות את המשתמש postgres של מאגר התגים החדש אחרי שהוא נוצר.

הערה: כברירת מחדל, AlloyDB Omni מאחסן את הנתונים במאגר עצמו, ולא במערכת הקבצים של המארח. ספריית הנתונים נמחקת כשמוחקים את מאגר AlloyDB Omni. כדי לטעון ספריית נתונים שמאוחסנת במערכת הקבצים של המארח, פועלים לפי ההוראות במאמר התאמה אישית של ההתקנה של AlloyDB Omni.
התחברות ל-AlloyDB Omni בתוך קונטיינר באמצעות psql:
```
  docker exec -it my-omni psql -h localhost -U postgres
```
בחלון הטרמינל מוצג טקסט ההתחברות של psql שמסתיים בהנחיה postgres=#.

משתמשים בפקודה docker run כדי ליצור קונטיינר חדש עם AlloyDB Omni בשם my-omni:
```
  podman run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:15.5.5
```
מחליפים את NEW_PASSWORD בסיסמה כדי להקצות את המשתמש postgres של מאגר התגים החדש אחרי שהוא נוצר.

הערה: כברירת מחדל, AlloyDB Omni מאחסן את הנתונים במאגר עצמו, ולא במערכת הקבצים של המארח. ספריית הנתונים נמחקת כשמוחקים את מאגר AlloyDB Omni. כדי לטעון ספריית נתונים שמאוחסנת במערכת הקבצים של המארח, פועלים לפי ההוראות במאמר התאמה אישית של ההתקנה של AlloyDB Omni.
מתחברים ל-AlloyDB Omni בקונטיינר באמצעות psql:
```
podman exec -it my-omni psql -h localhost -U postgres
```
בחלון הטרמינל מוצג טקסט ההתחברות של psql שמסתיים בהנחיה postgres=#.

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

עוצרים את הקונטיינר של AlloyDB Omni שנקרא my-omni:
```
  docker container stop my-omni
```
מחיקת קונטיינר AlloyDB Omni בשם my-omni:
```
  docker container rm my-omni
```

עוצרים את קונטיינר AlloyDB Omni שנקרא my-omni:
```
  podman container stop my-omni
```
מוחקים את מאגר AlloyDB Omni שנקרא my-omni:
```
  podman container rm my-omni
```

הוראות להתקנת AlloyDB Omni בקונטיינר חדש לשימוש בסביבת ייצור מפורטות בדף התאמה אישית של התקנת AlloyDB Omni.