בדף הזה מוסבר איך ליצור אשכול אזורי רגיל ב-Google Kubernetes Engine (GKE), כשהתכונות שמוגדרות כברירת מחדל מופעלות. באשכולות של תחום מוגדר יש מכונה אחת של מישור הבקרה בתחום אחד. בהתאם לדרישות הזמינות שלכם, אתם יכולים לבחור אם לפזר את הצמתים של האשכול ברמת האזור באזור אחד או בכמה אזורים.
הדף הזה מיועד למפעילים, לאדריכלי ענן ולמפתחים שצריכים ליצור ולהגדיר אשכולות, ולפרוס עומסי עבודה ב-GKE. במאמר תפקידים ומשימות נפוצים של משתמשי GKE תוכלו לקרוא מידע נוסף על תפקידים נפוצים ומשימות לדוגמה שאנחנו מתייחסים אליהם בתוכן של Google Cloud.
לפני שאתם קוראים את הדף הזה, ודאו שאתם מכירים את אפשרויות ההגדרה של האשכול.
לפני שמתחילים
לפני שמתחילים, חשוב לוודא שביצעתם את המשימות הבאות:
- מפעילים את Google Kubernetes Engine API. הפעלת Google Kubernetes Engine API
- כדי להשתמש ב-Google Cloud CLI למשימה הזו, מתקינים ואז מאתחלים את ה-CLI של gcloud. אם כבר התקנתם את ה-CLI של gcloud, הריצו את הפקודה
gcloud components updateכדי לקבל את הגרסה העדכנית. יכול להיות שגרסאות קודמות של ה-CLI של gcloud לא תומכות בהרצת הפקודות שבמסמך הזה.
- מוודאים שיש לכם את ההרשאות המתאימות ליצירת אשכולות. לכל הפחות, צריך להיות לכם תפקיד אדמין של אשכול Kubernetes Engine.
- אם רוצים לרשום את האשכול החדש לצי, צריך לוודא שיש את ממשקי ה-API וההרשאות הנדרשים.
הגדרת חשבונות שירות של IAM ל-GKE
כדי להריץ משימות מערכת כמו רישום ביומן ומעקב, GKE משתמש בחשבונות שירות של IAM שמקושרים לצמתים. לכל הפחות, חשבונות השירות של הצמתים האלה צריכים לקבל את התפקיד חשבון השירות של צומת ברירת המחדל של Kubernetes Engine (roles/container.defaultNodeServiceAccount) בפרויקט. כברירת מחדל, GKE משתמש בחשבון השירות שמוגדר כברירת מחדל ב-Compute Engine, שנוצר באופן אוטומטי בפרויקט, כחשבון השירות של הצומת.
כדי להקצות את התפקיד roles/container.defaultNodeServiceAccount לחשבון השירות שמוגדר כברירת המחדל של Compute Engine:
המסוף
- נכנסים לדף Welcome:
- בשדה Project number, לוחצים על Copy to clipboard.
- נכנסים לדף IAM:
- לוחצים על Grant access.
- בשדה New principals, מציינים את הערך הבא:
מחליפים את הערךPROJECT_NUMBER-compute@PROJECT_NUMBERבמספר הפרויקט שהעתקתם. - בתפריט Select a role, בוחרים את התפקיד Kubernetes Engine Default Node Service Account.
- לוחצים על Save.
gcloud
- מאתרים את מספר הפרויקט ב- Google Cloud :
gcloud projects describe PROJECT_ID \ --format="value(projectNumber)"
מחליפים את
PROJECT_IDבמזהה הפרויקט.הפלט אמור להיראות כך:
12345678901
- מקצים את התפקיד
roles/container.defaultNodeServiceAccountלחשבון השירות שמוגדר כברירת מחדל ב-Compute Engine:gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:PROJECT_NUMBER-compute@" \ --role="roles/container.defaultNodeServiceAccount"
מחליפים את
PROJECT_NUMBERבמספר הפרויקט מהשלב הקודם.
יצירת אשכול אזורי
המידע המינימלי שצריך לציין כשיוצרים אשכול אזורי חדש הוא שם, פרויקט (בדרך כלל הפרויקט הנוכחי) ואזור (בדרך כלל מיקום ברירת המחדל של כלי שורת הפקודה), תוך שימוש בהגדרות ברירת המחדל לכל שאר הערכים. עם זאת, יש עוד הגדרות אפשריות, שרק חלק מהן מתוארות בקטע הזה, וחלק מהן אי אפשר לשנות אחרי שיוצרים את האשכול. חשוב להבין אילו הגדרות אי אפשר לשנות אחרי שיוצרים את האשכול, ולבחור את ההגדרה הנכונה כשיוצרים אשכול כדי שלא תצטרכו ליצור אותו מחדש.
סקירה כללית של אפשרויות ההגדרה של אשכולות מופיעה במאמר מידע על אפשרויות ההגדרה של אשכולות, ורשימה מלאה של האפשרויות האפשריות מופיעה במדריכי העזר של gcloud container clusters create ו-Terraform google_container_cluster.
אפשר ליצור אשכול אזורי באמצעות ה-CLI של gcloud, מסוףGoogle Cloud או Terraform.
אם אתם מפתחים אפליקציות GKE באמצעות Cloud Code ל-VS Code, נסו ליצור אשכולות באמצעות Cloud Code.
gcloud
כדי ליצור אשכול אזורי באמצעות ה-CLI של gcloud, משתמשים באחת מהפקודות הבאות.
מחליפים את מה שכתוב בשדות הבאים:
-
CLUSTER_NAME: השם של האשכול החדש. -
CHANNEL: סוג ערוץ ההפצה, שיכול להיות אחד מהבאים:rapid,regular,stableאוNone(הוצא משימוש). כברירת מחדל, האשכול רשום לערוץ ההפצהregular. -
CONTROL_PLANE_LOCATION: האזור ב-Compute Engine של מישור הבקרה של האשכול. -
VERSION: הגרסה שרוצים לציין לאשכול. -
COMPUTE_ZONE,COMPUTE_ZONE1,[...]: האזורים שבהם נוצרים הצמתים. אפשר לציין כמה אזורים שרוצים לאשכול. כל האזורים צריכים להיות באותו אזור שבו נמצא מישור הבקרה של האשכול, שצוין בדגל--location. באשכולות אזוריים,--node-locationsחייב להכיל את האזור הראשי של האשכול.
מומלץ מאוד לציין חשבון שירות IAM עם הרשאות מינימליות שהצמתים יוכלו להשתמש בו במקום בחשבון השירות שמוגדר כברירת מחדל של Compute Engine. במאמר שימוש בחשבון שירות עם הרשאות מינימליות מוסבר איך יוצרים חשבון שירות עם הרשאות מינימליות.
כדי לציין חשבון שירות בהתאמה אישית ב-CLI של gcloud, מוסיפים את הדגל הבא לפקודה:
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.מחליפים את SERVICE_ACCOUNT_NAME בשם של חשבון השירות עם ההרשאות המינימליות.
שימוש בערוץ הפצה ספציפי:
כדי ליצור אשכול חדש באמצעות ערוץ הפצה ספציפי, מריצים את הפקודה הבאה:
gcloud container clusters create CLUSTER_NAME \
--release-channel CHANNEL \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE,COMPUTE_ZONE1
שימוש בגרסה ספציפית:
כדי ליצור אשכול חדש באמצעות גרסת אשכול ספציפית, מריצים את הפקודה הבאה:
gcloud container clusters create CLUSTER_NAME \
--cluster-version VERSION \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE,COMPUTE_ZONE1
דוגמה
הפקודה הבאה יוצרת אשכול מרובה-אזורים בשם example-cluster, שבו מישור הבקרה של האשכול נמצא באזור us-east4-a, ויש שלושה מיקומי צמתים. האשכול רשום לערוץ ההפצה regular.
אם משמיטים את הדגל --num-nodes, מספר ברירת המחדל של הצמתים לכל אזור שנוצרים על ידי האשכול הוא שלושה. מכיוון שצוינו שלושה אזורים, הפקודה הזו יוצרת אשכול של תשעה צמתים, עם שלושה צמתים בכל אחד מהאזורים us-east4-a, us-east4-b ו-us-east4-c. בגרסה 1.37.1-gke.1153000 של GKE ואילך, אפשר להגדיר את הדגל --num-nodes לערך 0 כדי ליצור אשכול עם אפס צמתים.
gcloud container clusters create example-cluster \
--location us-east4-a \
--node-locations us-east4-a,us-east4-b,us-east4-c
המסוף
כדי ליצור אשכול אזורי באמצעות מסוף Google Cloud , מבצעים את הפעולות הבאות:
נכנסים לדף Create a Kubernetes cluster במסוף Google Cloud .
בקטע Cluster basics, מבצעים את הפעולות הבאות:
- מזינים את השם (Name) של האשכול.
- בשדה Location type, בוחרים באפשרות Zonal ואז בוחרים את האזור של האשכול.
- אם אתם יוצרים אשכול בכמה אזורים, סמנו את התיבה Specify default node locations ובחרו אזורים נוספים שבהם אתם רוצים להריץ את מאגרי הצמתים.
בוחרים ערוץ הפצה. אפשר גם לבחור באפשרות No channel, אבל היא הוצאה משימוש ותוסר. למידע נוסף, קראו את המאמר אשכולות שלא רשומים לערוץ הפצה.
אופציונלי: מציינים גרסה של מישור הבקרה מהרשימה הנפתחת Version.
אופציונלי: קובעים הגדרות אחרות לאשכול החדש.
אופציונלי: אם רוצים לרשום את האשכול החדש לצי, עוברים לקטע Advanced settings ופועלים לפי ההוראות במסוף בקטע Create and register a new cluster כדי להשלים את רישום האשכול. Google Cloud
כדי ליצור ולהגדיר מאגרי צמתים משלכם:
- לוחצים על הוספת מאגר צמתים.
- בתיבת הדו-שיח נדרשים שינויים, לוחצים על ביצוע שינויים.
בתפריט הניווט מופיע מאגר צמתים בשם
default-pool.אופציונלי: כדי ליצור אשכול בלי מאגרי צמתים, מבצעים את השלבים הבאים:
- בתפריט הניווט, לוחצים על default-pool.
- לוחצים על הסרת מאגר צמתים.
- מגדירים את שאר ההגדרות של האשכול ולוחצים על Create.
אופציונלי: כדי להוסיף מאגרי צמתים לאשכול, לוחצים על Add node pool. בתפריט הניווט מופיע מאגר צמתים חדש.
קביעת הגדרות בסיסיות למאגר צמתים:
- בתפריט הניווט, בקטע Node pools, לוחצים על השם של מאגר הצמתים. נפתח הדף פרטי מאגר הצמתים המנוהל על ידי המשתמש.
- בשדה Name, מזינים שם למאגר הצמתים.
- בקטע Size, בשדה Number of nodes מציינים את מספר הצמתים שרוצים ליצור. צריכה להיות לכם מכסת משאבים זמינה לצמתים ולמשאבים שלהם (כמו נתיבים של חומת אש). בגרסה 1.37.1-gke.1153000 של GKE ואילך, אפשר ליצור מאגר צמתים ריק על ידי ציון הערך
0.
קובעים את ההגדרות של המכונות הווירטואליות שמריצות את הצמתים:
- בתפריט הניווט, בקטע המורחב של מאגר הצמתים שנבחר, לוחצים על Nodes.
- ברשימה הנפתחת Image type, בוחרים באפשרות node image.
- בוחרים את Machine configuration שיוגדר כברירת המחדל של המכונות. כל סוג מכונה מחויב באופן שונה. סוג המכונה שמוגדר כברירת מחדל הוא
e2-medium. למידע על מחירי סוגי המכונות, אפשר לעיין בגיליון המחירים של סוגי המכונות. - ברשימה הנפתחת Boot disk type, בוחרים את סוג הדיסק.
- בשדה Boot disk size, מציינים את גודל דיסק האתחול ב-GB.
קובעים את הגדרות האבטחה של מאגר הצמתים:
- בתפריט הניווט, בקטע המורחב של מאגר הצמתים שנבחר, לוחצים על Security.
- אופציונלי: מציינים חשבון שירות מותאם אישית של IAM לצמתים:
- בדף הגדרות מתקדמות, מרחיבים את הקטע אבטחה.
- בתפריט Service account, בוחרים את חשבון השירות הרצוי.
מומלץ מאוד לציין חשבון שירות IAM עם הרשאות מינימליות שהצמתים יוכלו להשתמש בו במקום בחשבון השירות שמוגדר כברירת מחדל של Compute Engine. במאמר שימוש בחשבון שירות עם הרשאות מינימליות מוסבר איך יוצרים חשבון שירות עם הרשאות מינימליות.
לוחצים על יצירה.
Terraform
כדי ליצור אשכול אזורי עם מאגר צמתים של אזור יחיד באמצעות Terraform, תוכלו להיעזר בדוגמה הבאה:
כדי ליצור אשכול אזורי עם מאגר של צמתים בכמה אזורים באמצעות Terraform, תוכלו להיעזר בדוגמה הבאה:
מידע נוסף על השימוש ב-Terraform זמין במאמר תמיכה של Terraform ב-GKE.
אינטראקציה עם אשכול באמצעות kubectl
אחרי שיוצרים אשכול, צריך להגדיר את kubectl כדי שתוכלו לבצע פעולות באשכול משורת הפקודה.
יצירת אשכול אזורי ללא צמתים
ב-GKE מגרסה 1.37.1-gke.1153000 ואילך, אפשר ליצור אשכול אזורי עם אפס צמתים באחת מהדרכים הבאות:
- Skip creating the default node pool: GKE לא מוסיף מאגרי צמתים לאשכול. אם אתם מתכננים להריץ עומסי עבודה באמצעות Autopilot ComputeClasses, יצירה אוטומטית של מאגרי צמתים או מאגרי צמתים בהתאמה אישית שתיצרו בהמשך, השתמשו באפשרות הזו.
- יצירת מאגר צמתים ריק: GKE יוצר מאגר צמתים ללא צמתים. אם רוצים להתאים אישית את ההגדרות של מאגר הצמתים במהלך יצירת האשכול בלי ליצור את הצמתים עצמם, משתמשים באפשרות הזו.
כשיוצרים אשכול ללא צמתים, הפודים של המערכת נשארים במצב Unschedulable עד שנוצר לפחות צומת אחד באשכול. כדי ליצור אשכול אזורי בלי צמתים, בוחרים באחת מהאפשרויות הבאות:
gcloud
כדי לדלג על יצירת מאגר ברירת המחדל של הצמתים, משתמשים רק בדגל
--num-nodes=0בפקודהgcloud container clusters create:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0מחליפים את מה שכתוב בשדות הבאים:
-
CLUSTER_NAME: השם של אשכול האזורים החדש. -
CONTROL_PLANE_LOCATION: האזור ב-Compute Engine של מישור הבקרה של האשכול, למשלus-central1-a.
אם תציינו דגלים אחרים להגדרת מאגר הצמתים, כמו הדגלים
--machine-type,--disk-typeאו--disk-size, הפקודה תיכשל כי אין מאגר צמתים ש-GKE יכול להגדיר.-
כדי ליצור אשכול עם מאגר צמתים ריק, משתמשים בדגל
--num-nodes=0ובדגל--node-pool-nameבפקודהgcloud container clusters create:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0 \ --node-pool-name=NODEPOOL_NAMEמחליפים את
NODEPOOL_NAMEבשם של מאגר הצמתים הריק. אפשר לציין דגלים אחרים של הגדרת צומת כדי להתאים אישית את הצמתים במאגר הצמתים הריק.
המסוף
נכנסים לדף Create a Kubernetes cluster במסוף Google Cloud .
נותנים שם לאשכול.
בקטע Location type, בוחרים באפשרות Zonal.
ברשימה הנפתחת Zone, בוחרים אזור למישור הבקרה של האשכול.
מדלגים על יצירת מאגר הצמתים שמוגדר כברירת מחדל או יוצרים מאגר צמתים ריק:
כדי לדלג על יצירת מאגר הצמתים שמוגדר כברירת מחדל, בקטע Default mode מוודאים שהאפשרות Autopilot מסומנת. לחלופין, אפשר להפעיל את היצירה של מאגר הצמתים שמוגדר כברירת מחדל ואז להסיר אותו:
- לוחצים על Add node pool.
- בתיבת הדו-שיח נדרשים שינויים, לוחצים על ביצוע שינויים.
מופיע מאגר צמתים בשם
default-pool. - בתפריט הניווט, לוחצים על default-pool.
- לוחצים על הסרת מאגר צמתים.
השלבים האלה יוצרים אשכול שאין בו מאגרי צמתים, ומשתמשים במצב Autopilot כדי להריץ עומסי עבודה שלא בוחרים ComputeClass. אתם יכולים גם למנוע את השימוש במצב אוטומטי על ידי בחירה באפשרות מאגר צמתים בניהול המשתמש בקטע מצב ברירת מחדל.
כדי ליצור מאגר צמתים ריק:
- לוחצים על הוספת מאגר צמתים.
- בתיבת הדו-שיח נדרשים שינויים, לוחצים על ביצוע שינויים.
מופיע מאגר צמתים בשם
default-pool. - בתפריט הניווט, לוחצים על default-pool.
- בשדה Number of nodes, מציינים את הערך
0.
מגדירים את שאר ההגדרות של האשכול ולוחצים על Create.
Terraform
- כדי לדלג על יצירת מאגר ברירת המחדל של הצמתים, במשאב
google_container_clusterמגדירים את השדהinitial_node_countלערך0. כדי ליצור מאגר צמתים ראשוני ריק, בצע את הפעולות הבאות:
- במשאב
google_container_cluster, מגדירים את השדהinitial_node_countלערך0. - מוסיפים משאב מסוג
google_container_node_poolומגדירים את השדהnode_countלערך0.
- במשאב
אחרי שיוצרים אשכול ללא צמתים, אפשר להקצות צמתים בדרכים הבאות:
- להגדיר אשכולות רגילים כך שישתמשו במצב Autopilot כברירת מחדל או להריץ עומסי עבודה ספציפיים במצב Autopilot.
- משתמשים ב-ComputeClasses כדי ליצור באופן אוטומטי צמתים לעומסי עבודה נכנסים.
- מוסיפים מאגר צמתים באופן ידני או משנים את הגודל של מאגר צמתים ריק קיים.
תבניות של אשכולות
בעבר, GKE תמך בתבניות לאשכולות. התבניות האלה הוסרו ממסוף Google Cloud , אבל עדיין אפשר לגשת אליהן דרך הקישורים הבאים:
המאמרים הבאים
- מידע על אפשרויות ההגדרה של אשכולות שאתם יכולים ליצור.
- מידע על הארכיטקטורה של אשכול GKE
- מידע ולמידה על ניהול האשכולות
- איך מוחקים אשכולות