העברה בתוך האשכול אל Istio באשכול חדש

במדריך הזה נסביר איך להעביר אפליקציה מאשכול Google Kubernetes Engine ‏ (GKE) קיים באמצעות Cloud Service Mesh בתוך האשכול לאשכול GKE חדש באמצעות Istio בקוד פתוח. תשתמשו ביכולות של רשת משולבת מקצה לקצה ומרובת אשכולות כדי לבצע העברה חלקה.

הערה לגבי מינוח: במדריך הזה, המונח Cloud Service Mesh מתייחס ל-Cloud Service Mesh בתוך האשכול של Google, והמונח Istio מתייחס ל-Istio service mesh בקוד פתוח.

במדריך הזה תלמדו:

  1. הכנת האשכול הקיים למיגרציה באמצעות Cloud Service Mesh בתוך האשכול.
  2. הקצאת אשכול GKE חדש עם Istio.
  3. להגדיר את GKE multi-cluster Gateway API באשכול ייעודי ובשירותים מרובי אשכולות כדי להגדיר ניתוב לכניסה לרשת.
  4. מבצעים פריסה של גרסה ראשונית (canary) כדי לפצל את תעבורת ה-HTTP בשידור חי בין Cloud Service Mesh לבין Istio.
  5. משלימים את המעבר הסופי ל-Istio ומוציאים משימוש משאבים של Cloud Service Mesh בתוך האשכול.

פריסה של גרסה ראשונית (canary)

'פריסה של גרסה ראשונית (canary)' היא טכניקה שמשמשת בהנדסת תוכנה לבדיקת גרסה חדשה של תוכנה או תשתית לפני שמשחררים אותה לכל משתמשי הייצור. התהליך כולל הגדלה הדרגתית של אחוז התנועה שנשלחת לגרסת היעד החדשה.

במדריך הזה תגדירו אשכול חדש עם Istio ותעבירו אליו בהדרגה את תנועת המשתמשים. תתחילו בהפניית 0% מתנועת המשתמשים לאשכול החדש, אחר כך 50% ולבסוף 100% לאשכול GKE עם Istio. בסביבות ייצור, אפשר להשתמש במרווחים קטנים יותר ומפורטים יותר (לדוגמה, 1%, ‏ 5%, ‏ 10%, ‏ 25%, ‏ 50%, ‏ 100%). אם בשלב כלשהו תבחינו בשגיאות או בירידה בביצועים של האשכול החדש, תוכלו לבצע החזרה מיידית לגרסה הקודמת על ידי החזרת אחוז התנועה ל-0% באשכול Istio.

מישור בקרה של Canary לעומת אשכול Canary

יש שתי אסטרטגיות עיקריות להעברה בין מישורי בקרה של Service mesh:

  • העברה של אשכול Canary (מומלץ): בשיטה הזו יוצרים אשכול חדש באותו Google Cloud פרויקט ובאותה קבוצת אשכולות כמו האשכול הקיים, מתקינים בו את מישור הבקרה של יעד ה-Service mesh‏ (Istio) ומעבירים אליו את עומסי העבודה ואת תנועת הכניסה.
  • העברת מישור בקרה של Canary (לא נתמכת): באסטרטגיה הזו, מתקינים את מישור הבקרה החדש לצד מישור הבקרה הראשוני באותו אשכול. מצב העברה זה לא אפשרי.

במדריך הזה נסביר איך להשתמש באסטרטגיית העברה של אשכול קנרי. שני האשכולות צריכים להיות באותו פרויקט Google Cloud

עלויות

במדריך הזה נעשה שימוש ברכיבים של Google Cloudשחלים עליהם חיובים, כולל:

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

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

  1. בדף לבחירת הפרויקט במסוף Google Cloud , בוחרים את Google Cloud הפרויקט שבו מותקן Cloud Service Mesh בתוך האשכול.

    כניסה לדף לבחירת הפרויקט

  2. נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the required APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  5. Verify that billing is enabled for your Google Cloud project.

  6. Enable the required APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

הכנת האשכול להעברה באמצעות Cloud Service Mesh בתוך האשכול

בקטע הזה נסביר איך להכין את אשכול GKE הקיים שבו פועל Cloud Service Mesh בתוך האשכול להעברה לאשכול GKE עם Istio.

מוודאים שאשכול Cloud Service Mesh בתוך האשכול פועל ומוכן להעברה

  1. מוודאים שאשכול Cloud Service Mesh בתוך האשכול GKE_CSM_CLUSTER פועל עם מישור הבקרה istiod בתוך האשכול, בהתאם למדריך להתקנת Cloud Service Mesh בתוך האשכול.

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

    kubectl get deployment -A -l app=istiod -L istio.io/rev
    

    הפלט הצפוי אמור להיראות כך:

    NAMESPACE              NAME                 READY   UP-TO-DATE   AVAILABLE   AGE     REV
    ISTIOD_NAMESPACE      istiod-asm-1295-12   2/2     2            2           4d16h   asm-1295-12
    
  2. כדי לוודא שאין שגיאות במישור הבקרה istiod, משתמשים בפקודה הבאה:

    kubectl logs -n ISTIOD_NAMESPACE -l app=istiod
    

הכנת האשכול להעברה

  1. מוודאים שWorkload Identity מופעל באשכול ובמאגר הצמתים.

    כדי לוודא ש-Workload Identity מופעל באשכול, מריצים את הפקודה הבאה:

    gcloud container clusters describe "GKE_CSM_CLUSTER" \
        --location="LOCATION" \
        --project="PROJECT_ID" \
        --format="value(workloadIdentityConfig.workloadPool)"
    

    מחליפים את GKE_CSM_CLUSTER בשם האשכול הקיים, את LOCATION במיקום האשכול ואת PROJECT_ID במזהה הפרויקט.

    הפלט אמור להיראות כך:

    PROJECT_ID.svc.id.goog
    

    אם Workload Identity חסר, אפשר לעיין במדריך בנושא Workload Identity כדי לעדכן את האשכול.

  2. מוודאים שהאשכול רשום ב-Fleet:

    gcloud container clusters describe "GKE_CSM_CLUSTER" \
        --location="LOCATION" \
        --project="PROJECT_ID" \
        --format="yaml(fleet)"
    

    הפלט הצפוי עבור אשכול רשום:

    fleet:
      membership: //gkehub.googleapis.com/projects/PROJECT_NUMBER/locations/LOCATION/memberships/MEMBERSHIP_NAME
    

    אם פרטי ה-Fleet ריקים, אפשר לעיין במדריך לרישום חברות ב-Fleet כדי לרשום את האשכול ב-Fleet.

  3. כדי לחשוף את האפליקציה באמצעות שער Ingress, פועלים לפי ההוראות במדריך בנושא התקנה ושדרוג של שער.

התקנת Istio באשכול GKE חדש

בקטע הזה נסביר איך להקצות אשכול GKE חדש שמופעל בו Istio בקוד פתוח, כדי להשתמש באסטרטגיית העברה של אשכול קנרי.

  1. יוצרים אשכול GKE חדשGKE_ISTIO_CLUSTER באותו Google Cloud פרויקט (PROJECT_ID) שבו נמצא אשכול Cloud Service Mesh הקיים.

    כשיוצרים את האשכול, צריך לוודא שמציינים את --project ומפעילים את Workload Identity באמצעות --workload-pool=PROJECT_ID.svc.id.goog:

    gcloud container clusters create GKE_ISTIO_CLUSTER \
        --project=PROJECT_ID \
        --location=LOCATION \
        --workload-pool=PROJECT_ID.svc.id.goog
    

    אם כבר יצרתם אשכול, תוכלו להשתמש במדריך בנושא Workload Identity כדי להפעיל את התכונה.

  2. רושמים את אשכול Istio בצי:

    gcloud container fleet memberships register \
        GKE_ISTIO_CLUSTER \
        --gke-cluster=LOCATION/GKE_ISTIO_CLUSTER \
        --enable-workload-identity \
        --location=LOCATION \
        --project=PROJECT_ID
    
  3. מתקינים את Istio לפי מדריך ההתקנה הרשמי של Istio, עם שערי כניסה (ingress) שמוצבים לתעבורת כניסה. כדי שההעברה תתבצע בצורה חלקה יותר, מומלץ להתקין את אותה גרסה של Istio בקוד פתוח. אם מחליטים לשדרג את Istio בקוד פתוח, כדאי לעיין בהערות לגבי הגרסה של Istio כדי לראות אם יש שינויים בהתנהגות.

    כדי להגדיר את האשכול הזה, מתקינים את האפליקציות באותה דרך כמו באשכול GKE, באמצעות Cloud Service Mesh בתוך האשכול. במדריך הזה, שערים של כניסת נתונים לאירוח במרחב שמות נקראים ISTIO_INGRESS_NAMESPACE.

  4. מוודאים שהאשכול תקין ומוכן לטפל בתנועה. צוותי האפליקציות אחראים לוודא שכל המיקרו-שירותים פועלים בצורה תקינה ועוברים את בדיקות התקינות לפני ניתוב תנועת משתמשים בזמן אמת.

הגדרת API של שער מרובה אשכולות באשכול ייעודי

בקטע הזה נגדיר מאזן עומסים חיצוני של אפליקציות (L7XLB) דרך בקר GKE Gateway כדי לאפשר תנועת נכנסת לרשת. במהלך ההעברה, מומלץ לפרוס משאבי Gateway API באשכול תצורת GKE ייעודי כדי לנהל את מאזן העומסים. במדריך הזה, אשכול ההגדרות הייעודי הזה נקרא GKE_CONFIG_CLUSTER.

הכנת אשכול ההגדרות

כדי להכין את אשכול ההגדרות לאירוח של ממשקי API‏ Gateway ו-HTTPRoute, פועלים לפי המדריך בנושא שערים מרובי אשכולות.

ייצוא שירותים באמצעות שירותים מרובי אשכולות

מייצאים את השירות istio-ingressgateway בשני אשכולות ה-mesh באמצעות ServiceExport כמו שמוסבר במדריך בנושא שירותים מרובי אשכולות (MCS):

apiVersion: net.gke.io/v1
kind: ServiceExport
metadata:
  namespace: NAMESPACE
  name: SERVICE_EXPORT_NAME

הקצאת משאבי Gateway API באשכול ההגדרות

  1. פועלים לפי ההוראות שבמדריך Gateway Edge-to-Mesh כדי ליצור את המשאבים Gateway ו-HTTPRoute באשכול ההגדרות הייעודי. דוגמה להגדרה:

    apiVersion: gateway.networking.k8s.io/v1
    kind: Gateway
    metadata:
      name: global-gateway
      namespace: CSM_INGRESS_NAMESPACE
    spec:
      gatewayClassName: gke-l7-global-external-managed-mc
      listeners:
      - name: http
        protocol: HTTP
        port: 80
        allowedRoutes:
          namespaces:
            from: Same
    ---
    apiVersion: gateway.networking.k8s.io/v1
    kind: HTTPRoute
    metadata:
      name: edge-to-mesh-route
      namespace: CSM_INGRESS_NAMESPACE
    spec:
      parentRefs:
      - name: global-gateway
      rules:
      - backendRefs:
        # Backend 1: Cloud Service Mesh Cluster (CSM_INGRESS_NAMESPACE namespace)
        - group: net.gke.io
          kind: ServiceImport
          name: istio-ingressgateway
          namespace: CSM_INGRESS_NAMESPACE
          port: 80
          weight: 100
    
  2. אם המשאבים של ServiceImport נמצאים במרחב שמות שונה מזה של HTTPRoute, צריך להשתמש ב-ReferenceGrant כדי להפעיל ניתוב תנועה בין מרחבי שמות:

    apiVersion: gateway.networking.k8s.io/v1beta1
    kind: ReferenceGrant
    metadata:
      name: allow-csm-ingress-to-ISTIO_INGRESS_NAMESPACE
      namespace: ISTIO_INGRESS_NAMESPACE
    spec:
      from:
      - group: gateway.networking.k8s.io
        kind: HTTPRoute
        namespace: CSM_INGRESS_NAMESPACE
      to:
      - group: net.gke.io
        kind: ServiceImport
    

העברת תנועה באמצעות פריסה של גרסה ראשונית (canary)

בקטע הזה, תעבירו את התנועה לאשכול החדש ותשלימו את המיגרציה.

העברת 50% מהתנועה אל Istio

בקטע הזה תבצעו פריסה של גרסה ראשונית (canary) כדי להעביר את התנועה בהדרגה. מידע נוסף מופיע במדריך בנושא חלוקת תנועה.

  1. מחילים את המשאב המותאם אישית HTTPRoute באשכול התצורה כדי לפצל את התנועה של קנרי לאשכול Istio:

    apiVersion: gateway.networking.k8s.io/v1
    kind: HTTPRoute
    metadata:
      name: edge-to-mesh-route
      namespace: CSM_INGRESS_NAMESPACE
    spec:
      parentRefs:
      - name: global-gateway
      rules:
      - backendRefs:
        # Backend 1: CSM Cluster (CSM_INGRESS_NAMESPACE namespace)
        - group: net.gke.io
          kind: ServiceImport
          name: istio-ingressgateway
          namespace: CSM_INGRESS_NAMESPACE
          port: 80
          weight: 50
        # Backend 2: Istio Cluster (ISTIO_INGRESS_NAMESPACE namespace)
        - group: net.gke.io
          kind: ServiceImport
          name: istio-ingressgateway
          namespace: ISTIO_INGRESS_NAMESPACE
          port: 80
          weight: 50
    
  2. כדי לאמת את חלוקת התנועה בזמן אמת, מריצים בקשות מקבילות מול כתובת ה-IP הציבורית של שער הכניסה.

    הפלט הצפוי: התשובות מאוזנות בין GKE_CSM_CLUSTER לבין GKE_ISTIO_CLUSTER.

    בסביבת הייצור, כמו שצוין קודם, כדאי להעביר את התנועה במנות קטנות יותר (לדוגמה, 1%, 5%, 10%, 25%, 50%, 100%). יכול לקחת זמן עד שהמשקלים האלה יתעדכנו במאזן העומסים, לכן חשוב לוודא שהתנועה מפולגת בצורה נכונה לפני שמגדילים את המשקלים עוד יותר.

השלמת ההעברה לאשכול Istio

מוודאים שהאפליקציה באשכול Istio פועלת בצורה תקינה בתנועת קנרי, וכל התנועה עברה אליה. אחרי שמוודאים שהניתוב של התנועה פועל בצורה תקינה, משלימים את ההעברה על ידי מחיקת המשאב ServiceExport באשכול Cloud Service Mesh בתוך האשכול:

kubectl --context="GKE_CSM_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n CSM_INGRESS_NAMESPACE

בקר GKE Gateway מנתק באופן אוטומטי את קבוצת נקודות הקצה ברשת (NEG) של אשכול Cloud Service Mesh משירות ה-Backend של מאזן העומסים Google Cloud . כל התנועה הנכנסת של הלקוחות עוברת בצורה חלקה לאשכול Istio ללא השבתה.

הסרת המשאבים

כדי להימנע מחיובים בחשבון Google Cloud על המשאבים שבהם השתמשתם במדריך הזה, צריך למחוק את הרכיבים שפרסתם.

  1. מחיקת משאבי ServiceExport באשכול Istio:

    kubectl --context="GKE_ISTIO_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n ISTIO_INGRESS_NAMESPACE
    
  2. ביטול הרישום של חברות במועדון:

    gcloud container fleet memberships unregister \
        GKE_CSM_CLUSTER \
        --gke-cluster="LOCATION/GKE_CSM_CLUSTER" \
        --project="PROJECT_ID"
    
  3. מוחקים את אשכול Cloud Service Mesh בתוך האשכול:

    gcloud container clusters delete GKE_CSM_CLUSTER \
        --location="LOCATION" \
        --project="PROJECT_ID"
    

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