גרסאות

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

גרסה מקבעת commit מדויק אחד של Git ועוקבת אחריו בין הסביבות שלכם, למשל סביבת Staging ולאחר מכן סביבת Production. ה־commit כבר עשוי להימצא בענף הפריסה שלכם, או ש־Coroid יארוז תחילה pull requests פתוחים לכדי pull request של הגרסה, ש־commit המיזוג שלו יהפוך לגרסה. בכל תחנה, Coroid בודק את ה־commit, אוסף את האישורים שביקשתם ומתעד את הפריסה שעליה CI/CD מדווח. Coroid לעולם אינו מסמן גרסה כפרוסה על סמך דבריו בלבד. צינור הפריסה שלכם, או אדם שמתעד פריסה חיצונית, חייב לאשר זאת.

הרעיון בקצרה – דקה אחת#

• גרסה: קומט אחד, שם, וגרסה אופציונלית. גרסה כמו 2.4.0 היא אופציונלית, כך שאספקה רציפה תפעל ללא תגים.
• סביבה: נקודת עצירה בדרך אל המשתמשים שלך, כמו סטייג'ינג או ייצור. כל פרויקט מגדיר את נקודות העצירה שלו ואת סדרן.
• שלב פריסה: אילו סביבות הגרסה כבר הגיעה אליהן.
• עבודה: המשימות שתוכננו לגרסה והשינויים שמוזגו ונכללו בה, המוצגים כמה בוצע מתוך הכול.
• ארבעה שלבים לכל סביבה: בדיקות, אישור, פריסה ומצב בריאות. דף הגרסה תמיד פותח את השלב שדורש את התערבותך.
• אריזה: גרסה שנבנית מתוך pull requests פתוחים. Coroid ממזג אותם לענף גרסה אחד, בסדר שאפשר לשנות, ופותח pull request של הגרסה יחיד. לגרסה מאוגדת יש שלב חמישי, אריזה, לפני הבדיקות.

קרא על גרסה במבט חטוף#

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

בחר גרסה כדי לפתוח את דף הפרטים שלה.

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

ארבעת השלבים בכל סביבה#

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

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

הפצה. כשהבדיקות והאישורים מושלמים, הגרסה מוכנה לסביבה. אם Coroid מחובר ל-Actions של GitHub או ל-GitLab CI/CD עבור אותה סביבה, בעלים או מנהל בוחרים הפץ ל… ו-Coroid מתחיל את ה-pipeline עבור אותו קומט מדויק. במקרים אחרים, ה-pipeline שלך מבצע את ההפצה באופן עצמאי ומדווח בחזרה. בכל מקרה, השלב הופך לירוק רק לאחר שמתקבל אישור על הצלחה.

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

מה משמעות המצבים?#

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

זרימות עבודה#

הגדרת גרסאות עבור פרויקט#

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

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

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

3. ב- נתיב פריסה, בחרו האם Coroid יתחיל את הפריסות או שהנתיב שלכם יעשה זאת. לאחר מכן יצרו טוקן דיווח כדי ש-CI/CD יוכל לעדכן את Coroid לגבי מה שנפרס.

4. ב- גרסאות, בחרו מאיזה מקור מתקבלת גרסת כל גרסה, ו aתנו לכל סביבה כתובת URL של גרסה כדי ש-Coroid יוכל לאשר מה רץ שם.

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

שלחו את העבודה המתוכננת#

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

1. יצרו גרסה מוקדם, לפני שנקבע קובץ ה-Git המתאים. היא תתחיל כטיוטה.
2. קבעו את הגרסה היעד עבור המשימות שברצונכם לכלול בה. הן יופיעו תחת משימות מתוכננות, ופס העבודה יתמלא ככל שהן יושלמו.
3. כאשר העבודה תתמזג, בחרו עריכת פרטים ובחרו את הקובץ שיש לשלוח לפרודוקציה. Coroid יאשר אילו שינויים ממוזגים הכיל הקובץ.
4. עברו על ארבעת השלבים עבור הסביבה הראשונה, ולאחר מכן עבור הבאה.

איחוד בקשות משיכה פתוחות#

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

1. בחרו שחרור חדש, בחרו את הפרויקט, ובחרו בקשות משיכה פתוחות. האפשרות דורשת מאגר GitHub או GitLab, כך שפרויקטים המאוחסנים ב־Coroid ישלחו קומיט במקום.
2. Coroid מסדר את בקשות המשיכה הפתוחות לפי סדר עדיפויות לתוך ענף הפריסה, כשהבטוחות ביותר בראש. pull request שנפתח על ידי Coroid יופיע כמשימה או תוכנית שלו. Coroid שוקל את מה שהספק וסקירתו כבר יודעים: בדיקות, ביקורות, גודל, סתירות, וקבצים שכמה בקשות משיכה נוגעות בהם. הוא משמיט טיוטות, בדיקות שנכשלו, שינויים שנתבקשו ובקשות משיכה מפורקים, ומסביר מדוע.
3. בטלו את הסימון של אלו שצריכות לחכות, והשתמשו בחצים כדי לשנות את הסדר. בקשת משיכה שמתבססת על אחרת (בקשת משיכה משולבת של pull request, או כזו ש כותבת 'תלוי ב־#12') תמיד תופיע אחריה.
4. בחרו יצירת שחרור. Coroid יוצר release/<version> מענף הפריסה, ממזג את בקשות ה-pull request לפי הסדר, ופותח pull request של הגרסה אחד שמפרט כל אחת מהן ומקשר אליה.
5. אם יש התנגשות בין pull request לבין ענף הגרסה, ה אריזה שלב זה עוצר שם ומציג את הקבצים. בחרו פתרון באמצעות Coroid כדי לאפשר לסוכן המפתחים לאחד אותם ולפתור את ההתנגשות במשימה, או השארתו מחוץ לתהליך כדי להמשיך ללא קיומו.
6. עבור על pull request של הגרסה ומזג אותו עם commit איחוד. הספק שלך מסמן לאחר מכן כל pull request שנכלל בחבילה כממוזג. Coroid מקבע את Commit המיזוג כ‑Commit של הגרסה, מתעד את pull requests שנכללו בחבילה בתור מה שיופץ, וסוגר את כל אלה שעדיין פתוחים בצירוף קישור ל‑pull request של הגרסה.
7. עברו על ארבעת השלבים עבור כל סביבה כרגיל.

גם איחודי Squash או Rebase עובדים, אך בקשות המשיכה המקוריות אינן מסומנות כמאוחדות על ידי הספק שלכם. Coroid סוגר אותן באמצעות תגובה במקום.

שלחו את מה שנמצא בענף ה-main#

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

1. בחרו גרסה חדשה ובחרו את הקובץ, בדרך כלל האחרון בענף הפריסה.
2. תחת השוואה עם, בחרו את הסביבה שאותה אתם עומדים להחליף. Coroid יציג את בקשות המשיכה והקבצים שבין מה שרץ שם לבין הקובץ שלכם, ויבחר את אלו שהוא יכול לאמת.
3. ניתן להשאיר את השם והגרסה ריקים אם תרצו. Coroid יקרא לגרסה על פי התאריך וקיצור הקובץ, ומקור הגרסה של הפרויקט ימלא את שדה הגרסה. לכל גרסה יינתן גם מספר בנייה עוקב.
4. יצרו את הגרסה ועברו על ארבעת השלבים.

אם הנתיב שלכם מבצע פריסה בכל מזיגה מבלי לבקש את אישור Coroid, הוא עדיין יכול alוותר על כל פריסה. כאשר אין גרסה קיימת עבור קובץ שדווח עליו, Coroid yצור עבורו גרסה שנצפתה, המסומנת בבירור ככזו שלא עברה את הבדיקות של Coroid.

שלחו תיקון דחוף#

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

התאוששו כאשר משהו נכשל#

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

מהצ'אט או מהעורך שלך#

לסייען הצ'אט ולשרת ה-MCP של Coroid יש את אותם כלים לניהול גרסאות: רשימת גרסאות ובדיקתן, בחירת commit, תצוגה מקדימה של מה שיישלח לפריסה, הכנת גרסה, אריזת משימות פתוחות, הפעלת בדיקות, אישור הגרסה, בקשת פריסה וטיוטת הערות. אריזה, אישור ופריסה תמיד דורשים אישור מאדם. עיין ב סייען צ'אט ו Coroid כשרת MCP.

שחרור מספר פרויקטים יחדיו#

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

מה Coroid כן ולא עושה#

• Coroid מציין, בודק ורושם. המאגר שלך ו-CI/CD בונים ומפריסים.
• כשהוא אורז משימות פתוחות, Coroid יוצר את ענף הגרסה ואת ה-pull request של הגרסה. הוא לעולם לא מבצע את המיזוג של ה-pull request של הגרסה עבורך.
• Coroid מפעיל צינור פריסה רק כשאתה מחבר אחד ובעלים או מנהל מבקשים פריסה.
• בקשת פריסה אינה מהווה הוכחה. מסלול השחרור מתקדם רק כשהצינור שלך מאשר הצלחה או כשמישהו רושם פריסה חיצונית מאומתת.
• הערות הגרסה הן טיוטות שאתה עורך ומאשר. Coroid אינו מפרסם אותן בשום מקום.
• ספרינט הוא תקופת תכנון ולא גבול פריסה. ספרינט אחד יכול לספק מספר גרסאות, וגרסה אחת יכולה לכלול עבודה ממספר ספרינטים.

קשור לכך#

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