התקנה באמצעות התוסף של 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 לא תומכות בהרצת הפקודות שבמסמך הזה.
בוחרים או יוצרים Google Cloud פרויקט כדי להתקין בו את Config Connector.
אם בעבר התקנתם את Config Connector באופן ידני, צריך להסיר אותו לפני שמתקינים את Config Connector כתוסף:
התקנת התוסף Config Connector
כדי להשתמש בתוסף Config Connector, צריך ליצור אשכול GKE חדש או להפעיל אותו באשכול קיים. אחרי שמתקינים את Config Connector, מגדירים את ההתקנה שלו באמצעות חשבונות השירות של Google ומרחבי השמות.
דרישות
אלה הדרישות של התוסף Config Connector:
צריך להשתמש בגרסת GKE הבאה:
- 1.15.11-gke.5 ואילך
- 1.16.8-gke.8 ואילך
- 1.17.4-gke.5 ואילך
אתם צריכים להפעיל מאגר זהויות של עומסי עבודה וניטור של Kubernetes Engine באשכולות שבהם אתם מפעילים את 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 :
נכנסים לדף Create a Kubernetes cluster במסוף Google Cloud .
בקטע Cluster basics, מציינים את השם (Name) ואת המיקום של האשכול.
בחלונית הניווט, לוחצים על הגדרות מתקדמות.
בשורה Workload identity, לוחצים על edit Edit configuration, מסמנים את התיבה Enable Workload Identity ולוחצים על Save.
בשורה Config Connector, מסמנים את התיבה Quick enable.
אופציונלי: מגדירים את שאר האשכול לפי הצורך.
לוחצים על יצירה.
אחרי שיוצרים את האשכול, עוברים לקטע יצירת זהות.
הפעלת התוסף 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
נכנסים לתפריט של Google Kubernetes Engine במסוף Google Cloud .
בוחרים את האשכול שבו רוצים להתקין את Config Connector. מופיע הדף Cluster Details.
בקטע Features, מאתרים את השורה Config Connector ולוחצים על Edit.
מסמנים את התיבה Enable Config Connector ולוחצים על Save Changes כדי לעדכן את האשכול.
יצירת זהות
כדי ליצור ולנהל משאבי Google Cloud , Config Connector מבצע אימות באמצעות חשבון שירות של ניהול זהויות והרשאות גישה (IAM) ומשתמש באיחוד זהויות של עומסי עבודה ל-GKE כדי לקשר בין חשבונות שירות של IAM לחשבונות שירות של Kubernetes.
Config Connector לא מנהל משאבים עד שמגדירים מצב מרחב שמות או מצב אשכול. ברוב המקרים, כדאי להשתמש במצב מרחב שמות. פועלים לפי השלבים של המצב שבחרתם:
- כדי להשתמש במצב מרחב שמות, דלגו על הקטע הזה ועל הקטע הגדרת Config Connector. התוסף כבר התקין את האופרטור ויצר אובייקט
ConfigConnectorבמצב מרחב שמות. לכל מרחב שמות, מבצעים את השלבים שמפורטים בקטע התקנת Config Connector במצב מרחב שמות, ואז חוזרים לקטע ציון המיקום ליצירת המשאבים. - כדי להשתמש במצב אשכול, צריך לבצע את השלבים שבקטע הזה ובקטע הגדרת Config Connector. צריך לבצע את השלבים האלה רק פעם אחת לכל אשכול.
כדי ליצור את הזהות:
יוצרים חשבון שירות ב-IAM. אם אתם רוצים להשתמש בחשבון שירות קיים, אתם יכולים להשתמש בו ולדלג על השלב הזה:
gcloud iam service-accounts create SERVICE_ACCOUNT_NAMEמחליפים את SERVICE_ACCOUNT_NAME בשם שרוצים לתת לחשבון השירות.
נותנים לחשבון השירות ב-IAM הרשאות מורחבות בפרויקט:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" \ --role="roles/editor"מחליפים את PROJECT_ID במזהה הפרויקט.
יוצרים קישור של מדיניות 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 באשכול.
כדי להגדיר את האופרטור כמצב אשכול, מבצעים את השלבים הבאים:
-
מעתיקים את קובץ ה-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במזהה הפרויקט.
-
-
מחילים את ההגדרות על האשכול באמצעות
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:
האשכול משודרג לגרסה משנית חדשה של GKE שממופה לגרסה חדשה יותר של Config Connector.
האשכול נמצא בגרסה משנית של 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, מבצעים את השלבים הבאים:
משתמשים ב-
kubectl deleteכדי להסיר את ה-CRD של Config Connector יחד עם רכיבי הבקר:kubectl delete ConfigConnector configconnector.core.cnrm.cloud.google.com --wait=trueמשביתים את התוסף 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 :
נכנסים לדף Google Kubernetes Engine Clusters במסוף Google Cloud ובוחרים את האשכול שרוצים לעדכן.
לוחצים על Edit. מופיע המסך Edit clusters.
לוחצים על תוספים.
בוחרים באפשרות Config Connector ואז באפשרות Disabled.
לוחצים על Save כדי לעדכן את האשכול.
המאמרים הבאים
- תחילת העבודה עם Config Connector.
- איך פותרים בעיות ב-Config Connector