מעבר מ-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.
מגדירים את הסביבה
כדי להגדיר את הסביבה, מבצעים את השלבים הבאים:
במסוף Google Cloud , מפעילים את Cloud Shell.
בחלק התחתון של דף המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Google Cloud Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud ו-Google Cloud CLI כבר מותקנים, ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
יוצרים את משתני הסביבה שמשמשים במדריך הזה:
# 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.יוצרים תיקייה ב-
WORKDIR. כל הקבצים שקשורים למדריך הזה יועברו אלWORKDIR, כך שתוכלו למחוק אתWORKDIRבסיום.mkdir -p addon-to-asm && cd addon-to-asm && export WORKDIR=`pwd`יצירת קובץ
KUBECONFIGלמדריך הזה. אפשר גם להשתמש בקובץKUBECONFIGהקיים שמכיל את הקשר של האשכול כדי להעביר את אשכול GKE אל Cloud Service Mesh.touch asm-kubeconfig && export KUBECONFIG=`pwd`/asm-kubeconfigמקבלים פרטי כניסה לאשכול 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}האשכולות צריכים להיות רשומים ב-Fleet. אפשר לבצע את השלב הזה בנפרד לפני ההתקנה, או כחלק מההתקנה על ידי העברת הדגל --fleet-id ואחד מהדגלים --enable-all או --enable-registration.
צריך להפעיל בפרויקט את התכונה 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. מישור הבקרה הזה נפרס בהתחלה לצד מישור הבקרה הקיים כמישור בקרה שני (או כמישור בקרה קנרי).
מורידים את הגרסה האחרונה של הסקריפט שמתקין את Cloud Service Mesh לספריית העבודה הנוכחית, והופכים את הסקריפט לניתן להרצה:
curl https://storage.googleapis.com/csm-artifacts/asm/asmcli > asmcli chmod +x asmcliכדי להגדיר את אשכול 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השלמת השלב הזה יכולה להימשך כמה דקות.
מעתיקים את
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. הסקריפט המודרך מזהה אילו הגדרות אפשר להעביר ואילו לא.
מורידים את כלי ההעברה והופכים אותו לקובץ הפעלה:
curl https://raw.githubusercontent.com/GoogleCloudPlatform/anthos-service-mesh-packages/main/scripts/migration/migrate-addon > ${WORKDIR}/migrate_addon chmod +x ${WORKDIR}/migrate_addonמשביתים את ה-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מאמתים ומעבירים את ההגדרות באופן ידני. השלב הזה עוזר לזהות חלק מההגדרות שצריך להעביר באופן ידני לפני העברת עומסי העבודה למישור הבקרה שמנוהל על ידי 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.
כדי להעביר הגדרות, פועלים לפי השלבים הבאים:
לפני שעוברים לשלב 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
החלת מהימנות הבסיס של רשות האישורים של 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 ושהאפליקציה פועלת כמצופה.
אם מבצעים את התהליך הזה באשכול קיים, בוחרים מרחב שמות להעברה.
מגדירים את מרחב השמות כמשתנה. מרחב השמות הזה מועבר אל Cloud Service Mesh:
export NAMESPACE=NAMESPACE_NAME
כדי להעביר עומסי עבודה ל-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מבצעים הפעלה מחדש מתגלגלת של כל פריסות ה-Deployments במרחב השמות:
kubectl --context=${CLUSTER_1_CTX} rollout restart deployment -n ${NAMESPACE}הפלט אמור להיראות כך:
deployment.apps/deploymentName1 restarted deployment.apps/deploymentName2 restarted ...
מוודאים שכל ה-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. חשוב לוודא שהערך קצר – למשל, כמה דקות.כדי לוודא שפרסתם עכשיו פרוקסי 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"
אחרי ההפעלה מחדש, צריך לאמת ולבדוק את האפליקציות.
kubectl --context=${CLUSTER_1_CTX} -n istio-system get service istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}'(אופציונלי) אם רוצים ש-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, אפשר לבחור באחת מהאפשרויות הבאות:
- אם שגיאת ההעברה לא משפיעה על עומסי העבודה הקיימים של Istio ב-GKE, לא צריך לבצע פעולות נוספות. אחרת, מחזירים את השינויים אם צריך.
- מעדכנים את ההגדרות המותאמות אישית באשכול ומריצים מחדש את ההעברה באופן ידני אם
migrationStatusמציגMIGRATION_CONFIG_ERROR.
אחרי ההעברה, אפשר לראות את מדדי מישור הבקרה ב-Metrics Explorer. ראו verify_control_plane_metrics
גישה ללוחות הבקרה של Cloud Service Mesh
בקטע הזה, עוברים אל לוחות הבקרה של Cloud Service Mesh ומוודאים שמתקבלים האותות המוזהבים לכל השירותים. אמורה להיות לכם גם אפשרות לראות את טופולוגיית האפליקציה.
נכנסים לדף Cloud Service Mesh במסוף Google Cloud .
אמורה להיות לכם אפשרות לראות את המדדים והטופולוגיה של השירותים.
מידע נוסף על לוחות הבקרה של Cloud Service Mesh זמין במאמר הכרת Cloud Service Mesh ב Google Cloud מסוף.
השלמת העברה מוצלחת
בקטע הזה מסיימים את ההעברה של Istio ב-GKE אל Cloud Service Mesh. לפני שממשיכים לקטע הזה, חשוב לוודא שרוצים להמשיך עם Cloud Service Mesh. בקטע הזה מוסבר גם איך לנקות את הארטיפקטים של Istio ב-GKE. כדי לחזור ל-Istio ב-GKE, עוברים אל הקטע הבא.
מחליפים את
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מגדירים מחדש את ה-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משנים את התווית של כל מרחבי השמות לתווית 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.מריצים את הפקודה הבאה כדי להשלים את ההעברה:
${WORKDIR}/migrate_addon -d tmpdir --command write-markerהפלט אמור להיראות כך:
Current migration state: SUCCESS Running: kubectl apply -f - configmap/asm-addon-migration-state created OK
כדי להשבית את 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מריצים את הפקודה הבאה כדי לנקות את ההגדרות:
${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מוודאים שההטמעות והשירותים של 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.
מבטלים את השינויים ב-webhook לשינוי:
${WORKDIR}/migrate_addon -d tmpdir --command rollback-mutatingwebhookכדי להשתמש בהזרקת 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מבצעים הפעלה מחדש מתגלגלת של כל פריסות ה-Deployments במרחב השמות:
kubectl --context=${CLUSTER_1_CTX} rollout restart deployment -n ${NAMESPACE}ממתינים כמה דקות ומוודאים שכל ה-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 ...
כדי לוודא שפרסתם את 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"
אחרי ההפעלה מחדש, צריך לאמת ולבדוק את האפליקציות.
החזרה לגרסה הקודמת של השינויים ברשות האישורים של Cloud Service Mesh:
${WORKDIR}/migrate_addon -d tmpdir --command rollback-mesh-caמפעילים מחדש את ה-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.
פורסים את 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מחכים עד שכל הפריסות יהיו מוכנות:
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מוודאים שיש שני קונטיינרים לכל 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
אפשר גם לבדוק את גרסת ה-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"
כדי לגשת לאפליקציה, עוברים לכתובת ה-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:
אם יש לכם מינוי ל-GKE Enterprise, Cloud Service Mesh כלול כחלק מהמינוי ל-GKE Enterprise.
אם אין לכם מינוי ל-GKE Enterprise, אתם יכולים להשתמש ב-Cloud Service Mesh כמוצר עצמאי ב-GKE (ב-Google Cloud). למידע נוסף, אפשר לעיין בפרטי התמחור של Cloud Service Mesh.
יש תכונות או הגדרות שלא נתמכות בגרסה האחרונה של 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.