פריסת אפליקציית Kubernetes באמצעות Cloud Code ל-IntelliJ

במאמר הזה מוסבר איך להשתמש ב-Cloud Code ל-IntelliJ כדי לפרוס את אפליקציית Kubernetes הראשונה שלכם.

במדריך הזה תגדירו אפליקציית Kubernetes חדשה באמצעות תבנית התחלתית של Hello World, תפעילו את האפליקציה באשכול, תגדירו בנייה מחדש רציפה כדי לפתח את האפליקציה באופן איטרטיבי, תנפו באגים בקוד הפועל ותצפו ביומנים של האפליקציה בשידור חי.

במדריך הזה אנחנו ממליצים להשתמש ב- Google Cloud , אבל אפשר גם להשתמש ב-Cloud Code עם אשכול מקומי באמצעות כלים כמו minikube ו-Docker Desktop. עם זאת, כדי ליהנות בצורה הטובה ביותר מתכונות כמו יצירה של אשכול GKE בזמן אמת ופריסה רציפה משולבת, מומלץ להשתמש בGoogle Cloud פרויקט.

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

כדי להשלים את המדריך הזה להתחלה מהירה, צריך לבצע את השלבים הבאים, בין אם בחרתם להשתמש באשכול מקומי או באשכול שמתארח בענן:

  1. מתקינים את Git. כדי להעתיק דוגמאות קוד למחשב, צריך להתקין את Git.
  2. מתקינים את Docker. כדי ליצור את הקוד לדוגמה, צריך להשתמש ב-Docker. מוודאים שחשבון המשתמש המקומי יכול ליצור קונטיינרים.
  3. אם עוד לא עשיתם זאת, מתקינים את הפלאגין של Cloud Code.

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

  1. נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Google Kubernetes Engine API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  8. Verify that billing is enabled for your Google Cloud project.

  9. Enable the Google Kubernetes Engine API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    10.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות להשלמת המדריך הזה באמצעות Google Cloud, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד אדמין של Kubernetes Engine (roles/container.admin) בפרויקט. להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

יצירת אפליקציה

‫Cloud Code כולל אוסף של תבניות דוגמת קוד שיעזרו לכם להתחיל. כדי ליצור אפליקציה חדשה באמצעות דוגמה קיימת:

  1. ב-IDE, פותחים את File ‏> New Project (קובץ > פרויקט חדש) ובוחרים באפשרות Cloud Code: Kubernetes.

  2. בוחרים תבנית Hello World מרשימת אפליקציות המתחילים. רשימת התבניות הזמינות: אפליקציות Python, ‏ Go, ‏ NodeJS, ‏ Java hello world וספר אורחים

  3. בוחרים שם לפרויקט.

    אחרי שלוחצים על סיום, Cloud Code משכפל את התבנית שבחרתם ופותח את הפרויקט החדש שיצרתם לשימוש.

    בתבניות Java, מוצגת בקשה לייבא פרויקטים נדרשים של Maven כדי לסנכרן את pom.xml. לוחצים על Add as Maven project (הוספה כפרויקט Maven) ואז על Import Changes (ייבוא שינויים).

בחירת אשכול

כדי לפתח את האפליקציה, תצטרכו אשכול Kubernetes משויך שמתארח באופן מקומי באמצעות minikube או באמצעות פלטפורמת ענן, כמו אשכול Google Kubernetes Engine.

אשכול מקומי

אם עדיין אין לכם אשכול שאפשר להשתמש בו לצורך ההפעלה המהירה הזו, אתם יכולים לבחור להפעיל את האפליקציה עם אשכול minikube מקומי שמנוהל על ידי Cloud Code. ‫Cloud Code מפעיל אשכול minikube כדי להריץ את האפליקציה, ומפסיק את האשכול כשהפריסה מפסיקה. אם אשכול minikube כבר פועל, Cloud Code משתמש מחדש באשכול minikube הקיים לצורך פריסה.

בשלב הבא, פיתוח האפליקציה, תוכלו להגדיר את האפשרות הזו כהעדפת הפריסה כדי להשתמש באשכול minikube שמנוהל על ידי Cloud Code.

אשכול מבוסס-פלטפורמת ענן

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

אם אין לכם, אתם יכולים ליצור אחד באמצעות ההוראות הספציפיות לפלטפורמת הענן שלכם. ב-GKE, פועלים לפי המדריך בנושא יצירת אשכול.

פיתוח האפליקציה

כדי להתחיל לפתח את האפליקציה ב-Kubernetes:

  1. אם אתם מריצים באשכול שמתארח בפלטפורמת ענן, צריך לוודא שהגדרתם איפה מאוחסנים קובצי האימג' של הקונטיינרים עבור Develop on Kubernetes.

    אם אתם מחוברים אל Google Cloud ב-IDE שלכם ומוגדר לכם פרויקט ברירת מחדל, Cloud Code משתמש אוטומטית במאגר קובצי אימג' של קונטיינר ברירת המחדל שלכם (gcr.io/{project_id} כאשר {project_id} הוא הפרויקט שמוגדר כברירת מחדל).

  2. מוודאים שההקשר המועדף של Kubernetes מוגדר. אפשר לציין את זה בהגדרה של Develop on Kubernetes (אפשר לגשת אליה דרך Run (הפעלה) > Edit Configurations (עריכת הגדרות) > Develop on Kubernetes (פיתוח ב-Kubernetes)), בכרטיסייה Run (הפעלה) ובקטע Deployment preferences (העדפות פריסה).

    אפשר לבחור לפרוס בהקשר הנוכחי (ברירת מחדל), באופן מקומי באשכול minikube או בהקשר זמין אחר.

    כברירת מחדל, אפליקציית Kubernetes תפעל במצב על פי דרישה עם האפשרות על פי דרישה שנבחרה. אם רוצים, אפשר לבחור באפשרות בשמירת הקובץ.

  3. בסרגל הניווט, בוחרים את יעד ההרצה Develop on Kubernetes (פיתוח ב-Kubernetes) מתוך בורר ההגדרות של Run/Debug (הרצה/ניפוי באגים).

    הגדרות הפעלה של פריסת Kubernetes

    כך מובטח שכל שינוי בקוד ייבנה, יידחף וייפרס אוטומטית לגרסה חדשה של האפליקציה.

  4. כדי להתחיל את מחזור הפיתוח באשכול Kubernetes, לוחצים על הפעולה run (הפעלה) לצד Develop on Kubernetes (פיתוח ב-Kubernetes).

  5. בחלון הפלט, בכרטיסייה Logs (יומנים), אפשר לראות יומנים של אפליקציות נכנסות.

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

  6. כשהפריסה מסתיימת בהצלחה, מקבלים הודעה שכתובות URL חדשות של שירותים זמינות. לוחצים על הכרטיסייה כתובות URL של שירותים כדי לראות את כתובות ה-URL, ואז לוחצים על הקישור של כתובת ה-URL כדי לפתוח את הדפדפן עם האפליקציה הפועלת.

    הצגת שירותים שהועברו דרך העברת פורטים בכרטיסייה Service URLs (כתובות URL של שירותים)

    אפשר גם לפתוח את יומן האירועים ואז ללחוץ על הקישור כדי לפתוח את הדפדפן עם האפליקציה הפועלת.

    בחלונית Deployed Resources (משאבים שפרסתם) מוצג מה שפרסתם במהלך סשן הפיתוח.

ניפוי באגים באפליקציה

‫Cloud Code תומך בהחלת שינויים במהלך ניפוי הבאגים.

כדי לנפות באגים באפליקציה:

  1. כדי להתחיל את מחזור הפיתוח במצב ניפוי באגים באשכול Kubernetes, לוחצים על פעולת ניפוי הבאגים סמל פעולת ניפוי באגים בשביל פיתוח ב-Kubernetes.

    התחלת מחזור הפיתוח של אשכול Kubernetes במצב ניפוי באגים

  2. ‫Cloud Code יצרף סשן ניפוי באגים. אם הקישור הצליח, ייפתח חלון של כלי הניפוי באגים, שבו יוצג אישור על החיבור (בכרטיסייה Console).

    עכשיו אפשר לבצע ניפוי באגים באשכול Kubernetes פעיל.

  3. לוחצים על השוליים בשורה של הקוד שניתן להפעלה שבה רוצים להוסיף נקודת עצירה.

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

  4. כששולחים בקשה חדשה לאפליקציה, היא תושהה בשורה הרצויה.

    סשן של ניפוי באגים ב-Kubernetes

  5. כדי לסיים את סשן ניפוי הבאגים, לוחצים על סמל ההפסקה בDevelop on Kubernetes הגדרת ההפעלה.

צפייה ביומנים

בנוסף לצפייה בשידור חי של היומנים מהפודים הפועלים בפלט של הטרמינל במהלך הפיתוח וההפעלה של האפליקציה, אפשר לצפות ביומנים מפוד ספציפי על ידי ניווט אל Kubernetes Explorer.

כדי להציג יומנים מ-Pod ספציפי, פועלים לפי השלבים הבאים:

  1. עוברים אל הכלי לבדיקת Kubernetes. אפשר לגשת אליו מהחלונית הצדדית בצד שמאל או באמצעות כלים > Cloud Code > Kubernetes > הצגת Cluster Explorer.

    חלונית Kubernetes Explorer פתוחה באמצעות הכרטיסייה בסרגל המשימות בצד שמאל

  2. בוחרים את הפוד שרוצים לראות את היומנים שלו.

  3. לוחצים לחיצה ימנית על ה-pod ובוחרים באפשרות Stream Logs (הזרמת יומנים). אפשרות נוספת היא להזרים יומנים של קונטיינרים ספציפיים שפועלים ב-Pods.

    היומנים מוצגים במסוף של Kubernetes Explorer.

    הזרמת יומנים מ-Pod באמצעות תפריט הלחיצה הימנית שלו כדי להוציא יומנים אל מסוף Kubernetes Explorer

הסרת המשאבים

כדי לא לצבור חיובים לחשבון Google Cloud על המשאבים שבהם השתמשתם בדף הזה, פועלים לפי השלבים הבאים:

  1. נכנסים לדף Projects במסוף Google Cloud :

    כניסה לדף Projects

  2. בוחרים את הפרויקט שיצרתם במדריך למתחילים ולוחצים על סמל פח האשפה כדי למחוק אותו.

    הפעולה הזו משביתה את הפרויקט ומתזמנת את המחיקה שלו.

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