מעבר מ-Istio ב-GKE אל Cloud Service Mesh

במדריך הזה נסביר איך לשדרג אשכול Google Kubernetes Engine ‏ (GKE) עם Istio ב-Google Kubernetes Engine ‏ (Istio ב-GKE) בגרסה 1.4 או 1.6 (בטא) ל-Cloud Service Mesh מנוהל עם מישור הבקרה שמנוהל על ידי Google ורשות אישורים של Cloud Service Mesh.

דרישות מוקדמות

כדי להשלים את המדריך הזה, אתם צריכים לעמוד בדרישות המוקדמות הבאות:

  • אשכול GKE עם Istio ב-GKE מופעל. אם יש לכם כמה אשכולות GKE, צריך לבצע את אותם השלבים לכל האשכולות.

  • ‫Istio ב-GKE צריך להיות בגרסה 1.4 או 1.6.

  • מוודאים שאתם משתמשים ב-GKE בגרסה ‎1.17.17-gke.3100+,‎ ‎1.18.16-gke.1600+,‎ ‎1.19.8-gke.1600+‎ או בגרסה חדשה יותר.

  • אשכול GKE צריך לפעול באחד מהמיקומים האלה.

  • למשתמש או לחשבון השירות שמריצים את הסקריפט הזה נדרשות הרשאות IAM שמתועדות במאמר הגדרת הפרויקט.

  • המדריך הזה נבדק ב-Cloud Shell, ולכן מומלץ להשתמש ב-Cloud Shell כדי לבצע את השלבים שמופיעים בו.

מטרות

  • פריסת מישור בקרה בניהול Google של Cloud Service Mesh בערוץ הרגיל. המדריך הזה מתייחס לערוץ הרגיל. כדי להשתמש בערוצים יציבים או בערוצים מהירים, צריך לבצע שינויים קלים בהוראות. מידע נוסף על ערוצי הפצה זמין בקישור הזה.
  • העברת הגדרות Istio ל-Cloud Service Mesh.
  • הגדרת רשות אישורים (CA) של Cloud Service Mesh.
  • העברת אפליקציות ל-Cloud Service Mesh.
  • שדרוג istio-ingressgateway מ-Istio ב-GKE ל-Cloud Service Mesh.
  • משלימים את ההעברה של Cloud Service Mesh או מבצעים חזרה ל-Istio ב-GKE.

מגדירים את הסביבה

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

  1. במסוף Google Cloud , מפעילים את Cloud Shell.

    הפעלת Cloud Shell

    בחלק התחתון של דף המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Google Cloud ‫Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud ו-Google Cloud CLI כבר מותקנים, ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

  2. יוצרים את משתני הסביבה שמשמשים במדריך הזה:

    # Enter your project ID
    export PROJECT_ID=PROJECT_ID
    
    # Copy and paste the following
    gcloud config set project ${PROJECT_ID}
    export PROJECT_NUM=$(gcloud projects describe ${PROJECT_ID} --format='value(projectNumber)')
    export CLUSTER_1=GKE_CLUSTER_NAME
    export CLUSTER_1_LOCATION=GKE_CLUSTER_REGION_OR_ZONE
    export SHELL_IP=$(curl ifconfig.me) # This is required for private clusters with `master-authorized-networks` enabled.
    
  3. יוצרים תיקייה ב-WORKDIR. כל הקבצים שקשורים למדריך הזה יועברו אל WORKDIR, כך שתוכלו למחוק את WORKDIR בסיום.

    mkdir -p addon-to-asm && cd addon-to-asm && export WORKDIR=`pwd`
    
  4. יצירת קובץ KUBECONFIG למדריך הזה. אפשר גם להשתמש בקובץ KUBECONFIG הקיים שמכיל את הקשר של האשכול כדי להעביר את אשכול GKE אל Cloud Service Mesh.

    touch asm-kubeconfig && export KUBECONFIG=`pwd`/asm-kubeconfig
    
  5. מקבלים פרטי כניסה לאשכול GKE ומאחסנים את ההקשר במשתנה:

    אשכולות אזוריים

    gcloud container clusters get-credentials ${CLUSTER_1} \
      --zone=${CLUSTER_1_LOCATION}
    
    export CLUSTER_1_CTX=gke_${PROJECT_ID}_${CLUSTER_1_LOCATION}_${CLUSTER_1}
    

    אשכולות אזוריים

    gcloud container clusters get-credentials ${CLUSTER_1} \
      --region=${CLUSTER_1_LOCATION}
    
    export CLUSTER_1_CTX=gke_${PROJECT_ID}_${CLUSTER_1_LOCATION}_${CLUSTER_1}
    
  6. האשכולות צריכים להיות רשומים ב-Fleet. אפשר לבצע את השלב הזה בנפרד לפני ההתקנה, או כחלק מההתקנה על ידי העברת הדגל ‎--fleet-id ואחד מהדגלים ‎--enable-all או ‎--enable-registration.

  7. צריך להפעיל בפרויקט את התכונה Service Mesh. אפשר להפעיל אותו כחלק מההתקנה באמצעות העברת אחד מהדגלים ‎--enable-all או ‎--enable-registration, או באמצעות הפעלת הפקודה הבאה לפני ההתקנה:

      gcloud container hub mesh enable --project=FLEET_PROJECT_ID
    

    כאשר FLEET_PROJECT_ID הוא מזהה הפרויקט של פרויקט המארח של ה-Fleet.

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

אם האשכול הוא אשכול פרטי (עם master-authorized-networks מופעל), מוסיפים את $SHELL_IP לרשימת ההיתרים של master-authorized-networks. אם כבר יש לכם גישה לאשכול, יכול להיות שלא תצטרכו לבצע את השלב הזה.

אשכולות אזוריים

export SHELL_IP=$(curl ifconfig.me)

gcloud container clusters update ${CLUSTER_1} \
    --zone=${CLUSTER_1_LOCATION} \
    --enable-master-authorized-networks \
    --master-authorized-networks ${SHELL_IP}/32

אשכולות אזוריים

export SHELL_IP=$(curl ifconfig.me)

gcloud container clusters update ${CLUSTER_1} \
    --region=${CLUSTER_1_LOCATION} \
    --enable-master-authorized-networks \
    --master-authorized-networks ${SHELL_IP}/32

התקנה של Cloud Service Mesh

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

  1. מורידים את הגרסה האחרונה של הסקריפט שמתקין את Cloud Service Mesh לספריית העבודה הנוכחית, והופכים את הסקריפט לניתן להרצה:

    curl https://storage.googleapis.com/csm-artifacts/asm/asmcli > asmcli
    chmod +x asmcli
    
  2. כדי להגדיר את אשכול GKE, מריצים את סקריפט ההתקנה כדי להתקין את Cloud Service Mesh עם מישור הבקרה שמנוהל על ידי Google של הערוץ הרגיל:

    ./asmcli install \
    -p ${PROJECT_ID} \
    -l ${CLUSTER_1_LOCATION} \
    -n ${CLUSTER_1} \
    --fleet_id ${FLEET_PROJECT_ID} \
    --managed \
    --verbose \
    --output_dir ${CLUSTER_1} \
    --enable-all \
    --channel regular
    

    השלמת השלב הזה יכולה להימשך כמה דקות.

  3. אימות מישור הבקרה שמנוהל על ידי Google

  4. מעתיקים את istioctl לתיקייה WORKDIR:

    cp ./${CLUSTER_1}/istioctl ${WORKDIR}/.
    

בקטע הבא מורידים ומריצים את הסקריפט migrate_addon כדי להיעזר בהעברה אל Cloud Service Mesh. כלי שורת הפקודה istioctl צריך להיות באותה תיקייה כמו הסקריפט migrate_addon. אתם משתמשים בתיקייה WORKDIR גם עבור כלי שורת הפקודה istioctl וגם עבור הסקריפט migrate_addon.

העברת הגדרות ל-Cloud Service Mesh

בקטע הזה מוסבר איך להעביר הגדרות של Istio ב-GKE אל Cloud Service Mesh. הסקריפט המודרך מזהה אילו הגדרות אפשר להעביר ואילו לא.

  1. מורידים את כלי ההעברה והופכים אותו לקובץ הפעלה:

    curl https://raw.githubusercontent.com/GoogleCloudPlatform/anthos-service-mesh-packages/main/scripts/migration/migrate-addon > ${WORKDIR}/migrate_addon
    chmod +x ${WORKDIR}/migrate_addon
    
  2. משביתים את ה-webhook של אימות הגהה. השלב הזה נדרש כדי להעביר חלק מההגדרות מגרסה 1.4 אל Cloud Service Mesh. תשובה Y לשתי השאלות:

    ${WORKDIR}/migrate_addon -d tmpdir --command disable-galley-webhook
    

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

    tmpdir directory not present. Create directory? Continue? [Y/n] Y
    
    Disabling the Istio validation webhook... Continue? [Y/n] Y
    Running: kubectl get clusterrole istio-galley-istio-system -n istio-system -o yaml
    Running: kubectl patch clusterrole -n istio-system istio-galley-istio-system --type=json -p=[{"op": "replace", "path": "/rules/2/verbs/0", "value": "get"}]
    clusterrole.rbac.authorization.k8s.io/istio-galley-istio-system patched
    Running: kubectl get ValidatingWebhookConfiguration istio-galley --ignore-not-found
    Running: kubectl delete ValidatingWebhookConfiguration istio-galley --ignore-not-found
    validatingwebhookconfiguration.admissionregistration.k8s.io "istio-galley" deleted
    
    
  3. מאמתים ומעבירים את ההגדרות באופן ידני. השלב הזה עוזר לזהות חלק מההגדרות שצריך להעביר באופן ידני לפני העברת עומסי העבודה למישור הבקרה שמנוהל על ידי Google.

    ${WORKDIR}/migrate_addon -d tmpdir --command config-check
    

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

    Installing the authentication CR migration tool...
    OK
    
    Checking for configurations that will need to be explicitly migrated...
    No resources found
    

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

יכול להיות שתצטרכו להעביר באופן ידני הגדרות בהתאמה אישית לפני שתעברו ל-Cloud Service Mesh. הסקריפט שלמעלה מזהה הגדרות בהתאמה אישית ומדפיס מידע על מה שנדרש. ההתאמות האישיות האלה הן:

  • מסנני Envoy מותאמים אישית שזוהו לא נתמכים על ידי Cloud Service Mesh. אם אפשר, כדאי להסיר אותם. בשלב הזה, אין תמיכה במסנני Envoy במישור הבקרה שמנוהל על ידי Google.

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

  • זוהתה מדיניות אבטחה שלא ניתן להעביר. <Error reason>. בדרך כלל הפעולה נכשלת בגלל מדיניות AuthZ אלפא שצריך להעביר באופן ידני. למידע נוסף על העברת מדיניות, אפשר לעיין במאמר העברת מדיניות אבטחה מגרסה קודמת ל-Istio 1.4 Alpha לממשקי ה-API הנוכחיים. מידע נוסף על הודעת השגיאה זמין במאמר בנושא העברה של מדיניות אבטחה.

  • זוהתה הגדרה של VirtualService שאולי לא תואמת. <Specific deprecated config>. צריך לעדכן את ההגדרות הבאות: VirtualService

    • אין תמיכה בשימוש ב-appendHeaders. במקום זאת, אתם צריכים להשתמש ב-spec.http.headers.
    • אין צורך להשתמש ב-websocketUpgrade. ההגדרה הזו מופעלת כברירת מחדל.
    • מחליפים את השדה abort.percent ב-abort.percentage.
  • זוהתה התקנה מותאמת אישית של משאבי מיקסר שלא ניתן להעביר אותה. נדרשת העברה ידנית ל-telemetryv2. אם הגדרתם מדיניות מיקסר בהתאמה אישית בנוסף להתקנת ברירת המחדל של Istio ב-GKE, תצטרכו להעביר את המדיניות הזו לטלמטריה v2 באופן ידני. מידע נוסף על אופן ההגדרה מופיע במאמר בנושא התאמה אישית של מדדים ב-Istio.

  • הפריסה [שם הפריסה] יכולה להיות שער בהתאמה אישית. צריך להעביר את זה באופן ידני. צריך להעביר ידנית את כל פריסות השערים מלבד istio-ingressgateway (שמותקן כברירת מחדל). מידע על שדרוג שערים למישור הבקרה בניהול Google זמין במאמר הגדרת מישור הבקרה בניהול Google.

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

  1. לפני שעוברים לשלב 2, מעבירים באופן ידני את כל ההגדרות המותאמות אישית (למעט ההגדרה האחרונה שמופיעה ברשימה).

  2. משתמשים בכלי ההעברה כדי להעביר את ההגדרות שאפשר להעביר באופן אוטומטי (או להתעלם מהן).

    ${WORKDIR}/migrate_addon -d tmpdir --command migrate-configs
    

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

    Converting authentication CRs...
    2021/06/25 20:44:58 found root namespace: istio-system
    2021/06/25 20:44:59 SUCCESS converting policy /default
    Running: kubectl apply --dry-run=client -f beta-policy.yaml
    peerauthentication.security.istio.io/default created (dry run)
    
    Applying converted security policies in tmpdir/beta-policy.yaml... Continue? [Y/n] Y
    Running: kubectl apply -f beta-policy.yaml
    peerauthentication.security.istio.io/default created
    OK
    
    
  3. החלת מהימנות הבסיס של רשות האישורים של Cloud Service Mesh. כך תוכלו לעבור מרשות האישורים הנוכחית של Citadel לרשות האישורים של Cloud Service Mesh בלי לגרום להשבתה של האפליקציות שלכם.

    ${WORKDIR}/migrate_addon -d tmpdir --command configure-mesh-ca
    

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

    Configuring Istio on GKE to trust Anthos Service Mesh... Continue? [Y/n] Y
    Running: kubectl get cm -n istio-system istio-asm-managed -oyaml
    Running: kubectl -n istio-system apply -f -
    secret/meshca-root created
    Running: kubectl get cm istio -n istio-system -o yaml
    Running: kubectl get cm istio -n istio-system -o yaml
    Running: kubectl replace -f -
    configmap/istio replaced
    Running: kubectl get deploy istio-pilot -n istio-system -o yaml
    Running: kubectl patch deploy istio-pilot -n istio-system -p={"spec":{"template":{"spec":{"containers":[{
        "name":"discovery",
        "image":"gcr.io/gke-release/istio/pilot:1.4.10-gke.12",
        "env":[{"name":"PILOT_SKIP_VALIDATE_TRUST_DOMAIN","value":"true"}]
      }]}}}}
    deployment.apps/istio-pilot patched
    Running: kubectl get deploy istio-citadel -n istio-system -o yaml
    Running: kubectl patch deploy istio-citadel -n istio-system -p={"spec":{"template":{"spec":{
        "containers":[{
          "name":"citadel",
          "args": ["--append-dns-names=true", "--grpc-port=8060", "--citadel-storage-namespace=istio-system", "--custom-dns-names=istio-pilot-service-account.istio-system:istio-pilot.istio-system", "--monitoring-port=15014", "--self-signed-ca=true", "--workload-cert-ttl=2160h", "--root-cert=/var/run/root-certs/meshca-root.pem"],
          "volumeMounts": [{"mountPath": "/var/run/root-certs", "name": "meshca-root", "readOnly": true}]
        }],
        "volumes": [{"name": "meshca-root", "secret":{"secretName": "meshca-root"}}]
      }}}}
    deployment.apps/istio-citadel patched
    OK
    
    Waiting for root certificate to distribute to all pods. This will take a few minutes...
    ASM root certificate not distributed to asm-system, trying again later
    ASM root certificate not distributed to asm-system, trying again later
    ASM root certificate distributed to namespace asm-system
    ASM root certificate distributed to namespace default
    ASM root certificate distributed to namespace istio-operator
    ASM root certificate not distributed to istio-system, trying again later
    ASM root certificate not distributed to istio-system, trying again later
    ASM root certificate distributed to namespace istio-system
    ASM root certificate distributed to namespace kube-node-lease
    ASM root certificate distributed to namespace kube-public
    ASM root certificate distributed to namespace kube-system
    ASM root certificate distributed to namespace online-boutique
    Waiting for proxies to pick up the new root certificate...
    OK
    
    Configuring Istio Addon 1.6 to trust Anthos Service Mesh...
    Running: kubectl get cm -n istio-system env-asm-managed -ojsonpath={.data.TRUST_DOMAIN} --ignore-not-found
    Running: kubectl get cm istio-istio-1611 -n istio-system -o yaml
    Running: kubectl replace -f -
    configmap/istio-istio-1611 replaced
    Running: kubectl patch -n istio-system istiooperators.install.istio.io istio-1-6-11-gke-0 --type=merge
    istiooperator.install.istio.io/istio-1-6-11-gke-0 patched
    Running: kubectl -n istio-system get secret istio-ca-secret -ojsonpath={.data.ca-cert\.pem}
    Running: kubectl -n istio-system patch secret istio-ca-secret
    secret/istio-ca-secret patched
    Running: kubectl patch deploy istiod-istio-1611 -n istio-system
    deployment.apps/istiod-istio-1611 patched
    Running: kubectl rollout status -w deployment/istiod-istio-1611 -n istio-system
    Waiting for deployment "istiod-istio-1611" rollout to finish: 1 old replicas are pending termination...
    deployment "istiod-istio-1611" successfully rolled out
    Running: kubectl apply -f - -n istio-system
    envoyfilter.networking.istio.io/trigger-root-cert created
    Waiting for proxies to pick up the new root certificate...
    Running: kubectl delete envoyfilter trigger-root-cert -n istio-system
    OK
    
    

    בשלב הזה, יידרשו כמה דקות עד שאישור הבסיס של Cloud Service Mesh יופץ לכל מרחבי השמות. ממתינים עד שהסקריפט יסתיים עם ההודעה OK.

בשלב הקודם מתבצעות הפעולות הבאות:

  • הפקודה מתקינה את שורש המהימנות של רשות האישורים של Cloud Service Mesh לכל עומסי העבודה באשכול.
  • שינוי ההגדרות של פריסות מישור הבקרה istio-pilot, istiod ו-istio-citadel. השינויים כוללים:

    • שדרוג התמונות לגרסאות ה-build העדכניות.
    • השבתת האימות של trust-domain באמצעות הגדרה.PILOT_SKIP_VALIDATE_TRUST_DOMAIN=true
    • הוספת שורש האמון של רשות האישורים של Cloud Service Mesh אל istio-citadel כדי להפיץ את ConfigMap לכל מרחבי השמות.
    • הוספת בסיס האמון של רשות האישורים של Cloud Service Mesh אל istio-ca-secret כדי להפיץ את אישור הבסיס.
  • מאחסן את מניפסטים של הגדרות ישנות יותר ב-tmpdir.

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

העברת עומסי עבודה (workloads) ל-Cloud Service Mesh

בקטע הזה מוסבר איך להעביר עומסי עבודה שפועלים ב-Istio ב-GKE אל Cloud Service Mesh. אחרי ההעברה, מוודאים שבוצעת הזרקה של פרוקסי מסוג sidecar (Cloud Service Mesh) בכל Pod ושהאפליקציה פועלת כמצופה.

אם מבצעים את התהליך הזה באשכול קיים, בוחרים מרחב שמות להעברה.

  1. מגדירים את מרחב השמות כמשתנה. מרחב השמות הזה מועבר אל Cloud Service Mesh:

    export NAMESPACE=NAMESPACE_NAME
    
  2. כדי להעביר עומסי עבודה ל-Cloud Service Mesh, צריך להוסיף תווית מחדש למרחב השמות של Cloud Service Mesh. הוספת תווית למרחב השמות מאפשרת ל-Cloud Service Mesh להוסיף באופן אוטומטי קבצי sidecar לכל עומסי העבודה. כדי להוסיף תווית למרחב השמות, מריצים את הפקודה הבאה ומגדירים את התווית ל-asm-managed:

    kubectl --context=${CLUSTER_1_CTX} label namespace ${NAMESPACE} istio.io/rev=asm-managed istio-injection- --overwrite
    
  3. מבצעים הפעלה מחדש מתגלגלת של כל פריסות ה-Deployments במרחב השמות:

    kubectl --context=${CLUSTER_1_CTX} rollout restart deployment -n ${NAMESPACE}
    

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

    deployment.apps/deploymentName1 restarted
    deployment.apps/deploymentName2 restarted
    ...
    
  4. מוודאים שכל ה-Pods מופעלים מחדש ופועלים עם שני קונטיינרים לכל Pod:

    kubectl --context=${CLUSTER_1_CTX} -n ${NAMESPACE} get pods
    

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

    NAME                        READY   STATUS    RESTARTS   AGE
    deploymentName1-PodName     2/2     Running   0          101s
    deploymentName2-PodName     2/2     Running   2          100s
    ...
    

    דרך טובה לאמת את השלב הזה היא לבדוק את AGE של ה-Pods. חשוב לוודא שהערך קצר – למשל, כמה דקות.

  5. כדי לוודא שפרסתם עכשיו פרוקסי Envoy של Cloud Service Mesh, בודקים את גרסת פרוקסי Envoy של sidecar מכל אחד מה-Pods מכל Deployment במרחב השמות:

    export POD_NAME=NAME_OF_ANY_POD_IN_NAMESPACE
    kubectl --context=${CLUSTER_1_CTX} get pods ${POD_NAME} -n ${NAMESPACE} -o json | jq '.status.containerStatuses[].image'
    

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

    "gcr.io/gke-release/asm/proxyv2:1.11.5-asm.3"
    "appContainerImage"
    
  6. אחרי ההפעלה מחדש, צריך לאמת ולבדוק את האפליקציות.

    kubectl --context=${CLUSTER_1_CTX} -n istio-system get service istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}'
    
  7. (אופציונלי) אם רוצים ש-Google תנהל את השדרוגים של השרתים הפרוקסי, מפעילים את האפשרות Google-managed data plane (מישור נתונים בניהול Google).

הצגת סטטוס ההעברה

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

kubectl get cm/asm-addon-migration-state -n istio-system -ojsonpath={.data}

בפלט יצוין אם ההעברה הושלמה, נמצאת בהמתנה או נכשלה:

{"migrationStatus":"SUCCESS"}

{"migrationStatus":"PENDING"}

{"migrationStatus":"MIGRATION_CONFIG_ERROR"}

{"migrationStatus":"CONTROLPLANE_PROVISION_ERROR"}

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

אם הפקודה migrationStatus מחזירה סטטוס אחר מלבד SUCCESS, אפשר לבחור באחת מהאפשרויות הבאות:

אחרי ההעברה, אפשר לראות את מדדי מישור הבקרה ב-Metrics Explorer. ראו verify_control_plane_metrics

גישה ללוחות הבקרה של Cloud Service Mesh

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

  1. נכנסים לדף Cloud Service Mesh במסוף Google Cloud .

    כניסה ל-Cloud Service Mesh

  2. אמורה להיות לכם אפשרות לראות את המדדים והטופולוגיה של השירותים.

מידע נוסף על לוחות הבקרה של Cloud Service Mesh זמין במאמר הכרת Cloud Service Mesh ב Google Cloud מסוף.

השלמת העברה מוצלחת

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

  1. מחליפים את istio-ingressgateway (חלק מ-Istio רגיל ב-GKE) בשער עם ניהול של Google במישור הבקרה עם ניהול של Google:

    ${WORKDIR}/migrate_addon -d tmpdir --command replace-gateway
    

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

    Replacing the ingress gateway with an Anthos Service Mesh gateway... Continue? [Y/n] Y
    Running: kubectl label namespace istio-system istio-injection- istio.io/rev- --overwrite
    label "istio.io/rev" not found.
    namespace/istio-system labeled
    Running: kubectl apply -f -
    serviceaccount/asm-ingressgateway created
    deployment.apps/asm-ingressgateway created
    role.rbac.authorization.k8s.io/asm-ingressgateway created
    rolebinding.rbac.authorization.k8s.io/asm-ingressgateway created
    Running: kubectl wait --for=condition=available --timeout=600s deployment/asm-ingressgateway -n istio-system
    deployment.apps/asm-ingressgateway condition met
    
    Scaling the Istio ingress gateway to zero replicas... Continue? [Y/n] Y
    Running: kubectl -n istio-system patch hpa istio-ingressgateway --patch {"spec":{"minReplicas":1}}
    horizontalpodautoscaler.autoscaling/istio-ingressgateway patched (no change)
    Running: kubectl -n istio-system scale deployment istio-ingressgateway --replicas=0
    deployment.apps/istio-ingressgateway scaled
    OK
    
  2. מגדירים מחדש את ה-webhook כך שישתמש במישור הבקרה שמנוהל על ידי Google. כל עומסי העבודה מתחילים להשתמש במישור הבקרה שמנוהל על ידי Google:

    ${WORKDIR}/migrate_addon -d tmpdir --command replace-webhook
    

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

    Configuring sidecar injection to use Anthos Service Mesh by default... Continue? [Y/n] Y
    Running: kubectl patch mutatingwebhookconfigurations istio-sidecar-injector --type=json -p=[{"op": "replace", "path": "/webhooks"}]
    mutatingwebhookconfiguration.admissionregistration.k8s.io/istio-sidecar-injector patched
    Revision tag "default" created, referencing control plane revision "asm-managed". To enable injection using this
    revision tag, use 'kubectl label namespace <NAMESPACE> istio.io/rev=default'
    OK
    
  3. משנים את התווית של כל מרחבי השמות לתווית Cloud Service Mesh, ומבצעים הפעלה מחדש הדרגתית של כל עומסי העבודה כדי להעביר אותם למישור הבקרה שמנוהל על ידי Google:

    export NAMESPACE=NAMESPACE_NAME \
        kubectl --context=${CLUSTER_1_CTX} label namespace ${NAMESPACE}
        istio.io/rev=asm-managed istio-injection- --overwrite`
    
        kubectl --context=${CLUSTER_1_CTX} rollout restart deployment -n
    ${NAMESPACE}
    

    אפשר להתעלם מההודעה "istio-injection not found" בפלט. כלומר, למרחב השמות לא הייתה בעבר התווית istio-injection, וזה מה שצריך לקרות בהתקנות חדשות של Cloud Service Mesh או בפריסות חדשות. ההזרקה האוטומטית נכשלת אם במרחב שמות יש גם את התווית istio-injection וגם את תווית הגרסה, ולכן כל הפקודות kubectl label במסמכי התיעוד של Istio ב-GKE כוללות הסרה של התווית istio-injection.

  4. מריצים את הפקודה הבאה כדי להשלים את ההעברה:

    ${WORKDIR}/migrate_addon -d tmpdir --command write-marker
    

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

    Current migration state: SUCCESS
    Running: kubectl apply -f -
    configmap/asm-addon-migration-state created
    OK
    
    
  5. כדי להשבית את Istio ב-GKE, מריצים את הפקודה הבאה:

    אשכולות אזוריים

    gcloud beta container clusters update ${CLUSTER_1} \
        --project=$PROJECT_ID \
        --zone=${CLUSTER_1_LOCATION} \
        --update-addons=Istio=DISABLED
    

    אשכולות אזוריים

    gcloud beta container clusters update ${CLUSTER_1} \
        --project=$PROJECT_ID \
        --region=${CLUSTER_1_LOCATION} \
        --update-addons=Istio=DISABLED
    
  6. מריצים את הפקודה הבאה כדי לנקות את ההגדרות:

    ${WORKDIR}/migrate_addon -d tmpdir --command cleanup
    

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

    Cleaning up old resources...
    Running: kubectl get cm -n istio-system asm-addon-migration-state -ojsonpath={.data.migrationStatus}
    Will delete IstioOperator/istio-1-6-11-gke-0.istio-system
    Will delete ServiceAccount/istio-citadel-service-account.istio-system
    ...
    Will delete DestinationRule/istio-policy.istio-system
    Will delete DestinationRule/istio-telemetry.istio-system
    Will delete Secret/istio-ca-secret.istio-system
    
    Deleting resources previously listed... Continue? [Y/n] Y
    Running: kubectl delete IstioOperator istio-1-6-11-gke-0 -n istio-system --ignore-not-found
    istiooperator.install.istio.io "istio-1-6-11-gke-0" deleted
    Running: kubectl delete ServiceAccount istio-citadel-service-account -n istio-system --ignore-not-found
    serviceaccount "istio-citadel-service-account" deleted-ingressgateway -n istio-system --ignore-not-found
    ...
    Running: kubectl delete Secret istio-ca-secret -n istio-system --ignore-not-found
    secret "istio-ca-secret" deleted
    Running: kubectl delete -n istio-system jobs -lk8s-app=istio,app=security
    job.batch "istio-security-post-install-1.4.10-gke.8" deleted
    
  7. מוודאים שההטמעות והשירותים של Istio ב-GKE הוסרו מהאשכול בהצלחה:

    kubectl --context=${CLUSTER_1_CTX} -n istio-system get deployments,services
    

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

    NAME                                 READY   UP-TO-DATE   AVAILABLE   AGE
    deployment.apps/asm-ingressgateway   1/1     1            1           10m
    
    NAME                           TYPE           CLUSTER-IP    EXTERNAL-IP      AGE   PORT(S)
    service/istio-ingressgateway   LoadBalancer   10.64.5.208   34.139.100.237   95m   15020:31959/TCP,80:30971/TCP,443:31688/TCP,31400:31664/TCP,15029:32493/TCP,15030:31722/TCP,15031:30198/TCP,15032:31910/TCP,15443:31222/TCP
    
    

    מוצגים רק שירות ושכבת פריסה של שער כניסה ל-Cloud Service Mesh.

כל הכבוד. הצלחתם לבצע מיגרציה מ-Istio ב-GKE אל Cloud Service Mesh עם מישור הבקרה שמנוהל על ידי Google ורשות האישורים של Cloud Service Mesh, בלי השבתה של האפליקציות.

ביטול שינויים

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

  1. מבטלים את השינויים ב-webhook לשינוי:

    ${WORKDIR}/migrate_addon -d tmpdir --command rollback-mutatingwebhook
    

  2. כדי להשתמש בהזרקת sidecar של Istio ב-GKE במקום ב-Cloud Service Mesh, מריצים את הפקודה הבאה כדי להגדיר מחדש את התוויות של מרחבי השמות:

    למרחבי שמות עם עומסי עבודה בגרסה 1.4:

    export NAMESPACE=NAMESPACE_NAME
    kubectl --context=${CLUSTER_1_CTX} label namespace ${NAMESPACE} istio.io/rev- istio-injection=enabled --overwrite
    

    למרחבי שמות עם עומסי עבודה (workloads) בגרסה 1.6:

    export NAMESPACE=NAMESPACE_NAME
    kubectl --context=${CLUSTER_1_CTX} label namespace ${NAMESPACE} istio.io/rev=istio-1611 --overwrite
    

  3. מבצעים הפעלה מחדש מתגלגלת של כל פריסות ה-Deployments במרחב השמות:

    kubectl --context=${CLUSTER_1_CTX} rollout restart deployment -n ${NAMESPACE}
    
  4. ממתינים כמה דקות ומוודאים שכל ה-Pods פועלים:

    kubectl --context=${CLUSTER_1_CTX} -n ${NAMESPACE} get pods
    

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

    NAME                       READY   STATUS    RESTARTS   AGE
    deploymentName1-PodName    2/2     Running   0          101s
    deploymentName2-PodName    2/2     Running   2          100s
    ...
    
    
  5. כדי לוודא שפרסתם את Istio ב-GKE v1.4 Envoy proxies, מאמתים את גרסת ה-sidecar Envoy proxy מכל אחד מה-Pods:

    export POD_NAME=NAME_OF_ANY_POD_IN_NAMESPACE
    kubectl --context=${CLUSTER_1_CTX} get pods ${POD_NAME} -n ${NAMESPACE} -o json | jq '.status.containerStatuses[].image'
    

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

    "gke.gcr.io/istio/proxyv2:1.4.10-gke.8"
    "appContainerImage"
    

    או

    "gke.gcr.io/istio/proxyv2:1.6.14-gke.4"
    "appContainerImage"
    

  6. אחרי ההפעלה מחדש, צריך לאמת ולבדוק את האפליקציות.

  7. החזרה לגרסה הקודמת של השינויים ברשות האישורים של Cloud Service Mesh:

    ${WORKDIR}/migrate_addon -d tmpdir --command rollback-mesh-ca
    
  8. מפעילים מחדש את ה-webhook של Istio Galley:

    ${WORKDIR}/migrate_addon -d tmpdir --command enable-galley-webhook
    

השינויים ב-Istio ב-GKE בוטלו בהצלחה.

פריסת Online Boutique

בקטע הזה פורסים אפליקציה לדוגמה שמבוססת על מיקרו-שירותים בשם Online Boutique באשכול GKE. האפליקציה Online Boutique נפרסת במרחב שמות עם Istio. מוודאים שהאפליקציה פועלת ו-Istio ב-GKE מזריק את פרוקסי sidecar לכל Pod.

אם כבר יש לכם אשכולות קיימים עם אפליקציות, אתם יכולים לדלג על יצירת מרחב שמות חדש ועל פריסת Online Boutique. אפשר לבצע את אותו תהליך לכל מרחבי השמות בקטע העברת עומסי עבודה ל-Cloud Service Mesh.

  1. פורסים את Online Boutique לאשכול GKE:

    kpt pkg get \
    https://github.com/GoogleCloudPlatform/microservices-demo.git/release \
    online-boutique
    
    kubectl --context=${CLUSTER_1_CTX} create namespace online-boutique
    kubectl --context=${CLUSTER_1_CTX} label namespace online-boutique istio-injection=enabled
    
    kubectl --context=${CLUSTER_1_CTX} -n online-boutique apply -f online-boutique
    
  2. מחכים עד שכל הפריסות יהיו מוכנות:

    kubectl --context=${CLUSTER_1_CTX} -n online-boutique wait --for=condition=available --timeout=5m deployment adservice
    kubectl --context=${CLUSTER_1_CTX} -n online-boutique wait --for=condition=available --timeout=5m deployment checkoutservice
    kubectl --context=${CLUSTER_1_CTX} -n online-boutique wait --for=condition=available --timeout=5m deployment currencyservice
    kubectl --context=${CLUSTER_1_CTX} -n online-boutique wait --for=condition=available --timeout=5m deployment emailservice
    kubectl --context=${CLUSTER_1_CTX} -n online-boutique wait --for=condition=available --timeout=5m deployment frontend
    kubectl --context=${CLUSTER_1_CTX} -n online-boutique wait --for=condition=available --timeout=5m deployment paymentservice
    kubectl --context=${CLUSTER_1_CTX} -n online-boutique wait --for=condition=available --timeout=5m deployment productcatalogservice
    kubectl --context=${CLUSTER_1_CTX} -n online-boutique wait --for=condition=available --timeout=5m deployment shippingservice
    kubectl --context=${CLUSTER_1_CTX} -n online-boutique wait --for=condition=available --timeout=5m deployment cartservice
    kubectl --context=${CLUSTER_1_CTX} -n online-boutique wait --for=condition=available --timeout=5m deployment loadgenerator
    kubectl --context=${CLUSTER_1_CTX} -n online-boutique wait --for=condition=available --timeout=5m deployment recommendationservice
    
  3. מוודאים שיש שני קונטיינרים לכל Pod – קונטיינר האפליקציה ו-Istio sidecar proxy ש-Istio ב-GKE מוסיף אוטומטית ל-Pod:

    kubectl --context=${CLUSTER_1_CTX} -n online-boutique get pods
    

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

    NAME                                     READY   STATUS    RESTARTS   AGE
    adservice-7cbc9bd9-t92k4                 2/2     Running   0          3m21s
    cartservice-d7db78c66-5qfmt              2/2     Running   1          3m23s
    checkoutservice-784bfc794f-j8rl5         2/2     Running   0          3m26s
    currencyservice-5898885559-lkwg4         2/2     Running   0          3m23s
    emailservice-6bd8b47657-llvgv            2/2     Running   0          3m27s
    frontend-764c5c755f-9wf97                2/2     Running   0          3m25s
    loadgenerator-84cbcd768c-5pdbr           2/2     Running   3          3m23s
    paymentservice-6c676df669-s779c          2/2     Running   0          3m25s
    productcatalogservice-7fcf4f8cc-hvf5x    2/2     Running   0          3m24s
    recommendationservice-79f5f4bbf5-6st24   2/2     Running   0          3m26s
    redis-cart-74594bd569-pfhkz              2/2     Running   0          3m22s
    shippingservice-b5879cdbf-5z7m5          2/2     Running   0          3m22s
    
  4. אפשר גם לבדוק את גרסת ה-Envoy proxy של ה-sidecar מכל אחד מה-Pods כדי לוודא שפרסתם את Istio ב-GKE v1.4 Envoy proxies:

    export FRONTEND_POD=$(kubectl get pod -n online-boutique -l app=frontend --context=${CLUSTER_1_CTX} -o jsonpath='{.items[0].metadata.name}')
    kubectl --context=${CLUSTER_1_CTX} get pods ${FRONTEND_POD} -n online-boutique -o json | jq '.status.containerStatuses[].image'
    

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

    "gke.gcr.io/istio/proxyv2:1.4.10-gke.8"
    "gcr.io/google-samples/microservices-demo/frontend:v0.3.4"
    
  5. כדי לגשת לאפליקציה, עוברים לכתובת ה-IP של istio-ingressgateway כתובת ה-IP של השירות:

    kubectl --context=${CLUSTER_1_CTX} -n istio-system get service istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}'
    

שאלות נפוצות

בקטע הזה מופיעות שאלות נפוצות ותשובות שקשורות למעבר מ-Istio ב-GKE ל-Cloud Service Mesh.

למה מתבצעת מיגרציה מ-Istio ב-GKE אל Cloud Service Mesh?

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

‫Cloud Service Mesh הוא מוצר של Google לניהול רשתות שירותים שנתמך על ידי Google ומבוסס על ממשקי Istio API. ‫Cloud Service Mesh הוא ל-Istio כמו ש-GKE הוא ל-Kubernetes. מכיוון ש-Cloud Service Mesh מבוסס על ממשקי Istio API, אפשר להמשיך להשתמש בהגדרות Istio כשעוברים ל-Cloud Service Mesh. בנוסף, אין נעילת ספק קניינית.

היתרונות של Cloud Service Mesh:

  • רשת Service mesh שמנוהלת על ידי Google ונתמכת על ידי Google.
  • ממשקי API של Istio ללא נעילת ספק.
  • לוחות בקרה של טלמטריה וניהול של SLO מוכנים לשימוש בלי צורך לנהל פתרונות נוספים של צד שלישי.
  • אפשרויות של רשות אישורים שמתארחת ב-Google.
  • שילוב עם Google Cloud רשתות ושרת proxy לאימות זהויות (IAP).
  • תמיכה בפלטפורמות היברידיות ומרובות עננים (multi-cloud).

מידע נוסף על התכונות והיכולות של Cloud Service Mesh זמין במאמר בנושא תכונות נתמכות של מישור בקרה בניהול Google.

האם תהיה השבתה כלשהי שקשורה למיגרציה הזו?

סקריפט ההעברה נועד למנוע השבתה. הסקריפט מתקין את Cloud Service Mesh כמישור בקרה של גרסה ראשונית (canary) לצד מישור הבקרה הקיים של Istio. המהדורה istio-ingressgateway משודרגת במקום. לאחר מכן, משנים את התווית של מרחבי השמות שמופעל בהם Istio כדי להתחיל להשתמש ב-Cloud Service Mesh עם רשות האישורים של Cloud Service Mesh.

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

האם השימוש ב-Cloud Service Mesh כרוך בתשלום?

יש שתי דרכים להשתמש ב-Cloud Service Mesh ב-GKE:

יש תכונות או הגדרות שלא נתמכות בגרסה האחרונה של Cloud Service Mesh?

הסקריפט בודק את כל ההגדרות של Istio ומעביר אותן לגרסה העדכנית ביותר של Cloud Service Mesh. יש הגדרות מסוימות שעשויות לדרוש שלבים נוספים כדי להעביר אותן מ-Istio גרסה 1.4 ל-Cloud Service Mesh גרסה 1.10. הסקריפט מבצע בדיקת הגדרות ומודיע לכם אם יש הגדרות שדורשות שלבים נוספים.

האם ההעברה משנה את ההגדרות הנוכחיות של Istio?

לא, ההגדרות של Istio פועלות ב-Cloud Service Mesh בלי שצריך לבצע שינויים.

אחרי שאעבור ל-Cloud Service Mesh, אוכל לחזור ל-Istio?

כן, אין התחייבות לשימוש ב-Cloud Service Mesh. אתם יכולים להסיר את Cloud Service Mesh ולהתקין מחדש את Istio מתי שתרצו.

אם ההעברה נכשלת, אפשר לבטל אותה?

כן, הסקריפט מאפשר לחזור לגרסה הקודמת של Istio ב-GKE.

באיזו גרסה של Istio אפשר להשתמש בסקריפט הזה כדי לבצע העברה?

הסקריפט עוזר לכם לבצע מיגרציה מ-Istio ב-GKE גרסה 1.4 ל-Cloud Service Mesh גרסה 1.10. הסקריפט מאמת את גרסת Istio בשלב שלפני ההעברה, ומודיע לכם אם אפשר להעביר את גרסת Istio שלכם.

איך אפשר לקבל עזרה נוספת בהעברה הזו?

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

מה יקרה אם לא אעבור אל Cloud Service Mesh?

רכיבי Istio ימשיכו לפעול, אבל Google כבר לא תנהל את ההתקנה של Istio. לא תקבלו יותר עדכונים אוטומטיים, ואין ערובה שההתקנה תפעל כשהגרסה של אשכול Kubernetes תתעדכן.

מידע נוסף זמין במאמר בנושא תמיכה ב-Istio.