בדף הזה מוסבר איך להתקין את ממשק המשתמש של AlloyDB Omni באינטרנט כדי לעקוב אחרי התקינות וההגדרות של אשכולות מסדי הנתונים בניהול עצמי. ממשק המשתמש באינטרנט כולל את התכונות הבאות:
| תכונה | תיאור | קונטיינרים (עצמאיים) | Kubernetes | RPM (Linux) | כלי תזמור של RPM |
|---|---|---|---|---|---|
| בחירת אשכול | מסך קישוריות שמאפשר להגדיר, לרשום ולשמור פרטי כניסה לגישה לאשכולות היעד. | נתמך | נתמך | נתמך | נתמך |
| סקירה כללית של האשכול | לוח בקרה לתצפית שמציג את כל המכונות הפעילות של האשכולות ותרשימי הטלמטריה. | תמיכה חלקית. אין תמיכה בתרשימי טלמטריה. | נתמך | נתמך | נתמך |
| מסדי נתונים | דף סקירה כללית שבו מוצגות טבלאות קטלוג וגדלים של מסדי נתונים באשכול. | נתמך | נתמך | נתמך | נתמך |
| מנוע מבוסס-עמודות | הגדרות תצורה ונתונים סטטיסטיים של ביצוע סריקות לשאילתות ניתוח. | נתמך | נתמך | נתמך | נתמך |
| דגלים לניהול מסד נתונים | לוח תצפית שמוצגים בו דגלים פעילים והגדרות שחורגות מהגדרות ברירת המחדל. | נתמך | נתמך | נתמך | נתמך |
| תובנות לגבי שאילתות | לוחות בקרה של טלמטריה וביצועי שאילתות, שמוצגים בהם היסטוגרמות מבניות ורשימות של שאילתות איטיות. | נתמך | נתמך | נתמך | נתמך |
| תובנות לגבי המערכת | תרשימי טלמטריה שמציגים את צריכת המעבד (CPU), הזיכרון שבשימוש וקלט/פלט (I/O) בדיסק. | לא נתמך | נתמך | נתמך | נתמך |
לפני שמתחילים
לפני שמתקינים את ממשק המשתמש באינטרנט, צריך לבצע את הפעולות הבאות:
משיגים את קובצי האימג' לפריסה, מורידים ומתקינים את AlloyDB Omni כדי להשתמש בממשק המשתמש באינטרנט: התקנת AlloyDB Omni באמצעות קונטיינרים.
מגדירים את המשתמש במסד הנתונים.
ממשק המשתמש באינטרנט מסתמך על חשבון משתמש מוגבל, שיש לו את התפקיד
pg_monitorכדי לגשת למסד הנתונים. מגדירים את המשתמש הזה בכל אשכול על ידי הרצת הפקודות הבאות בסשן שלpsql:CREATE ROLE alloydbui WITH LOGIN PASSWORD 'PASSWORD'; GRANT pg_monitor TO alloydbui WITH INHERIT TRUE;מחליפים את
PASSWORDבסיסמה לתפקידalloydbuiבמסד הנתונים.מגדירים את Prometheus.
כדי לראות את נתוני התרשימים בדפים Overview ו-System Insights, כולל השימוש ב-CPU, צריך להתקין ולהגדיר את Prometheus. הערה: סוכן מעקב בקונטיינר לא זמין כשפורסים את AlloyDB Omni כקונטיינר נפרד. כשמתחברים לפריסות של קונטיינרים עצמאיים, אין תמיכה במדדים של תרשימי Prometheus בדפים Overview ו-System Insights.
שלבים אופציונליים
כדי להפעיל תכונות נוספות בממשק האינטרנט, צריך לבצע את ההגדרות האופציונליות הבאות:
הגדרת תובנות לגבי שאילתות
כדי להשתמש בתכונה "תובנות לגבי שאילתות", צריך להפעיל את התוסף
pg_stat_statements. בסשן שלpsql, מריצים את הפקודות הבאות כדי להגדיר את הספריות:ALTER SYSTEM SET shared_preload_libraries=google_columnar_engine,google_job_scheduler,google_storage,google_db_advisor,pg_stat_statements; ALTER SYSTEM SET pg_stat_statements.max = 10000; ALTER SYSTEM SET pg_stat_statements.track_utility = on; ALTER SYSTEM SET track_io_timing = on;לאחר מכן, מריצים את הפקודה הבאה בכל מסד נתונים בנפרד כדי ליצור את התוסף:
CREATE EXTENSION IF NOT EXISTS pg_stat_statements;כדי שהשינויים ייכנסו לתוקף, צריך להפעיל מחדש את מסד הנתונים. אם אתם מתכננים להפעיל את המנוע מבוסס-העמודות, חכו עם ההפעלה מחדש עד שההגדרה תסתיים.
הגדרת מנוע מבוסס-עמודות
כדי לגשת לנתונים של המנוע מבוסס-העמודות בממשק המשתמש באינטרנט, צריך להגדיר את המנוע כמו שמתואר בסקירה הכללית של המנוע מבוסס-העמודות.
הגדרת AlloyDB AI
כדי להשתמש בתכונות של AlloyDB AI בממשק האינטרנט, צריך לתת את ההרשאות הבאות:
- כדי לאכלס אינדקסים של וקטורים, צריך לתת למשתמש
alloydbuiאת ההרשאהSELECTב-pg_stat_ann_indexes. - כדי להציג עמודות וקטוריות, צריך לתת למשתמש
alloydbuiאת ההרשאהSELECTבטבלה.
- כדי לאכלס אינדקסים של וקטורים, צריך לתת למשתמש
התקנת ממשק המשתמש באינטרנט
אפשר להתקין ולהפעיל את ממשק המשתמש באינטרנט בכל צומת. ממשק המשתמש באינטרנט לא דורש צומת ייעודי. ההתקנה המלאה דורשת מקום פנוי בכונן בנפח של כ-250MB. אחרי שמורידים את קובצי האימג' לפריסה ואת AlloyDB Omni, אפשר להתקין ולהפעיל את ממשק המשתמש באינטרנט.
התקנה באמצעות קובץ אימג' של Docker או Podman
כשמריצים את AlloyDB Omni באמצעות קונטיינרים, צריך לשלוף את קובץ האימג' של Docker או Podman:
Docker
docker pull ALLOYDB_OMNI_UI_IMAGE_TAG
Podman
podman pull ALLOYDB_OMNI_UI_IMAGE_TAG
מחליפים את ALLOYDB_OMNI_UI_IMAGE_TAG בתג של קובץ האימג' של הקונטיינר של ממשק המשתמש באינטרנט.
הפעלת ממשק המשתמש באינטרנט
ממשק המשתמש באינטרנט משתמש ב-Java Keystore כדי להגן על מפתח AES בגודל 256 ביט שמשמש להצפנת נתוני החיבור. כשמפעילים את ממשק המשתמש באינטרנט, מציינים משתנה סביבה שמכיל את הסיסמה.
הפעלת ממשק המשתמש באינטרנט בקונטיינרים
מריצים את הפקודה הבאה כדי להפעיל את מאגר ממשק המשתמש באינטרנט. אם מתחברים להתקנה של AlloyDB Omni באותו מארח, צריך לכלול את הדגל --add-host=host.docker.internal:host-gateway:
Docker
docker run --name alloydb-omni-ui \
--add-host=host.docker.internal:host-gateway \
-e ALLOYDB_OMNI_UI_KEYSTORE="PASSWORD" \
-p 9080:9080 \
ALLOYDB_OMNI_UI_IMAGE_TAG
Podman
podman run --name alloydb-omni-ui \
--add-host=host.docker.internal:host-gateway \
-e ALLOYDB_OMNI_UI_KEYSTORE="PASSWORD" \
-p 9080:9080 \
ALLOYDB_OMNI_UI_IMAGE_TAG
מחליפים את מה שכתוב בשדות הבאים:
PASSWORD: הסיסמה של מאגר המפתחות שלALLOYDB_OMNI_UI_KEYSTORE.
ALLOYDB_OMNI_UI_IMAGE_TAG: התג של קובץ האימג' של הקונטיינר של ממשק המשתמש באינטרנט.
פתיחת ממשק המשתמש באינטרנט
כדי לראות את ממשק המשתמש באינטרנט, פותחים דפדפן בכתובת http://HOST:9080.
מחליפים את HOST בשם המארח או בכתובת ה-IP של הצומת שבו מותקן ממשק המשתמש באינטרנט.
אם הגדרתם נתיב בסיס מותאם אישית באמצעות משתנה הסביבה האופציונלי
ALLOYDB_OMNI_BASE_PATH, למשל כשמארחים מאחורי שרת proxy הפוך קיים, צריך להוסיף את הנתיב לכתובת ה-URL:http://HOST:9080/BASE_PATH.מחליפים את
BASE_PATHבנתיב הבסיס בהתאמה אישית.אפשר להגדיר את נתיב הבסיס בלי לוכסן בהתחלה, לדוגמה
ALLOYDB_OMNI_BASE_PATH=BASE_PATH. כל האפשרויות הבאות הן חלופות תקינות:/test/test/test/test
מגבלות
לממשק המשתמש באינטרנט יש את המגבלות הבאות:
תרשימי הסקירה הכללית והתובנות לגבי המערכת לא זמינים כשמתחברים לפריסות של קונטיינרים עצמאיים של AlloyDB Omni, כי סוכן מעקב בקונטיינר לא זמין לפריסות של קונטיינרים עצמאיים. כל שאר התכונות והמדדים שאינם תרשימים ממשיכים לפעול כרגיל.
כדי לראות את נתוני המנוע מבוסס-העמודות בטבלה מסוימת, למשתמש
alloydbuiצריכה להיות לפחות הרשאה אחת בטבלה הזו, למשלSELECT.כדי להציג נתוני אינדקס וקטורי, המשתמש
alloydbuiצריך את ההרשאהSELECTב-pg_stat_ann_indexes.כדי להציג נתונים של עמודת וקטור בטבלה מסוימת, המשתמש ב-
alloydbuiצריך את ההרשאהSELECTבטבלה הזו.
שיטות מומלצות ואזהרות
כשמתקינים ומגדירים את ממשק המשתמש באינטרנט, חשוב לפעול לפי השיטות המומלצות הבאות ולהביא בחשבון את האזהרות הבאות:
- הגנה על הסיסמה של Keystore: ממשק המשתמש באינטרנט יוצר Java Keystore כדי להגן על מפתח ההצפנה של מסד הנתונים ב-AES באורך 256 ביט. צריך להשתמש בביטוי סיסמה חזק בשביל
ALLOYDB_OMNI_UI_KEYSTORE. שגיאות בפענוח מתרחשות אם מעבירים את קובצי התצורה ומתחברים באמצעות סיסמה לא תואמת למאגר המפתחות. - איסוף מדדים של Prometheus: מגדירים את כלי האיסוף כך שידגמו את מכונות היעד בטווחי זמן סטנדרטיים (15 עד 30 שניות) כדי לשלוח שאילתות לנתונים סטטיסטיים בלי להעמיס על צומתי מסד הנתונים.
המאמרים הבאים