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

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

הערה: מטעמי תאימות, תכונות העריכה של Kubernetes מושבתות אוטומטית אם מזוהה התוסף JetBrains Kubernetes. אפשר לשנות את ההגדרה הזו באופן ידני בתפריט ההגדרות של Cloud Code. כדי לעשות את זה, עוברים אל Cloud Code > Kubernetes > Kubernetes editing features (תכונות עריכה של Kubernetes) ומפעילים את ההגדרה Enable Kubernetes YAML configuration editing features (הפעלת תכונות עריכה של הגדרות YAML של Kubernetes). אמצעי התאימות האלה משפיעים רק על קובצי YAML של Kubernetes.

הערה: התמיכה בעריכת YAML ב-Cloud Build זמינה רק לקבצים בשם cloudbuild.yaml

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

• Anthos Config Management
• Cloud Build
• Config Connector
• Knative
• ‫Kubernetes
• Kustomize
• העברה לקונטיינרים
• Skaffold

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

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

הפעלה או השבתה של תמיכה ב-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 כדי להפעיל או להשבית את התכונה.

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

ב-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.yaml. כשפותחים פרויקט, Cloud Code מזהה סכימות שלא עודכנו ומציג הנחיה (דרך יומן האירועים) כשגרסה משודרגת של סכימה זמינה לקובצי ההגדרות הקיימים של skaffold.yaml.

אפשר גם לעבור אל כלים > Gemini + Cloud Code > Kubernetes > Check for Skaffold Schemas Upgrades (בדיקה אם יש שדרוגים של סכימות 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 מספק השלמות הקשריות כדי לעזור לכם לבחור את האפשרות הנכונה.

אימות סכימת YAML

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

אימות של skaffold.yaml קבצים

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

השלמת קבצים של skaffold.yaml עם הקשר

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

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

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

בדיקת קובצי YAML לאיתור בעיות שקשורות למבנה ולתוקף

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

החלת קובץ YAML

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

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

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

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

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

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

• יוצרים קובץ Cloud Code Kubernetes run configuration‏ skaffold.yaml.
• יוצרים באופן ידני הגדרה של skaffold.yaml לאפליקציה.
• מאמרי העזרה של skaffold.yaml

פנייה לתמיכה

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