התאמה אישית של ההתקנה של Google Cloud

איך מתקינים את Knative serving באשכולות GKE ב- Google Cloud מעכשיו, Knative serving משתמש ב-Cloud Service Mesh ובציים של GKE Enterprise. מה חדש ומה השתנה בהתקנות של Knative serving בצי

אתם יכולים להשתמש בדף הזה כדי להתאים אישית התקנה חדשה או להגדיר התקנה קיימת של Fleet של Knative serving. לדוגמה, אפשר להגדיר אשכולות פרטיים או להגדיר פרטי כניסה ל-Cloud Monitoring.

שלבי ההתקנה שמוגדרים כברירת מחדל פורסים באופן אוטומטי את המשאב המותאם אישית הבא של CloudRun, שמפעיל מדדים באשכולות של GKE Enterprise ב-Google Cloud:

  apiVersion: operator.run.cloud.google.com/v1alpha1
  kind: CloudRun
  metadata:
    name: cloud-run

למידע כללי על משאבים בהתאמה אישית, ראו משאבים בהתאמה אישית.

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

  • חשוב לוודא שאתם עומדים בדרישות המוקדמות להתקנה.

  • אם Knative serving מותקן באשכול, צריך לוודא ש-GKE add-on לא קיים לפני שמבצעים את שלבי ההתקנה של רכיב ה-fleet. אם התקנתם את התוסף, אתם צריכים לפעול לפי השלבים לשדרוג ל-GKE Enterprise fleets.

    בודקים אם התוסף של GKE מותקן.

    כדי לבדוק אם ההתקנה של Knative serving היא תוסף GKE, מריצים את הפקודה הבאה:

    gcloud container clusters describe \
    CLUSTER_NAME \
    --region CLUSTER_LOCATION \
    --project PROJECT_ID --format='get(addonsConfig.cloudRunConfig)'

    מחליפים את:

    • CLUSTER_NAME בשם של האשכול.
    • CLUSTER_LOCATION במיקום שבו נמצא האשכול.
    • ‫PROJECT_ID במזהה הפרויקט ב- Google Cloud .

    תוצאות:

    • תוסף GKE לא מותקן:
      • אם התוסף לא הותקן אף פעם, לא יוחזר שום דבר למסוף.
      • אם התוסף הוסר בעבר, מוחזרת ההודעה disabled=true.
    • ‫"GKE add-on" is installed: אם התוסף מותקן באשכול, יוחזרו פרטי ההגדרה של התוסף. דוגמה: loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL
    דוגמה:
    בדוגמה הבאה, Knative serving הותקן באשכול my-addon-cluster באמצעות התוסף של GKE, שמוגדר לטפל בתנועה חיצונית:
    gcloud container clusters describe my-addon-cluster \
    --region us-central1-c --project my-gcp-project \
    --format='get(addonsConfig.cloudRunConfig)'

    תשובה:

    loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL

הגדרת המשאב המותאם אישית של CloudRun

כדי להגדיר את ההתקנה, צריך ליצור ולהגדיר באופן ידני את המשאב המותאם אישית CloudRun.

כדי ליצור באופן ידני משאב מותאם אישית של CloudRun לאשכולות GKE ב- Google Cloud:
  1. יוצרים קובץ YAML וכוללים את הגדרת ברירת המחדל, לדוגמה cloudrunanthos.yaml:

    apiVersion: operator.run.cloud.google.com/v1alpha1
    kind: CloudRun
    metadata:
      name: cloud-run
    
  2. ב-cloudrunanthos.yaml, מתאימים אישית את ההתקנה על ידי הגדרה של אחד או יותר מהמאפיינים הבאים בקטע spec:

    • אשכולות פרטיים: כדי להתקין את Knative serving באשכולות פרטיים ב- Google Cloud, צריך להוסיף את קבוצת המאפיינים clusterConfig ו-isPrivate.

      המאפיינים clusterConfig ו-isPrivate:

      spec:
        clusterConfig:
          isPrivate: true
      

      שימו לב שההגדרה הזו משביתה את Managed TLS, כי אשכולות פרטיים לא יכולים לתקשר עם רשות האישורים כברירת מחדל.

    • מדדים: מוסיפים את קבוצת המאפיינים metricscollector כדי להגדיר את Cloud Monitoring. כברירת מחדל, המדדים מופעלים באשכולות של GKE Enterprise ב-Google Cloud.

      spec:
        metricscollector:
          stackdriver:
            projectid: PROJECT_ID
            gcpzone: CLUSTER_LOCATION
            clustername: CLUSTER_NAME
            secretname: SECRET_NAME
            secretkey: SECRET_KEY
      

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫PROJECT_ID במזהה הפרויקט ב- Google Cloud.
      • CLUSTER_LOCATION באזור או בתחום שבהם נמצא האשכול.
      • ‫CLUSTER_NAME במזהה של האשכול או במזהה המלא של האשכול.
      • ‫SECRET_NAME בשם של הסוד של חשבון השירות של מרחב השמות knative-serving.
      • ‫SECRET_KEY במפתח של הסוד לחשבון השירות של מרחב השמות knative-serving. לדוגמה: key.json

        למידע נוסף על חשבונות שירות:

דוגמה

בדוגמה הזו של המשאב בהתאמה אישית CloudRun, פרטי ההגדרה של Cloud Monitoring מצוינים כדי להשתמש בסוד my-gcp-logging-secret ובמפתח key.json:

 apiVersion: operator.run.cloud.google.com/v1alpha1
 kind: CloudRun
 metadata:
   name: cloud-run
 spec:
   metricscollector:
     stackdriver:
       projectid: my-gcp-project-id
       gcpzone: us-central1-c
       clustername: my-anthos-cluster-name
       secretname: my-gcp-logging-secret
       secretkey: key.json
 ```

הפעלה והתקנה של Knative serving

מפעילים את רכיב ה-Knative serving ב-fleet של GKE Enterprise ואז פורסים את המשאב המותאם אישית של CloudRun:

  1. מפעילים את Knative serving בצי:

    gcloud container fleet cloudrun enable --project=PROJECT_ID
    

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

    לפרטים ולאפשרויות נוספות, קראו את המאמר gcloud container fleet cloudrun enable.

  2. אופציונלי: מוודאים שרכיב התכונה של Knative serving מופעל:

    המסוף

    בודקים אם רכיב ה-Knative serving מוגדר כ-Enabled במסוףGoogle Cloud :

    מעבר אל "ניהול תכונות"

    שורת הפקודה

    כדי לראות אם המצב של appdevexperience הוא ACTIVE:

    gcloud container fleet features list  --project=PROJECT_ID
    

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

    לפרטים ולאפשרויות נוספות, עיינו במאמר העזר רשימת התכונות של gcloud container fleet.

    תוצאה:

    NAME               STATE
    appdevexperience   ACTIVE
    
  3. בכל אשכול GKE Enterprise שבו רוצים להתקין את Knative serving, צריך לפרוס את המשאב המותאם אישית CloudRun:

    gcloud

    gcloud container fleet cloudrun apply --gke-cluster=CLUSTER_LOCATION/CLUSTER_NAME --config=CONFIG_FILE
    

    מחליפים את מה שכתוב בשדות הבאים:

    • CLUSTER_LOCATION באזור או בתחום שבהם נמצא האשכול.
    • ‫CLUSTER_NAME במזהה של האשכול או במזהה המלא של האשכול.
    • ‫CONFIG_FILE עם הנתיב היחסי של שם הקובץ למשאב בהתאמה אישית של cloudRun. דוגמה cloudrunanthos.yaml.

    לפרטים ולאפשרויות נוספות, קראו את המאמר gcloud container fleet cloudrun apply.

    kubectl

    kubectl apply --kubeconfig=KUBECONFIG --filename CONFIG_FILE
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫KUBECONFIG בנתיב המוחלט לקובץ התצורה של kubectl.
    • ‫CONFIG_FILE בשם הקובץ ובנתיב היחסי למשאב בהתאמה אישית של cloudRun. דוגמה cloudrunanthos.yaml.

    לפרטים ולאפשרויות נוספות, עיינו במאמר העזר בנושא kubectl apply.

  4. מוודאים שההצגה של Knative הופעלה באשכול:
    1. פותחים את מסוף Google Cloud :

      כניסה לאשכולות GKE

    2. לוחצים על שם האשכול כדי לפתוח את חלונית הפרטים.

    3. מריצים את הפקודה הזו כדי לבדוק אם אפשר לראות את פרטי הגרסה של Knative serving: kubectl get all -n knative-serving -o 'go-template={{index .metadata.labels "serving.knative.dev/release"}}'
    4. מוודאים שכל הפריסות הספציפיות של Knative serving פועלות במרחבי השמות knative-serving ו-appdevexperience.

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

הגדרת ההתקנה של Knative serving.