תיעוד

הגדרות שחרור

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

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

סביבות
לאן נכנס שחרור? הוסיפו נקודות עצירה וסדרו אותן.
כללי אישור
מה חייב להתקיים קודם? אישורים, תפקידים, רשימת בדיקה וכללי תיקון מהיר לכל סביבה.
צינור פריסה
מי מבצע פריסה, וכיצד Coroid מקבל משוב? הפייפליין שלכם או Coroid מפעילים אותו; אסימון דיווח מאפשר ל-CI/CD לאשר את התוצאה.
ניהול גרסאות
לאיזו גרסה זו שייכת? מקורות הגרסאות, מה שהתהליך מקבל, וכיצד Coroid בודק מה בדיוק רץ.
שחרורים → הגדרות שחרור: בחר פרויקט, לאחר מכן ארבעה מסכים – שאלה אחת בכל מסך.

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

סביבות

לאן נכנסת הגרסה, ובאיזה סדר?

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

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

כללי אישור

מה חייב להתקיים לפני שגרסה תתפרסם כאן?

בחרו את הסביבה בראש הדף. הכללים הם לפי סביבה, כך שסביבת בדיקות יכולה להיות קלה יותר וסביבת ייצור – קפדנית יותר.

  • אישורים נדרשים: כמה אנשים שונים חייבים לאשר. אפס מאפשר לגרסה להתפרסם מיד לאחר שבדיקותיה עוברות.
  • מי יכול לאשר: תפקידי הארגון המורשים לאשר.
  • הפרדת מבקש ואישר: האדם שמתחיל את הפריסה אינו יכול לאשר אותה, ומי שעורך את הערות הגרסה אינו יכול לאשר אותן.
  • בדיקות איכות עוברות: תמיד פעיל. גרף האיכות של הפרויקט עם release_validation מפעיל ריצה על הקומיט המדויק. פרסמו את הגרף הזה מהגדרות האיכות של הפרויקט.
  • סביבה קודמת קודם: הגרסה חייבת כבר להיות מפורסמת לסביבה שאחריה מגיעה זו.
  • אישור על הערות הגרסה: הערות הנוכחיות זקוקות לאישור, וכל עריכה נוספת דורשת אישור חדש.
  • רשימה לבדיקה: צעדים ידניים שמישהו מאשר בדף הגרסה, כגון "בדיקת הגירת מסד נתונים". סמנו פריט כנדרש או אופציונלי. פריט נדרש יכול לאפשר חריגה זמנית. בעלים או מנהל רושמים סיבה ותאריך תפוגה של עד 24 שעות, והחריגה תקפה רק לקומיט ולסביבה הספציפיים.
  • כללי תיקון מהיר: כללים קלים יותר לתיקונים דחופים: מספר האישורים וכן האם כללי הסביבה הקודמת ואישור הערות עדיין חלים. בדיקות האיכות ופריטי רשימת הבדיקה הנדרשים תמיד חלים, ורק בעלים ומנהלים יכולים לאשר תיקונים מהירים.

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

פייפליין פריסה

מי מתחיל פריסה, ואיך Coroid יודע מה קרה?

בחרו את הסביבה בראש הדף, ולאחר מכן בחרו כיצד הפריסות מתחילות:

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

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

גרסאות

לאיזו גרסה שייכת הפריסה הזו, וכיצד הבנייה מקבלת אותה?

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

העברת הגדרות בין ארגונים

ייצוא וה imports של הגדרות כוללים את הסביבות, סדרן, תצורת הפייפליין, גרסאות, כתובות URL של גרסאות וכללי פרסום, כולל כללי תיקון מהיר. טוקני דיווח ומספרי בנייה אינם נכללים בייצוא. יש ליצור טוקנים חדשים לאחר import; לכל פרויקט יש מספרי בנייה משלו.