להתחיל

פריסות, תצוגות מקדימות וחזרה לגרסה קודמת.

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

4 דקות קריאה

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

פריסה אוטומטית בכל push

כל push לענף של האפליקציה בונה את ה-commit האחרון ופורס אותו. הגרסה החדשה מופעלת לצד הגרסה הפעילה ומקבלת מבקרים רק אחרי שהיא עונה; אם היא לא עולה, הגרסה הקודמת ממשיכה לפעול ונודיע לכם באימייל (וב-Telegram, אם חיברתם אותו).

push שנעשה בזמן שבנייה אחרת עדיין ממתינה בתור מצטרף לבנייה הזו, כך שרצף של pushes לא יוצר תור ארוך.

אפשר לכבות את זה בהגדרות → פריסה בכל push. כשזה כבוי, פורסים מלוח הבקרה, מה-API או דרך deploy hook.

פריסה מלוח הבקרה

הלשונית פריסות מציגה כל פריסה: מה הפעיל אותה (push, לוח הבקרה, חזרה לגרסה קודמת, deploy hook), ה-commit, כמה זמן היא לקחה והסטטוס שלה. לחצו על פריסה כדי לראות את יומן הבנייה המלא שלה.

פריסה מחדש מציעה שתי אפשרויות:

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

בתפריט שליד פתיחה יש את אותן שתי פעולות ובנוסף הפעלה מחדש.

חזרה לגרסה קודמת

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

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

תצוגות מקדימות לענפים

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

  • עד 3 תצוגות מקדימות בו-זמנית, כלולות במחיר.
  • תצוגה מקדימה בלי pushes חדשים במשך 7 ימים נמחקת. היא נוצרת מחדש עם ה-push הבא לאותו ענף.
  • תצוגות מקדימות מקבלות רק את המשתנים שמיועדים להן — ראו משתני סביבה.
  • תצוגות מקדימות נוצרות לשירות הראשי של פרויקט, לא לשירותים האחרים שלו.

סיסמה לתצוגות מקדימות

בלשונית תצוגות מקדימות, סיסמה לתצוגות מקדימות → לבקש סיסמה. הזינו שם משתמש וסיסמה (לפחות 8 תווים). מאותו רגע רק מי שיש לו את הסיסמה יכול לפתוח את התצוגות המקדימות; האפליקציה עצמה נשארת פתוחה לכולם.

פקודת השחרור (מיגרציות)

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

אנחנו מציעים פקודה לפריימוורקים שיש להם כזו:

פריימוורקפקודת שחרור מומלצת
Laravelphp artisan migrate --force
Djangopython manage.py migrate --noinput
Prisma (Node.js)npx prisma migrate deploy

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

הגדרות בנייה

הגדרות → הגדרות בנייה מאפשר לשנות את מה שזיהינו:

  • פקודת התקנה — למשל npm ci
  • פקודת בנייה — למשל npm run build
  • פקודת הפעלה — הפקודה שמפעילה את האפליקציה. היא צריכה להאזין לפורט שב-$PORT.
  • תיקיית פלט — לאתרים סטטיים, התיקייה עם הקבצים הבנויים.
  • תיקיית הפרויקט — למאגר עם כמה פרויקטים.

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

בהגדרות נמצא גם הענף שנפרס.

Deploy hooks

הגדרות → Deploy hooks → יצירת hook. ‏Deploy hook הוא כתובת פרטית: כששירות אחר שולח אליה בקשת POST, ה-commit האחרון של הענף שלכם נבנה ונפרס. שימוש נפוץ הוא CMS שבונה מחדש את האתר אחרי פרסום.

curl -X POST "<כתובת ה-hook מלוח הבקרה>"
  • הכתובת מוצגת פעם אחת — העתיקו אותה כשאתם יוצרים את ה-hook. כל מי שמחזיק בה יכול להפעיל פריסה, אז שמרו אותה פרטית.
  • עד 10 פריסות בשעה לכל hook. קריאה שמגיעה בזמן שבנייה עדיין ממתינה מצטרפת אליה.
  • ביטול עוצר את הכתובת מיד; שירותים שקוראים לה יצטרכו כתובת חדשה.

מצב תחזוקה

הגדרות → מצב תחזוקה → הצגת דף התחזוקה. המבקרים רואים דף קצר עם ההודעה שלכם במקום האפליקציה; השאירו את ההודעה ריקה כדי להציג «אנחנו מבצעים כמה שיפורים. נסו שוב בעוד זמן קצר.»

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

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

התראות על פריסות

נשלח לכם אימייל (והודעת Telegram, אם חיברתם אותו) כשפריסה לא מסתיימת. כדי לשלוח אירועים גם לצוות — גרסה חדשה עלתה לאוויר, פריסה לא הסתיימה, שירות נעצר או חזר, שימוש גבוה בזיכרון או במעבד, גיבוי או דיסק של מסד נתונים — הוסיפו Slack, ‏Discord או webhook משלכם בהגדרות → התראות לצוות. הודעות webhook הן JSON חתום בסוד שמוצג פעם אחת, בכותרת X-Rivervo-Signature.

עדיין תקועים?

דברו איתנו בצ׳אט — AI עונה מיד, ומהנדס מצטרף כשצריך, בכל שעה ביממה.

פנייה לתמיכה