הגדרת CI/CD ליישומי Rust (Cargo)

למה CI/CD של בנייה ב-Rust נשברים ומעכבים את הצוות

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

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

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

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

כלים כמו Cargo סוגרים את השחזוריות ברמת התלויות, אבל אינם אחראים לסביבה, למטמון ולשלבי השחרור — זה התחום של הצינור. בהמשך נפרק איך זה נסגר: קיבוע אימג' הבנייה, מטמון בשכבות, פיצול הגרף לחלקים ושחרור גרסה אוטומטי.

מה נותן צינור בנייה ואספקת אפליקציות מסודר

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

מטמון הארטיפקטים של Cargo לפי ה-hash של קובץ הנעילה ובנייה אינקרמנטלית מקצרים את מחזור בדיקת השינויים מ-12–15 דקות ל-3–4, ומשימות מקבילות מפזרות את הבדיקות והלינטרים בין סוכנים — התור למיזוג מפסיק להיות צוואר בקבוק.

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

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

האפקט העיקרי — לא המהירות כשלעצמה, אלא סוג הכשלים שמפסיק להגיע ללקוח. תלויות לא תואמות, מיגרציות שלא נכנסו ל-git, פערי גרסאות ו«זה נבנה אצלי» נחסמים לפני השחרור: לסביבת הבדיקה מגיע רק ארטיפקט שעבר בנייה, בדיקות ובדיקת פגיעויות.

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

אופציות לארגון הבנייה: סוכנים, מכולות, מכונות משלנו

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

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

השוואת אופציות לארגון הבנייה

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

איך אנחנו מגדירים CI/CD לאפליקציות Rust: שלבי העבודה

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

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

מה מועבר לידיים: קונפיגורציות, תרשים, נהלים

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

• קונפיגורציית בנייה ומטמון ל-Cargo: מטריצת יעדים, הפרדה בין פרופילים, מטמון של תיקיית הבנייה ורישום החבילות לפי ה-hash של קובץ קיבוע התלויות — בנייה חוזרת לוקחת דקות במקום עשרות, ובשינוי תלויות המטמון מתבטל באופן ממוקד.
• תרשים האינטראקציה בין השירותים: הצינור, רישום האימג'ים, אחסון הארטיפקטים, סביבת ההרצה וההתראות — עם נקודות הכשל והשלבים שרצים במקביל.
• מדיניות גישה לסודות: איפה יושבים המפתחות, אילו היקפי פעולה ותוקף יש להם, אילו תפקידים קוראים אותם. הסודות מונפקים לשלב מסוים, לא לכל סביבת הבנייה כולה.
• תיעוד הצינור: שלבים, משתנים, תנאי הפעלה ובדיקות שחוסמות מיזוג. מהנדס חדש מבין את סיבת הנפילה בלי לקרוא את הקונפיגורציה שורה אחר שורה.
• נוהל שחרור גרסה: מהתג בריפו ועד הארטיפקט בסביבה — מי יוזם, אילו בדיקות חובה, איך הגרסה נכנסת לרשימת השינויים.
• הוראות חזרה לאחור של שחרור: קריטריונים ל«לחזור לאחור או לתקן קדימה», פקודות, נקודות בדיקה ואחראי. את התרחיש מתרגלים על סביבת הבדיקה לפני המסירה.
• מפת ניטור: מטריקות של בנייה ופריסה, ספי הפעלה ונמעני ההתראות.

מקרה בוחן: קיצרנו את זמן הבנייה והסרנו צעדים ידניים

הלקוח — צוות שמפתח שירות ב-Rust מעשרה ספריות בריפו אחד. לפני כל שחרור בנייה מלאה לקחה כ-40 דקות, וחלק ניכר מהנפילות נבע לא מהקוד אלא מפערי סביבות: אצל המפתח התלויות מעודכנות, על מכונת הבנייה — לא.

העברנו את הפרויקט לצינור משותף של GitLab CI ופירקנו אותו לשלבים בלתי תלויים: בדיקת פורמט, בדיקות, בניית ארטיפקט השחרור. התלויות ותוצאות הביניים נשמרות במטמון בין הרצות, המהדר וסט הספריות מקובעים באימג' אחד — הוא עובד אותו דבר על מכונת המהנדס ובצינור.

מטריקות לפני ואחרי

• משך בנייה מלאה: מ-40 דקות ל-11 — בזכות המטמון והפרלליזציה של השלבים.
• שיעור הנפילות בגלל הסביבה: היה כשליש מכלל הכשלים, נשארו מקרים בודדים.
• פעולות ידניות לפני שחרור: מתשע לאחת — נשאר רק הפעלת השחרור.
• התאוששות אחרי כשל בנייה: מכמה שעות ל-15 דקות, כי הכשל משוחזר מקומית באותו אופן.

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

במה שונה מטמון התלויות ממטמון ארטיפקטי הבנייה?

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

מטמון ארטיפקטי הבנייה — תוצאות ההידור של הפרויקט שלכם: קבצי אובייקט וקבצים בינאריים מוכנים, שעליהם נשענת הבנייה האינקרמנטלית של הפרויקט.

מפתח המטמון של התלויות — Cargo.lock, גרסת ה-toolchain ופרופיל הבנייה; של הארטיפקטים — טביעת האצבע של קוד המקור והמצב הקודם של תיקיית הבנייה. עדכון של ספרייה אחת מאפס את השכבה הראשונה וכמעט לא נוגע בשנייה, ועריכה של מודול אחד עושה ההפך.

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

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

ספקות טכניים נפוצים: מטמון, סודות, פלטפורמות יעד

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

נשארו אצלנו הגדרות ידניות מהצוות הקודם

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

מה יקרה אם מכונת הבנייה תיפול באמצע העבודה

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

צריך לבנות לכמה פלטפורמות יעד

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

איפה נשמרים המפתחות והסודות של הבנייה

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

נדון במשימה: נחזור עם הערכה ותוכנית עבודה

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

• מבנה הריפו וה-workspace של Cargo: כמה קרייטים, האם יש workspace, אילו תלויות נמשכות מרישומים פנימיים או ישירות מ-git.
• פלטפורמות יעד: לאילו מערכות וארכיטקטורות צריך קובץ בינארי, האם נדרשים קומפילציה צולבת, קישור סטטי ובניות נפרדות ליעדים משובצים.
• הצינור הנוכחי: איפה הבנייה חיה היום, מה מפעיל אותה, כמה לוקח מחזור מלא מקומיט עד ארטיפקט ובאיזה שלב לרוב היא נשברת.
• דרישות למטמון ולסוכני בנייה: זמן בנייה מותר, נפח מטמון התלויות, מגבלות משאבים ופרלליזם.
• בדיקות לפני שחרור: אילו בדיקות חייבות לעבור, האם נדרשים ניתוח סטטי, בקרת רישיונות של תלויות ובדיקת פגיעויות.
• כללי שחרור: סכמת ה-versioning, לאן מתפרסמים הארטיפקטים, האם נדרשים חתימה, שחזוריות בנייה וחזרה אוטומטית לשחרור הקודם.
• הרשאות וסביבות: איפה נפרסים הסוכנים, האם יש מתחם סגור, למי שייכים הסודות והאימג'ים.
• מי בצד שלכם מקבל החלטות על תהליך השחרור וזמין להבהרות קצרות.

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