תיעוד

תצורת בנייה ובדיקה

הסבר על אופן הגדרת פקודות הבנייה והבדיקה ב-Coroid ומדוע חשוב מאוד שפקודות אלו יהיו מדויקות.

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

Coroid מזהה את הפקודות הללו כשהפרויקט נוצר. בדקו מה הוא מצא.

מה ש-Coroid זקוק לו

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

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

מקומות בהם הזיהוי נוטה לטעות

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

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

תלויות שירות. בדיקות הדורשות פעילות של מסד נתונים, מטמון או תור פעולות. אם סט הבדיקות מניח ש- localhost:5432 פועל כראוי, הוא ייכשל בסביבת עבודה נקייה.

משתני סביבה. סטי בדיקות הקוראים תצורה מקובץ .env שאינו נמצא במאגר הקוד.

סימפטומים של תצורה שגויה

הסימן הוא כישלון של משימות במהלך האימות מסיבות שאינן קשורות לשינוי – אותו כישלון בכל משימה, באותו שלב, ללא קשר לבקשה הספציפית.

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

מכולות

כאשר ניתן להכניס את הפרויקט למכולה, Coroid יכול להשתמש בה כסביבת ביצוע – דבר שפותר את בעיות תלויות השירות וסטיות התצורה בבת אחת, מכיוון שהמכולה כבר מכילה אותן.

אם יש לכם קובץ Dockerfile או Compose פועל שמריץ את הבדיקות, זו בדרך כלל התצורה האמינה ביותר שתוכלו להשתמש בה.

תמיכה בשפות

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

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