יצירת פריסה במכונות וירטואליות

במאמר הזה מוסבר איך לפרוס את 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: מורידים ומגדירים את הקובץ הבינארי

חוזרים על השלבים האלה בכל מכונה בפריסה:

  1. יוצרים ספרייה לקובץ הבינארי ועוברים אליה.

  2. מורידים את הקובץ הבינארי:

    gsutil cp gs://spanner-omni/VERSION/spanner-omni-VERSION-linux-x86_64.tar.gz .
    

    אפשר גם להשתמש ב-scp או בכלים אחרים להעברת קבצים כדי להעתיק את הקובץ הבינארי למכונות הווירטואליות.

  3. מחלצים את הקובץ הבינארי:

    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: יצירת הפריסה

כדי ליצור את הפריסה:

  1. מעתיקים את הקובץ deployment.yaml שיצרתם בשלב 1: בחירת טופולוגיית הפריסה לאחד משרתי הבסיס.

  2. בשרת הבסיס הזה, מריצים את הפקודה הבאה כדי ליצור את הפריסה:

    spanner deployment create --config-file=deployment.yaml
    

    במסוף של כל מכונה מוצגות הודעות שמציינות שהפריסה מוכנה.

  3. כדי לאמת את הפריסה, מציגים את האזורים:

    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.

כדי לבצע פעולות בפריסה, פועלים לפי השלבים הבאים:

  1. יוצרים מסד נתונים:

    spanner --deployment-endpoint=LOAD_BALANCER_IP_OR_SERVER_IP databases create DATABASE_NAME
    
  2. פותחים את מעטפת ה-SQL:

    spanner sql --database=DATABASE_NAME
    
  3. יוצרים טבלה ומזינים נתונים:

    CREATE TABLE names (
      nameId INT64 NOT NULL,
      name STRING(100)
    ) PRIMARY KEY (nameId);
    
    INSERT INTO names (nameId, name) VALUES (1, "Jack");
    
  4. מאמתים את מסד הנתונים ואת הנתונים:

    כדי להציג רשימה של מסדי נתונים: 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

  5. מריצים את פקודות ה-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:

  1. מגדירים את מקור הנתונים של 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
    
  2. יוצרים לוח בקרה בממשק המשתמש של Grafana או מקצים אותו באמצעות provisioning/dashboards.

הגדרת התראות

אפשר להגדיר התראות באמצעות ממשק המשתמש של Grafana או קובצי תצורה. לדוגמה, אפשר להפעיל התראה אם האחוזון ה-95 (p95) של זמן האחזור של העסקה חורג מ-100 אלפיות השנייה. לרשימת ההתראות הזמינות, ראו שימוש בהתראות Prometheus למעקב אחר Spanner Omni.

איסוף וניתוח של נתוני מעקב

לאסוף מידע על מעקב מבוזר בפורמט OTLP ולהציג אותו באמצעות כלים כמו Jaeger.

  1. מגדירים אוסף מעקבים שתואם ל-OTLP. ל-Jaeger:

    export COLLECTOR_OTLP_ENABLED=true
    jaeger-all-in-one
    

    מוודאים שיציאת ה-OTLP מאפשרת תנועה ברשת בין Spanner Omni לבין ה-collector.

  2. מגדירים את משתנה הסביבה 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
    

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