עבודה עם קובצי YAML של Google Cloud ו-Kubernetes ב-Cloud Code ל-IntelliJ

הכלי Cloud Code נועד לעזור בעריכה Google Cloud של קובצי תצורה שקשורים ל-Kubernetes, כולל אימות מבוסס-סכימה, אבחון ותיעוד מהיר.

קבצים נתמכים של הגדרות ב-YAML

‫Cloud Code תומך גם ב-CRD פופולריים של Kubernetes, כמו Kubeflow, ללא צורך בהגדרה.

הפעלה או השבתה של תמיכה ב-YAML

כדי להפעיל או להשבית את התמיכה ב-YAML, עוברים אל File (קובץ) > Settings (הגדרות) > Tools (כלים) > Gemini + Google Cloud Code > Kubernetes (ב-Windows וב-Linux) או אל IntelliJ IDEA > Settings (הגדרות) > Tools (כלים) > Gemini + Google Cloud Code > Kubernetes (ב-macOS) ומסמנים או מבטלים את הסימון בתיבת הסימון Enable YAML support (הפעלת תמיכה ב-YAML) כדי להפעיל או להשבית את התכונה.

שימוש בסכימה מותאמת אישית

בעזרת Cloud Code, אתם יכולים לספק סכימת CRD משלכם עם הגדרות IntelliJ. כדי לעשות זאת, עוברים אל File > Settings > Tools > Gemini + Google Cloud Code > Kubernetes (ב-Windows וב-Linux) או אל IntelliJ IDEA > Settings > Tools > Gemini + Google Cloud Code > Kubernetes (ב-macOS), ואז מעיינים בקטע מיקומי סכימת ה-CRD.

אפשר להפנות לקובץ מקומי או לכתובת URL. כתובות URL שמפנות אל github.com מומרות אוטומטית ל-raw.githubusercontent.com.

שליפת סכימה מאשכול

כשעוברים לאשכול שמריץ Kubernetes v1.16+ בסייר Kubernetes, Cloud Code שולף אוטומטית את הסכימה של כל ה-CRD המותקנים.

תמיכה נוספת ב-Skaffold

‫Skaffold הוא המנוע הבסיסי שמפעיל את Cloud Code, ועוזר לכם לבנות, להעביר ולפרוס את האפליקציה, וגם מספק תמיכה ביצירת צינורות עיבוד נתונים של CI/CD.

‫Cloud Code כולל תמיכה נוספת בניהול קובצי ההגדרות של Skaffold. כשפותחים פרויקט, Cloud Code מזהה סכימות של Skaffold שלא עדכניות ומציג הנחיה (דרך יומן האירועים) כששדרוג של גרסת סכימת Skaffold זמין לקובצי ההגדרות הקיימים של Skaffold YAML.

התראה ביומן האירועים שמבקשת מהמשתמש לשדרג את גרסת הסכימה של Skaffold כי קובצי ה-YAML הקיימים של Skaffold לא שייכים לגרסה האחרונה

אפשר גם לעבור אל כלים > Gemini + Cloud Code > Kubernetes > בדיקה אם יש שדרוגים של סכימות Skaffold כדי לבדוק אם יש שדרוגים זמינים של סכימות.

הגדרה באמצעות קטעי קוד

קטעי קוד מוכנים מראש לסכימת YAML נפוצה (באמצעות Ctrl+Space כדי לראות את האפשרויות) מאפשרים להתחיל קובץ YAML חדש או להוסיף לקובץ קיים ללא שגיאות, תוך הקפדה על שיטות מומלצות. בנוסף, קל יותר לעבוד עם שדות חוזרים. ממלאים שדה אחד ו-Cloud Code ממלא את שאר המופעים.

שימוש בסניפטים עם שדות חוזרים

‫Cloud Code מציע את קטעי הקוד הבאים:

  • Cloud Build - Cloud Run deployment
  • Cloud Build - Docker container build
  • Cloud Build - GKE deployment
  • Cloud Build - GKE Skaffold deployment
  • Cloud Build - Go build
  • Cloud Build - Terraform plan + apply
  • Config Connector - BigQueryDataset
  • Config Connector - BigQueryTable
  • Config Connector - BigtableCluster
  • Config Connector - BigtableInstance
  • Config Connector - PubSubSubscription
  • Config Connector - PubSubTopic
  • Config Connector - RedisInstance
  • Config Connector - SpannerInstance
  • Kubernetes - ConfigMap
  • Kubernetes - Deployment
  • Kubernetes - Ingress
  • Kubernetes - Pod
  • Kubernetes - Service
  • Migrate to Containers - Export
  • Migrate to Containers - PersistentVolumeClaim
  • Migrate to Containers - StatefulSet
  • Skaffold - Bazel
  • Skaffold - Getting-started
  • Skaffold - Helm deployment
  • Skaffold - Kaniko

השלמה עם הקשר

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

השלמות בהקשר לסכימת Kubernetes

אימות סכימת YAML

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

הערך בשדה השם מודגש בקו אדום מתחת כדי להבליט ערך לא תקין של 1234. הטקסט שמופיע כשמעבירים את העכבר מעל השדה הוא: סוג שגוי. הערך הצפוי הוא מחרוזת.

אימות קובצי YAML של Skaffold

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

תבניות Skaffold yaml

השלמת קובצי התצורה של Skaffold עם הקשר

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

השלמות ב-Skaffold

הסבר על הגדרות באמצעות תיעוד מהיר

כשמסמנים שורה בקובץ התצורה ועוברים אל View (תצוגה) > Quick Documentation (תיעוד מהיר), Cloud Code מציג תיעוד רלוונטי למשאב.

תיעוד מהיר

הפעלת לינטר (Linter) ב-YAML כדי לבדוק בעיות שקשורות למבנה ולתוקף

‫Cloud Code מספק תמיכה בבדיקת קוד (linting) לגבי בעיות נפוצות בסכימה, ומציג שגיאות תיאוריות.

בדיקת קובצי YAML

החלת קובץ YAML

כדי להריץ את הפקודה kubectl apply -f כדי להחיל שינוי בהגדרות באמצעות הקובץ הנוכחי, אפשר להשתמש בסמל הפעולות של kubectl סמל הפעולות של kubectl שזמין בשוליים של סביבת הפיתוח המשולבת, ולבחור באפשרות החלה. מוצג לכם תצוגת השוואה כדי שתוכלו לבדוק את השינויים לפני שתלחצו על החלה.

החלת האפשרות שמודגשת ברשימת הפעולות של kubectl

השוואה בין קובצי YAML

כדי לראות את ההבדלים בין קובץ YAML בבקרת מקור לבין קובץ YAML שנפרס, אפשר להשתמש בסמל הפעולות של kubectl‏ סמל הפעולות של kubectl שזמין בשוליים של העורך. בוחרים באפשרות הבדלים כדי לראות תצוגת הבדלים שבה אפשר להשוות בין שני קובצי סכימה.

האפשרות 'השוואה' מודגשת ברשימת הפעולות של kubectl

ביצוע הרצה יבשה של קובץ YAML

כדי לבצע הרצה יבשה של הקובץ ולבדוק את התקינות שלו, אפשר להשתמש בסמל הפעולות של kubectl‏ סמל הפעולות של kubectl, שזמין בשוליים של סביבת הפיתוח המשולבת (IDE), כדי לבחור באפשרות Dry-run on Server (הרצה יבשה בשרת) או Dry-run on Client (הרצה יבשה בלקוח). הפקודה הזו מריצה kubectl apply -f dry-run=server (או kubectl apply -f dry-run=client, אם בוחרים באפשרות Client) ושולחת לכם הודעה אם אפשר ליצור את הקובץ בחלון Terminal.

האפשרות 'הרצה יבשה' בשרת מודגשת ברשימת הפעולות של kubectl

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

פנייה לתמיכה

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