התקנה באמצעות התוסף של GKE

בדף הזה מוסבר איך להתקין את Config Connector באשכול Google Kubernetes Engine ‏(GKE) באמצעות התוסף של GKE.

במאמר בחירת סוג התקנה מפורטים היתרונות והחסרונות של כל אחת מאפשרויות ההתקנה.

צריך להתקין את Config Connector באופן ידני במקום להשתמש בתוסף. התוסף קשור לגרסה המשנית של GKE באשכול, ויכול להיות שהוא לא יתעדכן לגרסאות האחרונות של Config Connector במשך 12 חודשים או יותר. אם אתם כבר משתמשים בתוסף, אתם יכולים לעבור להתקנה ידנית.

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

לפני שמתחילים, חשוב לוודא שביצעתם את המשימות הבאות:

  • מפעילים את Google Kubernetes Engine API.
  • הפעלת Google Kubernetes Engine API
  • כדי להשתמש ב-Google Cloud CLI למשימה הזו, מתקינים ואז מאתחלים את ה-CLI של gcloud. אם כבר התקנתם את ה-CLI של gcloud, הריצו את הפקודה gcloud components update כדי לקבל את הגרסה העדכנית. יכול להיות שגרסאות קודמות של ה-CLI של gcloud לא תומכות בהרצת הפקודות שבמסמך הזה.

התקנת התוסף Config Connector

כדי להשתמש בתוסף Config Connector, צריך ליצור אשכול GKE חדש או להפעיל אותו באשכול קיים. אחרי שמתקינים את Config Connector, מגדירים את ההתקנה שלו באמצעות חשבונות השירות של Google ומרחבי השמות.

דרישות

אלה הדרישות של התוסף Config Connector:

הגדרת אשכול GKE

אפשר להשתמש בתוסף Config Connector באשכול חדש או קיים.

יצירת אשכול חדש כשהתוסף Config Connector מופעל

אפשר ליצור אשכול GKE באמצעות ה-CLI של gcloud או מסוףGoogle Cloud .

gcloud

כדי ליצור אשכול באמצעות Google Cloud CLI, מריצים את הפקודה הבאה:

gcloud container clusters create CLUSTER_NAME \
    --release-channel CHANNEL \
    --addons ConfigConnector \
    --workload-pool=PROJECT_ID.svc.id.goog \
    --logging=SYSTEM \
    --monitoring=SYSTEM

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

  • CLUSTER_NAME בשם של אשכול ה-GKE.
  • CHANNEL עם ערוץ הפצה של GKE, יש תמיכה ב-rapid וב-regular.
  • ‫PROJECT_ID במזהה הפרויקט ב- Google Cloud .

מסוף Google Cloud

כדי ליצור אשכול באמצעות מסוף Google Cloud :

  1. נכנסים לדף Create a Kubernetes cluster במסוף Google Cloud .

    מעבר לדף Create a Kubernetes cluster

  2. בקטע Cluster basics, מציינים את השם (Name) ואת המיקום של האשכול.

  3. בחלונית הניווט, לוחצים על הגדרות מתקדמות.

  4. בשורה Workload identity, לוחצים על Edit configuration, מסמנים את התיבה Enable Workload Identity ולוחצים על Save.

  5. בשורה Config Connector, מסמנים את התיבה Quick enable.

  6. אופציונלי: מגדירים את שאר האשכול לפי הצורך.

  7. לוחצים על יצירה.

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

הפעלת התוסף Config Connector באשכול קיים

אפשר להפעיל את התוסף Config Connector באשכול GKE קיים באמצעות gcloud או מסוף Google Cloud .

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

כדי להפעיל את התוסף Config Connector באשכול קיים, צריך לעמוד בדרישות המוקדמות הבאות:

  • אתם צריכים אשכול שעומד בדרישות של התוסף Config Connector.
  • מגדירים את איחוד הזהויות של עומסי עבודה ל-GKE באשכול שבו רוצים להתקין את Config Connector.

כדי להפעיל את איחוד הזהויות של עומסי עבודה ל-GKE במאגר צמתים, משתמשים בכלי שורת הפקודה gcloud:

gcloud container node-pools update NODE_POOL \
    --workload-metadata=GKE_METADATA \
    --cluster CLUSTER_NAME

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

  • NODE_POOL בשם של מאגר הצמתים
  • ‫CLUSTER_NAME בשם של האשכול
הפעלת התוסף Config Connector

אפשר להפעיל את Config Connector באשכול GKE קיים באמצעות Google Cloud CLI או מסוף Google Cloud .

gcloud

כדי להפעיל את התוסף Config Connector באשכול GKE קיים, משתמשים ב-Google Cloud CLI:

gcloud container clusters update CLUSTER_NAME \
    --update-addons ConfigConnector=ENABLED

מחליפים את CLUSTER_NAME בשם של אשכול ה-GKE.

מסוף Google Cloud

  1. נכנסים לתפריט של Google Kubernetes Engine במסוף Google Cloud .

    כניסה לתפריט של Google Kubernetes Engine

  2. בוחרים את האשכול שבו רוצים להתקין את Config Connector. מופיע הדף Cluster Details.

  3. בקטע Features, מאתרים את השורה Config Connector ולוחצים על Edit.

  4. מסמנים את התיבה Enable Config Connector ולוחצים על Save Changes כדי לעדכן את האשכול.

יצירת זהות

כדי ליצור ולנהל משאבי Google Cloud , Config Connector מבצע אימות באמצעות חשבון שירות של ניהול זהויות והרשאות גישה (IAM) ומשתמש באיחוד זהויות של עומסי עבודה ל-GKE כדי לקשר בין חשבונות שירות של IAM לחשבונות שירות של Kubernetes.

‫Config Connector לא מנהל משאבים עד שמגדירים מצב מרחב שמות או מצב אשכול. ברוב המקרים, כדאי להשתמש במצב מרחב שמות. פועלים לפי השלבים של המצב שבחרתם:

כדי ליצור את הזהות:

  1. יוצרים חשבון שירות ב-IAM. אם אתם רוצים להשתמש בחשבון שירות קיים, אתם יכולים להשתמש בו ולדלג על השלב הזה:

    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME
    

    מחליפים את SERVICE_ACCOUNT_NAME בשם שרוצים לתת לחשבון השירות.

    איך יוצרים ומנהלים חשבונות שירות?

  2. נותנים לחשבון השירות ב-IAM הרשאות מורחבות בפרויקט:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" \
      --role="roles/editor"
    

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

  3. יוצרים קישור של מדיניות IAM בין חשבון השירות ב-IAM לבין חשבון השירות המוגדר מראש ב-Kubernetes שבו פועל Config Connector:

    gcloud iam service-accounts add-iam-policy-binding \
    SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
      --member="serviceAccount:PROJECT_ID.svc.id.goog[cnrm-system/cnrm-controller-manager]" \
      --role="roles/iam.workloadIdentityUser"
    

הגדרת Config Connector

כדי להשלים את ההתקנה, יוצרים קובץ תצורה ל-ConfigConnector CustomResource, ואז מחילים אותו באמצעות הפקודה kubectl apply. ה-Config Connector Operator מתקין את ה-CRD של משאביGoogle Cloud ואת רכיבי Config Connector באשכול.

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

  1. מעתיקים את קובץ ה-YAML הבא לקובץ בשם configconnector.yaml:
    # configconnector.yaml
    apiVersion: core.cnrm.cloud.google.com/v1beta1
    kind: ConfigConnector
    metadata:
      # the name is restricted to ensure that there is only one
      # ConfigConnector resource installed in your cluster
      name: configconnector.core.cnrm.cloud.google.com
    spec:
      mode: cluster
      googleServiceAccount: "SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"
      # Setting `stateIntoSpec` to `Absent` is recommended. It means setting `cnrm.cloud.google.com/state-into-spec`
      # annotation to `absent` for all Config Connector resources created in the cluster in the future.
      # It prevents Config Connector from populating unspecified fields into the spec.
      stateIntoSpec: Absent
    מחליפים את הערכים הבאים:
    • ‫SERVICE_ACCOUNT_NAME בשם של חשבון השירות.
    • ‫PROJECT_ID במזהה הפרויקט.
  2. מחילים את ההגדרות על האשכול באמצעות kubectl apply:
      kubectl apply -f configconnector.yaml

איך מציינים איפה ליצור את המשאבים

בעזרת Config Connector אפשר לארגן משאבים לפי פרויקט, תיקייה או ארגון, בדיוק כמו שמארגנים משאבים ב- Google Cloud.

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

אם אין לכם מרחב שמות למטרה הזו, אתם יכולים ליצור אחד באמצעות kubectl.
kubectl create namespace NAMESPACE

מחליפים את NAMESPACE בשם של מרחב השמות. לדוגמה: config-connector.

בוחרים כרטיסייה כדי לבחור איפה רוצים ש-Config Connector ייצור משאבים.

פרויקט

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

    kubectl annotate namespace \
    NAMESPACE cnrm.cloud.google.com/project-id=PROJECT_ID

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

  • ‫NAMESPACE בשם של מרחב השמות.
  • ‫PROJECT_ID במזהה הפרויקט ב- Google Cloud .

תיקייה

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

    kubectl annotate namespace \
    NAMESPACE cnrm.cloud.google.com/folder-id=FOLDER_ID

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

  • ‫NAMESPACE בשם של מרחב השמות.
  • ‫FOLDER_ID במזהה התיקייה ב- Google Cloud .

ארגון

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

    kubectl annotate namespace \
    NAMESPACE cnrm.cloud.google.com/organization-id=ORGANIZATION_ID

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

  • ‫NAMESPACE בשם של מרחב השמות.
  • ‫ORGANIZATION_ID במזהה הארגון שלכם ( Google Cloud ).

כשמוסיפים הערות למרחב השמות, Config Connector יוצר משאבים בפרויקט, בתיקייה או בארגון התואמים. למידע נוסף על האופן שבו Config Connector משתמש במרחבי שמות של Kubernetes, קראו את המאמר מרחבי שמות של Kubernetes ופרויקטים של Google Cloud .

אימות ההתקנה

כל הרכיבים של Config Connector פועלים במרחב שמות בשם cnrm-system. כדי לוודא שה-Pods מוכנים, מריצים את הפקודה הבאה:

kubectl wait -n cnrm-system \
      --for=condition=Ready pod --all

אם Config Connector מותקן כמו שצריך, הפלט אמור להיראות כך:

pod/cnrm-controller-manager-0 condition met

שדרוג של Config Connector

השדרוגים של התוסף Config Connector באשכול מנוהלים על ידי Google Cloud.

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

קראו על איך Google Cloud מנהל את השדרוגים של תוסף Config Connector, או דלגו אל איך מורידים את הגרסה העדכנית של Config Connector.

איך Google Cloud מנהל את השדרוגים של התוסף Config Connector

גרסת Config Connector שאשכול GKE מקבל תלויה לחלוטין בגרסה המשנית של GKE באשכול. לדוגמה:

גרסה משנית של GKE גרסת Config Connector
1.20 1.69.0
1.21 1.69.0
1.22 1.71.0
1.23 1.82.0
1.24 1.89.0

כשהגרסאות עומדות בדרישות, Google Cloud ממפה מחדש את גרסאות המשנה החדשות ביותר של GKE לגרסה חדשה של Config Connector. הפעולה הזו מתבצעת בכל גרסאות המשנה של GKE שהן חדשות מספיק כדי לא להיות זמינות בערוצי ההפצה "רגיל" או "יציב".

גרסת Config Connector שאשכול מקבל תלויה בגרסה המשנית של GKE באשכול, ולכן יש שני מקרים שבהם התוסף Config Connector של אשכול משודרג באופן אוטומטי על ידי Google Cloud:

  1. האשכול משודרג לגרסה משנית חדשה של GKE שממופה לגרסה חדשה יותר של Config Connector.

  2. האשכול נמצא בגרסה משנית של GKE שהיא חדשה מספיק כדי לא להיות זמינה בערוצי ההפצה הרגילים או היציבים, ו-Google Cloud ממפה מחדש את הגרסה המשנית של GKE לגרסה חדשה של Config Connector.

כש- Google Cloud ממפה מחדש גרסה משנית של GKE ומשדרגת אשכולות קיימים לגרסה חדשה של Config Connector, היא "משיקה גרסה חדשה של Config Connector" לגרסה המשנית הזו של GKE.

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

איך מורידים את הגרסה העדכנית של Config Connector

כדי לוודא שאתם משתמשים בגרסה העדכנית ביותר של Config Connector, מומלץ להתקין ולשדרג את Config Connector באופן ידני. התקנה ידנית מאפשרת לכם לשלוט ישירות בגרסה ולהשתמש בתכונות ובתיקונים החדשים ברגע שהם זמינים.

כדי לעבור מהתוסף Config Connector להתקנה ידנית, פועלים לפי ההוראות למעבר מהתוסף Config Connector להתקנה ידנית.

התוסף קשור לגרסה המשנית של GKE באשכול, והוא יכול להיות בפיגור של 12 חודשים או יותר אחרי הגרסאות העדכניות של Config Connector. למרות ש-Config Controller עדכני יותר מהתוסף, הוא עדיין יכול להיות בפיגור לעומת הגרסה העדכנית ביותר בהשוואה להתקנה ידנית.

הסרת Config Connector

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

  1. משתמשים ב-kubectl delete כדי להסיר את ה-CRD של Config Connector יחד עם רכיבי הבקר:

    kubectl delete ConfigConnector configconnector.core.cnrm.cloud.google.com --wait=true
    
  2. משביתים את התוסף Config Connector באשכול באמצעות ה-CLI של gcloud או מסוף Google Cloud :

    gcloud

    כדי להשבית את התוסף Config Connector באמצעות gcloud, מריצים את הפקודה הבאה:

    gcloud container clusters update CLUSTER_NAME --update-addons ConfigConnector=DISABLED
    

    מחליפים את CLUSTER_NAME בשם של האשכול שבו מותקן התוסף Config Connector.

    מסוף Cloud

    כדי להשבית את התוסף Config Connector באמצעות מסוף Google Cloud :

    1. נכנסים לדף Google Kubernetes Engine Clusters במסוף Google Cloud ובוחרים את האשכול שרוצים לעדכן.

      כניסה לתפריט של Google Kubernetes Engine

    2. לוחצים על Edit. מופיע המסך Edit clusters.

    3. לוחצים על תוספים.

    4. בוחרים באפשרות Config Connector ואז באפשרות Disabled.

    5. לוחצים על Save כדי לעדכן את האשכול.

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