GitHub מתחבר דרך ה־Coroid GitHub App או דרך טוקן גישה אישי. ניתן להגדיר אותו ב־ הגדרות → חיבורים → בקרת קוד מקור.
אפליקציה או טוקן
עדיף להשתמש באפליקציה. היא מעניקה גישה לפי מאגר ולא לפי משתמש, ממשיכה לפעול גם כשהאדם שהגדיר אותה עוזב, ומקבלת אירועי Webhook ללא צורך בסקירה.
ניתן להשתמש בטוקן כשהתקנת האפליקציה דורשת אישור של מנהל ארגון שאינו זמין.
| GitHub App | טוקן גישה אישי | |
|---|---|---|
| טווח גישה | לפי מאגר | כל מה שהמשתמש יכול לראות |
| נשאר פעיל גם אחרי עזיבת המתקין | כן | לא |
| אירועי Webhook | כן | סקירה |
| הקשר | האפליקציה | בעל הטוקן |
התקנת האפליקציה
בחרו את GitHub ב־ הגדרות → חיבורים → בקרת קוד מקור ועקבו אחר תהליך ההתקנה. GitHub שואל באילו מאגרים להעניק גישה; ניתן לשנות זאת מאוחר יותר מהגדרותיו של GitHub עצמו.
אם מאגר מסוים אינו מופיע בעת יצירת פרויקט, ככל הנראה האפליקציה לא קיבלה גישה למאגר הספציפי – זו הסיבה הנפוצה ביותר בהרבה.
שימוש בטוקן
יצרו טוקן קלאסי עם ה־ repo טווח, או טוקן מדויק עם הרשאות קריאה וכתיבה על תוכן ובקשות משיכה, ואז הדביקו אותו בהגדרות בקרת הקוד.
הטוקנים מוצפנים בשהייה, לעולם אינם מוחזרים על ידי API, ולעולם אינם נכללים בייצוא הגדרות.
GitHub Issues
אותו חיבור מאפשר ייבוא של בעיות כעבודה. ראו ייבוא עבודה.
אירועים שהופכים לעבודה
עם האפליקציה, אוטומציית אירועים יכולה לשלוח pull request, בעיה חדשה או תגובה שמציינת את Coroid לתהליך הערכה. ראו מפעילים ויעדים.
העבודה שעברה הערכה מאירועים אלו מתחילה מעצמה רק כשלכותב יש הרשאת כתיבה, תחזוקה או ניהול במאגר. Coroid שואל את GitHub עבור כל אירוע. עבור pull request, הכותב הוא האדם שפתח אותה, ולא זה שתייג או מיזג אותה. עבודה שמגיעה מאדם אחר נוצרת וממתינה שמישהו יתחיל אותה. תגובה שמציינת את Coroid נחשבת רק כשלכותב יש הרשאת כתיבה.
סקירת בקשות משיכה
עם האפליקציה, Coroid בודק ומסקר בקשות משיכה שנפתחו על ידי אנשים וכלים אחרים, ולא רק של Coroid עצמו. בקרת האיכות של Coroid מפעילה את הבדיקות של הפרויקט ומפרסמת את בדיקת בקרת האיכות של Coroid. סקירת Coroid מפרסמת סקירה עם תגובות על השורות שהיא מערערת עליהן, ובדיקה בשם סקירת Coroid. שתיהן מוגדרות בבקרת האיכות, תחת בקשות משיכה. ראו בקשות משיכה.
מה Coroid עושה במאגר שלכם
- קורא קוד כדי להבין ולשנות אותו
- יוצר ענף לכל משימה
- דוחף את הענף הזה ופותח בקשת משיכה של pull request מול הענף הבסיסי שלכם
הוא לעולם אינו מבצע קומיט לענף ברירת המחדל שלכם או מבצע מיזוג מעצמו. מיזוג מתרחש רק כשאדם ממזג את ה־pull request ב־GitHub או לוחץ על אישור ומיזוג ב־Coroid.
פרויקט שמוגדר ל־ מקומי בלבד מבצע רק את הפעולה הראשונה ואינו עושה דבר נוסף: Coroid קורא ומושך נתונים, ושומר ענפים, סקירות ובדיקות בתוך Coroid עצמו. הוא אינו דוחף, פותח או מגיב על בקשות משיכה, או מפרסם תוצאות בדיקה, גם כשהאפליקציה או הטוקן מאפשרים זאת. ראו מסונכרן או מקומי בלבד.
ההגנה על הענפים, הבדיקות הנדרשות וכללי הסקירה שלכם חלים ללא שינוי. אישור ומיזוג מבצע מיזוג גם דרך pull request, כך שאותם כללים קובעים אם הוא מצליח. ראו מיזוג.
אבטחה
בקרת האבטחה משתמשת באפליקציה כדי לפרסם את Coroid Security הבדיקה ו, עם הרשאות אופציונליות, לייבא את התרעות האבטחה של GitHub עצמו ולבדוק תורי מיזוג. ראו הרשאות GitHub ובדיקת האבטחה של Coroid.