ניהול תפקידי משתמשים
ב-AlloyDB Omni משתמשים באותה קבוצה של תפקידי משתמשים מוגדרים מראש ב-PostgreSQL שכלולים ב-AlloyDB ל-PostgreSQL, עם ההבדלים הבאים:
AlloyDB Omni כולל תפקיד של משתמש-על בשם
alloydbadmin, ותפקיד של משתמש רגיל בשםalloydbmetadata.למשתמש
postgresשמוגדר כברירת מחדל יש תפקיד של משתמש-על.לכל שאר תפקידי המשתמשים שמוגדרים מראש אין הרשאות. הם שמורים לשימושים פוטנציאליים בעתיד.
כמו ב-AlloyDB, מומלץ לבצע את השלבים הבאים כשמגדירים מסד נתונים:
מגדירים או מייבאים את מסדי הנתונים באמצעות תפקיד המשתמש
postgres. בהתקנה חדשה, לתפקיד הזה יש הרשאות סופר-משתמש, ולא נדרשת סיסמה.יוצרים תפקידי משתמשים חדשים עם רמת הגישה הנכונה לטבלאות של האפליקציה, שוב באמצעות תפקיד המשתמש
postgres.מגדירים את האפליקציה כך שתתחבר למסד הנתונים באמצעות התפקידים החדשים האלה עם הגישה המוגבלת.
אתם יכולים ליצור ולהגדיר כמה תפקידי משתמשים חדשים שאתם צריכים. אל תשנו או תמחקו את תפקידי המשתמשים שכלולים ב-AlloyDB Omni.
מידע נוסף זמין במאמר בנושא ניהול משתמשים ותפקידים ב-AlloyDB Omni.
מעקב אחרי AlloyDB Omni
כדי לעקוב אחרי ההתקנה של AlloyDB Omni, צריך לקרוא ולנתח את קובצי היומן של AlloyDB Omni.
AlloyDB Omni שפועל ב-Kubernetes מספק קבוצה של מדדים בסיסיים שזמינים כנקודות קצה (endpoints) של Prometheus. רשימת המדדים הזמינים מופיעה במאמר בנושא מדדי AlloyDB Omni.
בנוסף, AlloyDB Omni שפועל ב-Kubernetes חושף מדדים ממשאבים בהתאמה אישית באמצעות kube-state-metrics (KSM). כדי להפעיל מדדים של משאבים בהתאמה אישית, קראו את המאמר מעקב אחרי משאבים בהתאמה אישית של אופרטור AlloyDB Omni Kubernetes.
שרת יחיד
כברירת מחדל, כדי לאחזר את היומנים של AlloyDB Omni, מריצים את הפקודה:
Docker
docker logs CONTAINER_NAMEמחליפים את CONTAINER_NAME בשם של קונטיינר AlloyDB Omni.
כדי להגדיר את אופן הרישום ביומן של AlloyDB Omni, קראו את המאמר התאמה אישית של התקנת AlloyDB Omni.
Podman
podman logs CONTAINER_NAMEמחליפים את CONTAINER_NAME בשם של קונטיינר AlloyDB Omni.
כדי להגדיר את אופן הרישום ביומן של AlloyDB Omni, קראו את המאמר התאמה אישית של התקנת AlloyDB Omni.
Kubernetes
איך מוצאים את קובצי היומן של אשכול מסד הנתונים
הקבצים postgresql.audit ו-postgresql.log נמצאים במערכת הקבצים של pod מסד הנתונים. השדה postgresql.audit מופיע רק אם הפעלתם את pgaudit.
כדי לגשת לקבצים האלה, פועלים לפי השלבים הבאים:
מגדירים משתנה סביבה שמכיל את השם של פוד מסד הנתונים.
export DB_POD=`kubectl get pod -l alloydbomni.internal.dbadmin.goog/dbcluster=DB_CLUSTER_NAME,alloydbomni.internal.dbadmin.goog/task-type=database -o jsonpath='{.items[0].metadata.name}'`מחליפים את
DB_CLUSTER_NAMEבשם של אשכול מסד הנתונים. זהו אותו שם של אשכול מסדי הנתונים שהצהרתם עליו כשיצרתם אותו.מריצים מעטפת ב-pod של מסד הנתונים כמשתמש root.
kubectl exec ${DB_POD} -it -- /bin/bashמוצאים את קובצי היומן בספרייה
/obs/diagnostic/:/obs/diagnostic/postgresql.audit/obs/diagnostic/postgresql.log
רשימת שירותי מעקב
v1.0
כשיוצרים אשכול של מסדי נתונים, AlloyDB Omni יוצר את שירות המעקב הבא לכל משאב מותאם אישית של מכונה באשכול של מסדי הנתונים באותו מרחב שמות:
al-INSTANCE_NAME-monitoring-system
כדי להציג את רשימת שירותי המעקב, מריצים את הפקודה הבאה.
kubectl get svc -n NAMESPACE | grep monitoring
מחליפים את NAMESPACE במרחב השמות שאליו שייך האשכול.
בדוגמה הבאה של תגובה מוצגים השירותים al-1060-dbc-monitoring-system, al-3de6-dbc-monitoring-system ו-al-4bc0-dbc-monitoring-system. כל שירות תואם למכונה אחת.
al-1060-dbc-monitoring-system ClusterIP 10.0.15.227 <none> 9187/TCP 7d20h
al-3de6-dbc-monitoring-system ClusterIP 10.0.5.205 <none> 9187/TCP 7d19h
al-4bc0-dbc-monitoring-system ClusterIP 10.0.15.92 <none> 9187/TCP 7d19h
גרסה < 1.0
כשיוצרים אשכול של מסדי נתונים, AlloyDB Omni יוצר את שירותי המעקב הבאים באותו מרחב שמות של אשכול מסדי הנתונים:
DB_CLUSTER-monitoring-dbDB_CLUSTER-monitoring-system
כדי להציג את רשימת שירותי המעקב, מריצים את הפקודה הבאה.
kubectl get svc -n NAMESPACE | grep monitoring
מחליפים את NAMESPACE במרחב שמות שהאשכול שייך אליו.
בדוגמה הבאה של תגובה מוצגים השירות al-2953-dbcluster-foo7-monitoring-system והשירות al-2953-dbcluster-foo7-monitoring-db.
al-2953-dbcluster-foo7-monitoring-db ClusterIP 10.36.3.243 <none> 9187/TCP 44m
al-2953-dbcluster-foo7-monitoring-system ClusterIP 10.36.7.72 <none> 9187/TCP 44m
הצגת מדדי Prometheus משורת הפקודה
היציאה 9187 נקראת metricsalloydbomni בכל שירותי המעקב.
מגדירים העברה ליציאה אחרת מהסביבה המקומית לשירות המעקב.
kubectl port-forward service/MONITORING_SERVICE -n NAMESPACE MONITORING_METRICS_PORT:metricsalloydbomniמחליפים את מה שכתוב בשדות הבאים:
MONITORING_SERVICE: השם של שירות המעקב שרוצים להעביר, לדוגמהal-1060-dbc-monitoring-system.
NAMESPACE: מרחב השמות שאליו שייך האשכול.
MONITORING_METRICS_PORT: יציאת TCP מקומית זמינה.
התגובה הבאה מראה שהשירותים מועברים.
Forwarding from 127.0.0.1:9187 -> 9187 Forwarding from [::1]:9187 -> 9187בזמן שהפקודה הקודמת פועלת, אפשר לגשת למדדי המעקב באמצעות HTTP ביציאה שציינתם. לדוגמה, אפשר להשתמש ב-
curlכדי לראות את כל המדדים כטקסט פשוט:curl http://localhost:MONITORING_METRICS_PORT/metrics
הצגת מדדים באמצעות Prometheus API
מפתח התווית alloydbomni.internal.dbadmin.goog/task-type והיציאה metricsalloydbomni זמינים כברירת מחדל לכל שירותי המעקב ב-AlloyDB Omni. אתם יכולים להשתמש בהם יחד עם משאב מותאם אישית אחד של serviceMonitor כדי לבחור את כל השירותים לכל מרחבי השמות באשכול מסד הנתונים.
מידע נוסף על השימוש ב-Prometheus API זמין במסמכי התיעוד של Prometheus Operator.
הדוגמה הבאה היא שדה spec של המשאב בהתאמה אישית serviceMonitor, שכולל את מפתח התווית alloydbomni.internal.dbadmin.gdc.goog/task-type ואת היציאה metricsalloydbomni. המשאב המותאם אישית serviceMonitor עוקב אחרי כל שירותי Kubernetes בכל מרחבי השמות ואוסף נתונים לגביהם
למידע נוסף על ההגדרה המלאה של ServiceMonitor, קראו את הגדרת המשאב בהתאמה אישית של ServiceMonitor .
v1.0
spec:
selector:
matchLabels:
alloydbomni.internal.dbadmin.goog/task-type: monitoring
namespaceSelector:
any: true
endpoints:
- port: metricsalloydbomni
גרסה < 1.0
spec:
selector:
matchExpressions:
- key: alloydbomni.internal.dbadmin.gdc.goog/task-type
operator: Exists
values: []
namespaceSelector:
any: true
endpoints:
- port: metricsalloydbomni
הצגת מדדים באמצעות Grafana
כדי לראות ייצוג חזותי של המדדים ב-AlloyDB Omni ב-Kubernetes, אתם יכולים להשתמש בלוח הבקרה של המעקב. לוח הבקרה למעקב מסתמך על סטאק בסיסי של יכולת תצפית, שמורכב מ-Prometheus ומ-Grafana. כדי להגדיר את לוח הבקרה של המעקב לאיסוף מדדים מ-AlloyDB Omni:
כדי להוריד את מרכז הבקרה של Grafana, משתמשים בפקודה
wget:wget https://raw.githubusercontent.com/GoogleCloudPlatform/alloydb-omni-samples/refs/heads/main/monitoring-dashboards/grafana/alloydbomni_dashboard.yamlלפני שפורסים את Grafana ב-Kubernetes, צריך להוריד ולהתקין את grafana-operator. הוראות מפורטות זמינות במאמר התקנה.
מוסיפים את התווית
monitoring.dashboard/product=alloydb-omniלמכונה של Grafana שבה מתקינים את לוח הבקרה:kubectl label grafana/GRAFANA_INSTANCE_NAME monitoring.dashboard/product=alloydb-omni -n NAMESPACEמחליפים את מה שכתוב בשדות הבאים:
-
GRAFANA_INSTANCE_NAME: השם של מכונת Grafana שבה נמצא מרכז הבקרה. -
NAMESPACE: מרחב השמות שבו פרסתם את אופרטור Grafana.
-
כדי להחיל את הגדרת לוח הבקרה של Grafana על אשכול AlloyDB Omni ב-Kubernetes, משתמשים בפקודה הבאה:
kubectl apply -f alloydbomni_dashboard.yaml -n NAMESPACEבמסמכי התיעוד של Grafana Operator מוסבר איך משתמשים ב-Grafana Operator.
כדי להגדיר את Grafana להשתמש ב-Prometheus כמקור נתונים, ראו מקורות נתונים.
כדי לוודא ש-Grafana מוגדרת כמו שצריך, מבצעים אחת מהפעולות הבאות:
- צופים באוסף של לוחות Grafana במרכז הבקרה של AlloyDB Omni.
אחזור מידע על לוח הבקרה של Grafana באשכול Kubernetes:
kubectl get grafanadashboard alloydb-omni-dashboard -n NAMESPACE -o jsonpath='{.status.conditions[?(@.type=="DashboardSynchronized")].status}'אם הפקודה מחזירה את הערך
True, סימן שה-alloydb-omni-dashboardנפרס בהצלחה במכונה של Grafana.
שדרוג של AlloyDB Omni
כדי לשדרג מגרסה 15.5.2 או גרסה קודמת של AlloyDB Omni לגרסה 15.5.4, פועלים לפי ההוראות במאמר מעבר מגרסה קודמת של AlloyDB Omni לגרסה העדכנית.
כדי לשדרג מגרסה 15.5.4 ואילך:
מפעילים מחדש את AlloyDB Omni באמצעות גרסת אימג' חדשה.
חשוב לציין את ספריית הנתונים כך שתהיה זהה לנתיב שבו נעשה שימוש בגרסאות קודמות של AlloyDB Omni.
הסרת AlloyDB Omni
שרת יחיד
כדי להסיר את AlloyDB Omni, עוצרים ומוחקים את קונטיינר AlloyDB Omni באמצעות הפקודה הבאה:
Docker
docker container stop CONTAINER_NAME
docker container rm CONTAINER_NAMEמחליפים את CONTAINER_NAME בשם של קונטיינר AlloyDB Omni.
Podman
podman container stop CONTAINER_NAME
podman container rm CONTAINER_NAMEמחליפים את CONTAINER_NAME בשם של קונטיינר AlloyDB Omni.
Podman
podman container stop CONTAINER_NAME
podman container rm CONTAINER_NAMEמחליפים את CONTAINER_NAME בשם של קונטיינר AlloyDB Omni.
אפשר להעביר, לארכב או למחוק ספריית נתונים חיצונית, בהתאם לרצון ולצורך שלכם לשמור את הנתונים אחרי הסרת AlloyDB Omni.
Kubernetes
מחיקת אשכול מסד הנתונים
כדי למחוק את אשכול מסד הנתונים, מגדירים את isDeleted ל-true במניפסט שלו.
אפשר לעשות את זה באמצעות הפקודה הבאה.
kubectl patch dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -p '{"spec":{"isDeleted":true}}' --type=mergeמחליפים את DB_CLUSTER_NAME בשם של אשכול מסד הנתונים. זהו שם אשכול מסד הנתונים שהצהרתם עליו כשיצרתם אותו.
הסרת אופרטור AlloyDB Omni
כדי להסיר את אופרטור AlloyDB Omni Kubernetes מאשכול Kubernetes:
מוחקים את כל אשכולות מסדי הנתונים:
for ns in $(kubectl get dbclusters.alloydbomni.dbadmin.goog --all-namespaces -o=jsonpath='{range .items[*]}{.metadata.namespace}{"\n"}{end}'); do for cr in $(kubectl get dbclusters.alloydbomni.dbadmin.goog -n $ns -o=jsonpath='{range .items[*]}{.metadata.name}{"\n"}{end}'); do kubectl patch dbclusters.alloydbomni.dbadmin.goog $cr -n $ns --type=merge -p '{"spec":{"isDeleted":true}}' done doneמחכים עד שאופרטור AlloyDB Omni Kubernetes ימחק את כל אשכולות מסדי הנתונים. משתמשים בפקודה הבאה כדי לבדוק אם נשארו משאבי מסד נתונים:
kubectl get dbclusters.alloydbomni.dbadmin.goog --all-namespacesמחיקת משאבים אחרים שאופרטור AlloyDB Omni Kubernetes יצר:
kubectl delete failovers.alloydbomni.dbadmin.goog --all --all-namespaceskubectl delete restores.alloydbomni.dbadmin.goog --all --all-namespaceskubectl delete switchovers.alloydbomni.dbadmin.goog --all --all-namespacesמסירים את האופרטור של AlloyDB Omni Kubernetes:
helm uninstall alloydbomni-operator --namespace alloydb-omni-systemמחיקת סודות, תיאורים של משאבים מותאמים אישית ומרחבי שמות שקשורים לאופרטור AlloyDB Omni Kubernetes:
kubectl delete certificate -n alloydb-omni-system --allkubectl get secrets --all-namespaces -o custom-columns=NAMESPACE:.metadata.namespace,NAME:.metadata.name,ANNOTATION:.metadata.annotations.cert-manager\.io/issuer-name | grep -E 'alloydbomni|dbs-al' | awk '{print $1 " " $2}' | xargs -n 2 kubectl delete secret -nkubectl delete crd -l alloydb-omni=truekubectl delete ns alloydb-omni-system
שינוי הגודל של אשכול מסד הנתונים שמבוסס על Kubernetes
כדי לשנות את הגודל של ה-CPU, הזיכרון או האחסון של אשכול מסד נתונים מבוסס Kubernetes, צריך לעדכן את השדה resources במניפסטים שמגדירים את הפוד שלו. אופרטור AlloyDB Omni מחיל מיד את המפרטים החדשים על ה-Pod של מסד הנתונים.
מידע נוסף על תחביר המניפסט של אופרטור AlloyDB Omni זמין במאמר יצירת אשכול של מסדי נתונים.
ההגבלות הבאות חלות על שינוי המשאבים של אשכול מסד נתונים פעיל:
- אפשר להגדיל את נפח הדיסק רק אם הערך שצוין בשדה
storageClassתומך בהרחבת הנפח. - אי אפשר להקטין את גודל הדיסק.