שימוש באפליקציה קיימת ב-Cloud Code for IntelliJ

אם יש לכם פרויקט קיים שכבר הוגדר עם מניפסטים של Kubernetes, קובץ Dockerfile או Jib כדי ליצור את התמונות, אתם יכולים לפתוח אותו ולהשתמש בו עם הפלאגין. ההגדרה הנוספת היחידה שנדרשת היא קובץ YAML של Skaffold, שאפשר ליצור אותו אוטומטית או באמצעות התבנית שמופיעה כאן.

אחרי שמסיימים להגדיר את קובץ ה-YAML של Skaffold, חשוב לציין איפה מאוחסנים קובצי האימג' בקונטיינר, כלומר איפה קובץ האימג' של הפרויקט עומד להידחף.

הפעלה אוטומטית של פרויקט

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

אם Cloud Code לא מזהה הגדרת Skaffold קיימת, תתבקשו לעזור בהגדרה שלה.

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

כדי שתופיע לכם בקשה ליצור קובץ skaffold.yaml ולהריץ את ההגדרות הנדרשות, הפרויקט שלכם צריך לעמוד בדרישות המוקדמות הבאות:

• (אפשרות 1) בפרויקט יש Dockerfile והוא מוגדר ל-Jib, או

• (אפשרות 2) אפשר לבנות את הפרויקט באמצעות Buildpacks ויש לו משאבי Kubernetes.

הגדרת תצורת הרצה של Kubernetes

אם הדרישות המוקדמות מתקיימות, Cloud Code יציג לכם התראה ליצור קובץ skaffold.yaml (אם הוא עדיין לא קיים) וכל הגדרות הפעלה שנדרשות:

1. לוחצים על ההתראה. אם אפשר, המערכת יוצרת את ההגדרות באופן אוטומטי.

   אם אי אפשר ליצור הגדרות אוטומטיות של Skaffold בגלל זיהוי של כמה קובצי אימג' או כלי בנייה, ב-Cloud Code יוצג תיבת דו-שיח שבה תתבקשו לספק מיפויים בין קובצי האימג' וכלי הבנייה שזוהו.

   

   לחלופין, אפשר להגדיר את התצורה של Skaffold גם דרך כלים > Cloud Code > Kubernetes ואז לבחור באפשרות הוספת תמיכה ב-Kubernetes.

   האפשרות הזו מנתחת את משאבי Kubernetes של הפרויקט ומפיקה קובץ skaffold.yaml (אם הוא לא קיים) וגם הגדרות הפעלה נדרשות. שתי תצורות ההפעלה שנוצרות כוללות אחת להפעלת הפרויקט ב-Kubernetes ואחת לפיתוח באשכול Kubernetes.

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

יצירה ידנית של הגדרת Skaffold ב-Cloud Code

אתם יכולים ליצור קובץ skaffold.yaml חדש באופן ידני או להוסיף קובץ קיים לפרויקט.

כדי ליצור קובץ skaffold.yaml באופן ידני באמצעות תבניות פעילות:

1. יוצרים קובץ חדש בשם skaffold.yaml בספריית השורש של הפרויקט (לחיצה ימנית > חדש > קובץ).

2. ממקמים את הסמן בקובץ החדש, לוחצים על Ctrl+Space כדי להציג את ההצעות לתבניות פעילות ובוחרים את תבנית Skaffold הרצויה.

   

3. מאכלסים את שדה התמונה בשם תמונת הפרויקט ואת שדה המניפסטים ברשימת משאבי Kubernetes שרוצים לפרוס מסביבת הפיתוח המשולבת.

4. אחרי ש-Cloud Code קובע שהקובץ skaffold.yaml תקין, לוחצים על ההנחיה ליצירת תצורות הפעלה של Kubernetes.

   

דוגמאות להגדרות Skaffold ב-Cloud Code

• גרסאות build שמבוססות על Dockerfile:

  build:
    artifacts:
      - image: image_name
  deploy:
    kubectl:
      manifests:
        - k8s/web.yaml
        - k8s/backend.yaml
  

• קטע Build לפרויקטים של Java Maven/Gradle עם הפלאגין Jib (הקטע deploy נשאר כמו בדוגמה שלמעלה):

  build:
  artifacts:
  - image: image_name
    jib: {}
  

• אם רוצים להגדיר תצורות של בנייה, בדיקה ופריסה להקשרים שונים, אפשר להשתמש בפרופילים שונים. הנה דוגמה לפרופיל Cloud Build להגדרת Cloud Code ליצירת תמונות באמצעות Cloud Build:

  profiles:
  # use the cloudbuild profile to build images using Google Cloud Build
  - name: cloudbuild
    build:
      googleCloudBuild: {}
  

• אם רוצים לפרוס את הפרויקט באמצעות Helm, אפשר לעיין בתיעוד של Helm.

ציון המקום שבו מאוחסנים קובצי אימג' של קונטיינרים

אחסון של קובצי אימג' של קונטיינר

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

כברירת מחדל, הפרויקט מוגדר להשתמש בשם התמונה שצוין במניפסטים של Kubernetes. אפשר גם להתאים אישית את מפרט התמונה הזה. אחרי שמגדירים את מאגר המועדף (Artifact Registry,‏ DockerHub או מאגר פרטי), עורכים את הגדרות ההרצה ומציינים אותו כמאגר ברירת מחדל של קובצי אימג' בהגדרות ההרצה.

אפשר לגשת אליהן מתיבת הדו-שיח של הגדרות ההרצה/ניפוי הבאגים בסרגל המשימות העליון בקטע עריכת הגדרות > פיתוח ב-Kubernetes > מאגר תמונות.

למידע נוסף על הגדרת ההעדפות שלכם לגבי קובץ האימג' של הקונטיינר, אפשר לעיין במדריך להגדרת קובץ האימג' של הקונטיינר.

הגדרות build

אחרי שמגדירים את קובץ האימג' של קונטיינר, אפשר להגדיר את הגדרות ה-build שלו. ‫Cloud Code תומך בסוגי הארטיפקטים Docker,‏ Jib ו-Buildpacks.

בכרטיסייה Build / Deploy של הגדרות התצורה של Run (Edit Configurations > Develop on Kubernetes), אפשר להגדיר את הגדרות ה-build של פרופיל ברירת המחדל.

מידע נוסף על הגדרת הגדרות ה-build של קובץ אימג' של קונטיינר זמין במאמר הגדרת העדפות של build של קובץ אימג' בקונטיינר.

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

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

פנייה לתמיכה

כדי לשלוח משוב או לדווח על בעיה ב-IntelliJ IDE, עוברים אל Tools (כלים) > Cloud Code > Help / About (עזרה / מידע) > Submit feedback or report an issue (שליחת משוב או דיווח על בעיה) כדי לדווח על בעיה ב-GitHub.