התקנה של כלים תלויים ואימות של האשכול

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

התקנת הכלים הנדרשים

אפשר להריץ את asmcli ב-Cloud Shell או במחשב המקומי שבו פועלת מערכת Linux. כל הכלים הנדרשים מותקנים מראש ב-Cloud Shell.

אם אתם מריצים את asmcli באופן מקומי, ודאו שהכלים הבאים מותקנים אצלכם:

  • ‫Google Cloud CLI
  • כלי שורת הפקודה הרגילים: awk,‏ curl,‏ grep,‏ sed ו-tr
  • git
  • kubectl
  • jq
  • (אופציונלי, כדי לבדוק את הקישוריות) netcat ‏ (nc)

הגדרת gcloud

צריך לבצע את השלבים הבאים גם אם משתמשים ב-Cloud Shell.

  1. מאמתים באמצעות Google Cloud CLI:

    gcloud auth login --project PROJECT_ID
    
  2. מעדכנים את הרכיבים:

    gcloud components update
    
  3. מגדירים את kubectl כך שיצביע על האשכול.

    gcloud container clusters get-credentials CLUSTER_NAME \
         --location CLUSTER_LOCATION \
         --project PROJECT_ID
    

הורדת asmcli

בקטע הזה מוסבר איך להוריד את asmcli.

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

    curl https://storage.googleapis.com/csm-artifacts/asm/asmcli_1.31 > asmcli
    

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

    % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
    100  167k  100  167k    0     0   701k      0 --:--:-- --:--:-- --:--:--  701k
    
  2. הופכים את הסקריפט לניתן להרצה:

    chmod +x asmcli
    

מתן הרשאות אדמין של אשכול

  1. מוודאים שההקשר מוגדר לאשכול המשתמשים:

    kubectl config use-context CONTEXT
  2. נותנים לחשבון המשתמש שלכם (כתובת האימייל שלכם Google Cloud להתחברות) הרשאות אדמין באשכול. כדי ליצור את הכללים הנדרשים של בקרת גישה מבוססת-תפקידים (RBAC) ל-Cloud Service Mesh, צריך את ההרשאות הבאות:

    kubectl create clusterrolebinding cluster-admin-binding \
      --clusterrole=cluster-admin \
      --user=USER_ACCOUNT

אימות הפרויקט והאשכול

אפשר להריץ את הפקודה asmcli validate כדי לוודא שהפרויקט והאשכול מוגדרים כמו שצריך להתקנת Cloud Service Mesh. באמצעות האפשרות הזו, asmcli לא מבצע שינויים בפרויקט או באשכול, ולא מתקין את Cloud Service Mesh.

‫asmcli מאמת את הדברים הבאים:

כברירת מחדל, asmcli מוריד ומחלץ את קובץ ההתקנה ומוריד את חבילת ההגדרות asm מ-GitHub לספריית temp. לפני שיוצאים, asmcli מוציא הודעה עם השם של ספריית הזמני. מומלץ לציין ספרייה להורדות באמצעות האפשרות --output_dir DIR_PATH. האפשרות --output_dir מאפשרת לכם להשתמש בקלות בכלי שורת הפקודה istioctl. יכול להיות שתצטרכו את istioctl כדי לפתור בעיות בהגדרות או להגדיר רשת מרובת אשכולות באשכולות פרטיים של GKE. בנוסף, קובצי ההגדרות להפעלת תכונות אופציונליות באמצעות asmcli כלולים בספרייה asm/istio/options.

מריצים את הפקודה הבאה כדי לאמת את ההגדרה ולהוריד את קובץ ההתקנה ואת חבילת asm לספרייה OUTPUT_DIR.

./asmcli validate \
   --project_id PROJECT_ID \
   --cluster_name CLUSTER_NAME \
   --cluster_location CLUSTER_LOCATION \
   --fleet_id FLEET_PROJECT_ID \
   --output_dir DIR_PATH
  • ‫--project_id, --cluster_name ו---cluster_location מציינים את מזהה הפרויקט שבו נמצא האשכול, את שם האשכול ואת האזור או האזור של האשכול.

  • ‫--fleet_id מזהה הפרויקט של פרויקט המארח של הצי. ‫asmcli validate בודקת שהאשכול רשום ב-Fleet שצוין.

  • --output_dir כוללים את האפשרות הזו כדי לציין ספרייה שבה asmcli מוריד את חבילת asm ומחלץ את קובץ ההתקנה, שמכיל את istioctl, דוגמאות ומניפסטים. אחרת, asmcli מוריד את הקבצים לספרייה tmp. אפשר לציין נתיב יחסי או נתיב מלא. משתנה הסביבה $PWD לא פועל כאן.

אם הפעולה בוצעה בהצלחה, הפלט של asmcli יהיה:

asmcli: Setting up necessary files...
asmcli: Using asm_kubeconfig as the kubeconfig...
asmcli: Checking installation tool dependencies...
asmcli: Fetching/writing GCP credentials to kubeconfig file...
asmcli: Verifying connectivity (10s)...
asmcli: kubeconfig set to asm_kubeconfig
asmcli: using context gke_example-project-12345_us-central1_cluster-2
asmcli: Getting account information...
asmcli: Downloading ASM..
asmcli: Downloading ASM kpt package...
fetching package "/asm" from "https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages" to "asm"
asmcli: Checking required APIs...
asmcli: Checking for project example-project-12345...
asmcli: Reading labels for us-central1/cluster-2...
asmcli: Checking for istio-system namespace...
asmcli: Confirming node pool requirements for example-project-12345/us-central1/cluster-2...
asmcli: Checking Istio installations...
asmcli: [WARNING]: There is no way to validate that the meshconfig API has been initialized.
asmcli: [WARNING]: This needs to happen once per GCP project. If the API has not been initialized
asmcli: [WARNING]: for example-project-12345, please re-run this tool with the --enable_gcp_components
asmcli: [WARNING]: flag. Otherwise, installation will succeed but Anthos Service Mesh
asmcli: [WARNING]: will not function correctly.
asmcli: Successfully validated all requirements to install ASM.

אם אחת מהבדיקות נכשלת באימות, asmcli מציג הודעת שגיאה. לדוגמה, אם לא הפעלתם בפרויקט את כל ממשקי ה-API הנדרשים של Google, תופיע השגיאה הבאה:

ERROR: One or more APIs are not enabled. Please enable them and retry, or run
`asmcli` with the '--enable_gcp_apis' flag to allow `asmcli` to enable them
on your behalf.

אם קיבלתם הודעת שגיאה שצריך להריץ את הפקודה asmcli עם דגל הפעלה, יש לכם את האפשרויות הבאות:

  • כדי לבצע את ההתקנה בפועל, צריך להריץ את הפקודה asmcli ולכלול בה את הדגל הספציפי מהודעת השגיאה או את הדגל --enable_all flag.

  • אם אתם מעדיפים, אתם יכולים לעדכן את הפרויקט ואת האשכול בעצמכם לפני שתפעילו את asmcli כמו שמתואר במאמר הגדרה עצמית של הפרויקט ואשכול GKE.

הערה: asmcli validate לא מאפשר דגלי הפעלה כי הוא רק בודק שהפרויקט והאשכול מוכנים להתקנה.

בדיקת הדרישות להתקנה ולשדרוג של אשכול

לפני שמשדרגים, צריך לוודא שההגדרה תואמת לגרסה החדשה של Cloud Service Mesh.

  1. עוברים לספרייה שצוינה ב---output_dir.

  2. מריצים את הפקודה הבאה כדי לבדוק את דרישות ההתקנה והשדרוג של אשכול Kubernetes. חשוב לוודא שאתם משתמשים בגרסה של istioctl שמופצת עם הגרסה החדשה של Cloud Service Mesh.

    istioctl experimental precheck
    

מה השלב הבא?