במאמר הזה מוסבר איך לפרוס את Spanner Omni במכונות וירטואליות (VM). הפריסה הזו לא מוצפנת. אם אתם רוצים להגדיר במהירות סביבת בדיקה או הוכחת היתכנות כדי להעריך את Spanner Omni, יצירת פריסה לא מאובטחת היא הדרך המהירה ביותר להתחיל, כי היא לא דורשת הגדרה של mTLS או אמצעי אבטחה אחרים. עם זאת, בגלל סיכוני אבטחה כמו תנועה ברשת לא מוצפנת וגישה פתוחה, אנחנו לא ממליצים על ההגדרה הזו לסביבות ייצור. אתם יכולים לבחור בין פריסה בשרת יחיד לבין פריסה אזורית בכמה אזורים.
לפני שמתחילים
לפני שאתם מגדירים פריסה לא מאובטחת, חשוב לוודא שאתם עומדים בדרישות הבאות:
גישת SSH: גישת SSH לכל מכונה בפריסה כדי להוריד ולהריץ את הקובץ הבינארי של Spanner Omni.
קישוריות: כל המכונות בפריסה יכולות להתחבר זו לזו.
רשת: הגדרת הרשת מאפשרת תקשורת TCP ביציאות
15000עד15025.אחסון: לכל מכונה יש מספיק נפח אחסון כדי לארח את הנתונים שהפריסה מטפלת בהם.
דרישות המערכת: ודאו שההגדרות שלכם עומדות בכל דרישות המערכת.
הגדרת vSphere: אם אתם מריצים את Spanner Omni בפלטפורמת הווירטואליזציה vSphere, השביתו את הווירטואליזציה של מונה חותמות הזמן (TSC). מוסיפים את
monitor_control.virtual_rdtsc = FALSEלקובץ התצורה.vmxשל המכונה הווירטואלית.
שלב 1: בחירת טופולוגיית הפריסה
Spanner Omni משתמש בהיררכיה של מיקומים, אזורים ושרתים כדי להגדיר את טופולוגיית הפריסה שלו. אפשר לבחור מבין הטופולוגיות הבאות, בהתאם ליעדי הזמינות:
שרת יחיד: הפריסה כוללת שרת יחיד שפועל במכונה אחת.
אזור יחיד: הפריסה פועלת בכמה שרתים שפרוסים באזור אחד.
מיקום אחד, כמה אזורים (פריסה משוכפלת): הפריסה פועלת בכמה שרתים שפזורים בכמה אזורים במיקום אחד.
מספר מיקומים, מספר אזורים: הפריסה פועלת בכמה שרתים שפזורים בכמה מיקומים ובכמה אזורים.
מידע נוסף זמין במאמרים מונחי מפתח ב-Spanner Omni והגדרות פריסה של Spanner Omni.
לכל פריסה שהיא לא שרת יחיד, יוצרים קובץ תצורה ב-YAML בשם deployment.yaml שמגדיר את הטופולוגיה. צריך לציין בקובץ הזה רק את שרתי הבסיס. אפשר להוסיף שרתים שהם לא שרתי בסיס בשלב מאוחר יותר.
דוגמה: פריסה משוכפלת בכמה אזורים
בדוגמה הבאה מוצגת הגדרה לפריסה אזורית בשלושה אזורים.
name: regional-deployment
location:
- name: us-central1
zone:
- name: us-central1-a
location: us-central1
single_server: false
root_server:
- host: rootserver1
- name: us-central1-b
location: us-central1
single_server: false
root_server:
- host: rootserver2
- name: us-central1-c
location: us-central1
single_server: false
root_server:
- host: rootserver3
דוגמה: פריסה בכמה מיקומים
בדוגמה הבאה מוצגת הגדרה לפריסה בשלושה מיקומים.
name: multi-location-deployment
location:
- name: us-central1
- name: europe-west2
- name: asia-southeast1
zone:
- name: us-central1-a
location: us-central1
single_server: false
root_server:
- host: rootserver1
- name: europe-west2-a
location: europe-west2
single_server: false
root_server:
- host: rootserver2
- name: asia-southeast1-a
location: asia-southeast1
single_server: false
root_server:
- host: rootserver3
שלב 2: מורידים ומגדירים את הקובץ הבינארי
חוזרים על השלבים האלה בכל מכונה בפריסה:
יוצרים ספרייה לקובץ הבינארי ועוברים אליה.
מורידים את הקובץ הבינארי:
gsutil cp gs://spanner-omni/VERSION/spanner-omni-VERSION-linux-x86_64.tar.gz .אפשר גם להשתמש ב-
scpאו בכלים אחרים להעברת קבצים כדי להעתיק את הקובץ הבינארי למכונות הווירטואליות.מחלצים את הקובץ הבינארי:
tar -xvf spanner-omni-VERSION-linux-x86_64.tar.gz
שלב 3: מפעילים את השרתים
יוצרים ספריית בסיס בכל שרת כדי לאחסן נתונים, מטא-נתונים ויומנים. אם צריך להפעיל מחדש את השרת, מציינים את אותה ספרייה כדי לשמור על המשכיות.
אפשרות א': פריסה בשרת יחיד
בפריסה של שרת יחיד, מריצים את הפקודה הבאה:
spanner start-single-server --base-dir=SPANNER_BASE_DIR
אחרי שהשרת מופעל, ממשיכים לשלב 6: אינטראקציה עם הפריסה.
אפשרות ב': פריסה עם הרחבה אופקית (scale out)
בפריסות של הרחבה אופקית בהתאם לעומס (scale out), צריך להפעיל את השרת בכל מכונה. הדגלים --server-address ו---zone תואמים לערכים בהגדרות האישיות של הפריסה. הרשת פותרת את הבעיה של server_address.
spanner start --root --server-address=RESOLVABLE_HOSTNAME --zone=ZONE_NAME --base-dir=SPANNER_BASE_DIR
לדוגמה:
spanner start --root --server-address=rootserver1 --zone=us-central-1a --base-dir=./spanbasedir
שלב 4: יצירת הפריסה
כדי ליצור את הפריסה:
מעתיקים את הקובץ
deployment.yamlשיצרתם בשלב 1: בחירת טופולוגיית הפריסה לאחד משרתי הבסיס.בשרת הבסיס הזה, מריצים את הפקודה הבאה כדי ליצור את הפריסה:
spanner deployment create --config-file=deployment.yamlבמסוף של כל מכונה מוצגות הודעות שמציינות שהפריסה מוכנה.
כדי לאמת את הפריסה, מציגים את האזורים:
spanner deployment zones listהפלט מציג את המיקומים, האזורים והשרתים שציינתם ב-
deployment.yaml.
שלב 5: (אופציונלי) הגדרת מאזן עומסים
מגדירים מאזן עומסים ב-TCP עם הפרטים הבאים:
| הגדרה | ערך |
|---|---|
| פרוטוקול | TCP |
| כתובת IP של הקצה העורפי | כתובות ה-IP של השרתים שלכם |
| יציאה | 15000 (או היציאה שבה משתמשים בדגל --server-address) |
| כתובת URL לבדיקת תקינות | http://SERVER_IP:15012/healthz |
| שיטת האיזון | סדר אקראי |
בפריסות בכמה מיקומים, אפשר להגדיר מאזן עומסים אחד לכל מיקום ומאזן עומסים ראשי שיחלק את התנועה בין כל המיקומים.
שלב 6: אינטראקציה עם הפריסה
אחרי שהפריסה מוכנה, אפשר להשתמש בה באמצעות ה-CLI מכל VM או מכונה מקומית. אם אתם מריצים את ה-CLI ממכונה נפרדת, כמו מחשב נייד של מפתח, הורידו וחלצו את חבילת ה-CLI. מידע נוסף זמין במאמר מדריך למתחילים: שימוש ב-CLI של Spanner Omni.
כדי לבצע פעולות בפריסה, פועלים לפי השלבים הבאים:
יוצרים מסד נתונים:
spanner --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP databases create DATABASE_NAMEפותחים את מעטפת ה-SQL:
spanner sql --database=DATABASE_NAMEיוצרים טבלה ומזינים נתונים:
CREATE TABLE names ( nameId INT64 NOT NULL, name STRING(100) ) PRIMARY KEY (nameId); INSERT INTO names (nameId, name) VALUES (1, "Jack");מאמתים את מסד הנתונים ואת הנתונים:
כדי להציג רשימה של מסדי נתונים:
bash spanner databases listהפלט אמור להיראות כך:
שם STATE VERSION_RETENTION_PERIOD EARLIEST_VERSION_TIME ENABLE_DROP_PROTECTION DATABASE_NAME מוכן שעה 2025-02-07T12:25:30Z FALSE כדי לשלוח שאילתה לטבלה:
bash spanner sql --database=DATABASE_NAMEמריצים את פקודות ה-SQL הבאות:
SHOW TABLES; SELECT * FROM names;
שלב 7: (אופציונלי) התאמת קנה המידה של הפריסה
כדי להגדיל את הקיבולת באזור, אפשר להוסיף שרתים שאינם שרתי שורש. מריצים את הפקודה הבאה בכל שרת חדש:
spanner start --server-address=NON_ROOT_HOSTNAME --join-servers=SERVER1:PORT1,SERVER2:PORT2,SERVER3:PORT3 --zone=ZONE_NAME --base-dir=SPANNER_BASE_DIR
שלב 8: (אופציונלי) מעקב אחרי הפריסה
כדי לעקוב אחרי התקינות והביצועים של הפריסה, אתם יכולים להגדיר איסוף מדדים, תצוגה חזותית והתראות. אתם יכולים גם לאסוף נתוני מעקב מבוזרים כדי לנתח את זמן האחזור של הבקשות.
הגדרת Prometheus
שרתי Spanner Omni מייצאים מדדים בפורמט Prometheus ביציאה 15012. מוסיפים את הקוד הבא לקובץ scrape_configs ב-prometheus.yml:
scrape_configs:
- job_name: 'spanner'
static_configs:
- targets: ['HOST1:15012', 'HOST2:15012', 'HOSTN:15012']
הגדרת Grafana
כדי לראות את נתוני המעקב ב-Grafana:
מגדירים את מקור הנתונים של Prometheus על ידי יצירת קובץ ב-
provisioning/datasources:apiVersion: 1 datasources: - name: Prometheus uid: prometheus type: prometheus access: proxy url: http://PROMETHEUS_HOST:PROMETHEUS_PORT jsonData: httpMethod: POST manageAlerts: false prometheusType: Prometheus prometheusVersion: PROMETHEUS_VERSION cacheLevel: 'High' disableRecordingRules: false incrementalQueryOverlapWindow: 10mיוצרים לוח בקרה בממשק המשתמש של Grafana או מקצים אותו באמצעות
provisioning/dashboards.
הגדרת התראות
אפשר להגדיר התראות באמצעות ממשק המשתמש של Grafana או קובצי תצורה. לדוגמה, אפשר להפעיל התראה אם האחוזון ה-95 (p95) של זמן האחזור של העסקה חורג מ-100 אלפיות השנייה. לרשימת ההתראות הזמינות, ראו שימוש בהתראות Prometheus למעקב אחר Spanner Omni.
איסוף וניתוח של נתוני מעקב
לאסוף מידע על מעקב מבוזר בפורמט OTLP ולהציג אותו באמצעות כלים כמו Jaeger.
מגדירים אוסף מעקבים שתואם ל-OTLP. ל-Jaeger:
export COLLECTOR_OTLP_ENABLED=true jaeger-all-in-oneמוודאים שיציאת ה-OTLP מאפשרת תנועה ברשת בין Spanner Omni לבין ה-collector.
מגדירים את משתנה הסביבה
SPANNER_TRACE_EXPORTER_ENDPOINTומפעילים את שרתי Spanner Omni:export SPANNER_TRACE_EXPORTER_ENDPOINT=COLLECTOR_HOST:COLLECTOR_PORT spanner start --root --server-address=RESOLVABLE_HOSTNAME --zone=ZONE_NAME --base-dir=SPANNER_BASE_DIR