התקנת ממשק המשתמש באינטרנט

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

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

תכונה תיאור קונטיינרים (עצמאיים) ‏Kubernetes ‫RPM‏ (Linux) כלי תזמור של RPM
בחירת אשכול מסך קישוריות שמאפשר להגדיר, לרשום ולשמור פרטי כניסה לגישה לאשכולות היעד. נתמך נתמך נתמך נתמך
סקירה כללית של האשכול לוח בקרה לתצפית שמציג את כל המכונות הפעילות של האשכולות ותרשימי הטלמטריה. נתמך נתמך נתמך נתמך
מסדי נתונים דף סקירה כללית שבו מוצגות טבלאות קטלוג וגדלים של מסדי נתונים באשכול. נתמך נתמך נתמך נתמך
מנוע מבוסס-עמודות הגדרות תצורה ונתונים סטטיסטיים של ביצוע סריקות לשאילתות ניתוח. נתמך נתמך נתמך נתמך
דגלים לניהול מסד נתונים לוח תצפית שמוצגים בו דגלים פעילים והגדרות שחורגות מהגדרות ברירת המחדל. נתמך נתמך נתמך נתמך
תובנות לגבי שאילתות לוחות בקרה של טלמטריה וביצועי שאילתות, שמוצגים בהם היסטוגרמות מבניות ורשימות של שאילתות איטיות. נתמך נתמך נתמך נתמך
תובנות לגבי המערכת תרשימי טלמטריה שמציגים את צריכת המעבד (CPU), הזיכרון שבשימוש וקלט/פלט (I/O) בדיסק. לא נתמך (רק קונטיינר עצמאי) נתמך נתמך נתמך

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

לפני שמתקינים את ממשק המשתמש באינטרנט, צריך:

  1. משיגים את קובצי האימג' לפריסה, מורידים ומתקינים את AlloyDB Omni כדי להשתמש בממשק המשתמש באינטרנט: התקנת AlloyDB Omni באמצעות RPM.

  2. מגדירים את המשתמש במסד הנתונים.

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

    CREATE ROLE alloydbui WITH LOGIN PASSWORD 'PASSWORD';
GRANT pg_monitor TO alloydbui WITH INHERIT TRUE;

  3. מגדירים את רכיב המעקב ב-AlloyDB Omni.

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

    אם ההתקנה שלכם משתמשת בספריית נתונים בהתאמה אישית (PG_DATA_DIR), צריך להגדיר את /etc/systemd/system/alloydbomni_monitor.service.d/override.conf ולהפעיל מחדש את שירות המעקב:

    sudo mkdir -p /etc/systemd/system/alloydbomni_monitor.service.d
sudo tee /etc/systemd/system/alloydbomni_monitor.service.d/override.conf <<'EOF'
[Service]
Environment="PG_DATA_DIR=PG_DATA_DIR"
EOF
sudo systemctl daemon-reload
sudo systemctl restart alloydbomni_monitor

    מחליפים את PG_DATA_DIR בנתיב לספריית הנתונים של מסד הנתונים, לדוגמה /var/lib/postgresql/18/data או /data.

    כדי לוודא שסוכן המעקב פעיל ומייצא מדדים, מריצים את sudo systemctl status alloydbomni_monitor ו-curl http://localhost:9187/metrics.

    sudo mkdir -p /etc/systemd/system/alloydbomni18.service.d
sudo tee /etc/systemd/system/alloydbomni18.service.d/override.conf <<'EOF'
[Service]
CPUQuota=100%
MemoryMax=100%
IOAccounting=yes
EOF
sudo systemctl daemon-reload
sudo systemctl restart alloydbomni18

  4. מגדירים את Prometheus.

    כדי לראות את נתוני התרשימים בדפים Overview ו-System Insights, כולל השימוש ב-CPU, צריך להתקין ולהגדיר את Prometheus. פועלים לפי הוראות ההתקנה וההגדרה שמפורטות במאמר בחירה והתקנה של כלי מעקב.

שלבים אופציונליים

כדי להפעיל תכונות נוספות בממשק המשתמש באינטרנט:

  • הגדרת תובנות לגבי שאילתות

    כדי להשתמש בתכונה "תובנות לגבי שאילתות", צריך להפעיל את התוסף 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 בטבלה.
מידע נוסף זמין במאמר פיתוח אפליקציות של AI גנרטיבי באמצעות AlloyDB AI.

התקנת ממשק המשתמש באינטרנט

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

התקנה באמצעות RPM

‫Google חותמת על חבילות ה-RPM של AlloyDB Omni באמצעות מפתח החתימה של חבילת Linux. כדי להגדיר את מאגר YUM עם אימות חתימת GPG ולהתקין את חבילת ה-RPM של ממשק המשתמש באינטרנט:

  1. מגדירים את מאגר YUM בספרייה המקומית:

    sudo tee -a /etc/yum.repos.d/alloydbomni_ui.repo << EOF
[alloydbomni_ui]
name=alloydbomni_ui
baseurl=ALLOYDB_OMNI_COMMON_REPOSITORY_URL
enabled=1
repo_gpgcheck=1
gpgcheck=1
gpgkey=https://dl.google.com/linux/linux_signing_key.pub
EOF

    sudo yum makecache

    מחליפים את ALLOYDB_OMNI_COMMON_REPOSITORY_URL בכתובת ה-URL של המאגר המשותף של AlloyDB Omni.

  2. מתקינים את חבילת ה-RPM של ממשק המשתמש באינטרנט:

    sudo dnf install alloydbomni_ui

הפעלת ממשק המשתמש באינטרנט

ממשק המשתמש באינטרנט משתמש ב-Java Keystore כדי להגן על מפתח AES בגודל 256 ביט שמשמש להצפנת נתוני החיבור. כשמפעילים את ממשק המשתמש באינטרנט, מציינים משתנה סביבה שמכיל את הסיסמה.

הפעלת ממשק המשתמש באינטרנט ב-Linux

export ALLOYDB_OMNI_UI_KEYSTORE="PASSWORD"
/opt/alloydbomni/app/alloydb-ui/app/bin/alloydb

פתיחת ממשק המשתמש באינטרנט

כדי לראות את ממשק המשתמש באינטרנט, פותחים דפדפן בכתובת http://HOST:9080.

מחליפים את HOST בשם המארח או בכתובת ה-IP של הצומת שבו מותקן ממשק המשתמש באינטרנט.

  • אם הגדרתם נתיב בסיס מותאם אישית באמצעות משתנה הסביבה האופציונלי ALLOYDB_OMNI_BASE_PATH (לדוגמה, כשמארחים מאחורי שרת proxy הפוך קיים), צריך להוסיף את הנתיב לכתובת ה-URL: http://HOST:9080/BASE_PATH.

  • אפשר להגדיר את נתיב הבסיס בלי לוכסן בהתחלה, לדוגמה ALLOYDB_OMNI_BASE_PATH=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 שניות) כדי לשלוח שאילתות לנתונים סטטיסטיים בלי להעמיס על צומתי מסד הנתונים.

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