אם הפעלתם השקות אוטומטיות, בכל פעם שאתם דוחפים commit חדש להסתעפות הפעילה במאגר שלכם ב-GitHub, App Hosting משיק באופן אוטומטי גרסה חדשה של האפליקציה. אתם יכולים לבדוק את סטטוס ההשקה במסוף Firebase או בבדיקה של App Hosting ב-GitHub.
בנוסף, App Hosting תומך בהשקות שמופעלות באופן ידני לשילוב CI/CD או לכל מקרה אחר שבו רוצים לאלץ השקה.
הצגת ההשקות
מסוף Firebase מספק גישה למידע מפורט על כל ההשקות של האפליקציה.
עוברים אל Hosting & Serverless > App Hosting ולוחצים על View ב-backend שרוצים לראות את ההשקות שלו. בכרטיסייה Rollouts של הקצה העורפי מוצגת טבלה עם היסטוריית ההשקות של הקצה העורפי הזה.
כל רשומה של השקה מכילה קישורים למשימה ב-Cloud Build ולשינוי או ל-commit שהפעילו את ההשקה, וגם מידע בסיסי על המחבר, תאריך היצירה והסטטוס של ההשקה.
- המשימה Cloud Build היא סביבת ה-build שבה App Hosting מריץ את פקודת ה-build של האפליקציה. כדי לגשת ליומני Cloud Build, לוחצים על מזהה ה-build.
- השדה Change הוא ה-commit ב-GitHub או פעולה אחרת שהפעילה את ההשקה.
הפעלה ידנית של השקה
אם אתם רוצים להפעיל באופן ידני השקה מהמקור ב-GitHub בלי לדחוף commit חדש, אתם יכולים ליצור השקה ממסוף Firebase או מה-CLI של Firebase. האפשרות הזו שימושית במקרים כמו:
- אילוץ יצירה מחדש של תוכן סטטי.
- לאפשר למערכת CI/CD להפעיל השקות.
- הגבלת ההשקות בסביבת הייצור לתאריכים או לזמנים ספציפיים.
כדי להפעיל השקה במסוף Firebase:
- במסוף Firebase, נכנסים אל Hosting & Serverless > App Hosting.
- לוחצים על View בקצה העורפי שרוצים ליצור לו השקה.
- בסיכום של מרכז הבקרה לקצה העורפי, לוחצים על יצירת השקה.
- בוחרים את הענף לפריסה.
- בוחרים את ה-commit לפריסה, ה-commit האחרון או commit קודם לפי מזהה ה-commit.
- לוחצים על יצירה. הסטטוס ומספר ה-build של ההשקה מוצגים בטבלת היסטוריית ההשקות. כשתהליך ההשקה מסתיים, ההשקה הזו מוצגת כהשקה הנוכחית.
כדי להפעיל השקה ב-CLI של Firebase, מריצים את הפקודה הבאה ובוחרים את ההסתעפות להשקה כשמוצגת בקשה לעשות את זה:
firebase apphosting:rollouts:create BACKEND_ID
לחלופין, אפשר להתחיל השקה של ה-commit האחרון לענף ספציפי באמצעות האפשרות --git-branch:
firebase apphosting:rollouts:create BACKEND_ID
--git-branch BRANCH_NAME
אפשר גם ליצור השקה עם commit ספציפי באמצעות האפשרות --git-commit:
firebase apphosting:rollouts:create BACKEND_ID
--git-commit COMMIT_ID
שחזור של השקה קודמת
ב-App Hosting יש שתי אפשרויות לשחזור השקה קודמת:
- חזרה מיידית לגרסה קודמת בלי לבנות מחדש
- בנייה מחדש וחזרה לגרסה קודמת
יצירת חזרה מיידית לגרסה קודמת
לפעמים צריך לחזור במהירות לגרסה קודמת של האפליקציה. לדוגמה, אם גיליתם באג קריטי בגרסה חדשה שהשקתם, או אם אתם נתקלים בבעיות בגרסה שמונעות השקה של גרסאות חדשות. במקרים כאלה, אתם יכולים לשחזר קובץ אימג' קיים של קונטיינר לבחירתכם מהשקה קודמת. התמונה הזו לא נבנית מחדש, אלא משתמשת בקוד ובהגדרת הסביבה מהפעם הראשונה שהיא נבנתה.
כדי ליצור החזרה מיידית לגרסה קודמת:
- במסוף Firebase, נכנסים אל Hosting & Serverless > App Hosting.
- לוחצים על View (הצגה) בקצה העורפי שרוצים ליצור לו חזרה לגרסה קודמת.
- לוחצים על הכרטיסייה השקות.
- בטבלה History של הקצה העורפי, לוחצים על סמל האפשרויות הנוספות (3 נקודות) של גרסה קודמת.
- בוחרים באפשרות חזרה לגרסה קודמת ומאשרים.
בנייה מחדש וחזרה למצב קודם
אם אתם רוצים לחזור לגרסה ישנה יותר של האפליקציה אבל לשמור על ההגדרות הנוכחיות, אתם יכולים לבנות מחדש את האפליקציה כחלק מתהליך החזרה לגרסה קודמת. לדוגמה, אם בגרסה האחרונה עדכנתם ערך של מפתח API ב-Secret Manager, בנייה מחדש יכולה להבטיח שהמפתח החדש ישמש באפליקציה אחרי החזרה לגרסה קודמת.
כדי לבנות מחדש ולחזור לגרסה קודמת:
- במסוף Firebase, נכנסים אל Hosting & Serverless > App Hosting.
- לוחצים על View dashboard ב-backend שרוצים ליצור לו חזרה לגרסה קודמת.
- לוחצים על הכרטיסייה השקות.
- לוחצים על Create rollout.
- בתיבת הדו-שיח Create a rollout, בוחרים באפשרות Earlier commit ומזינים את מזהה ה-commit של הגרסה שרוצים לבנות מחדש ולהחזיר. מזהה ה-commit הוא חלק מ "פרטי השינוי" של כל השקה שמופיעה בהיסטוריית ההשקות, והוא מופיע בסוגריים בתווית.
- כדי להתחיל את החזרה לגרסה קודמת, לוחצים על יצירה.
שינוי הגדרות ההשקה
אתם יכולים לשנות את ההסתעפות הפעילה להשקות ולהשבית או להפעיל השקות אוטומטיות באמצעות אמצעי הבקרה בתצוגה Settings > Deployment במרכז הבקרה של הקצה העורפי.
- במסוף Firebase, נכנסים אל Hosting & Serverless > App Hosting.
- לוחצים על View בקצה העורפי שבו רוצים לעדכן את הגדרות ההשקה.
- בלוח הבקרה של הקצה העורפי, לוחצים על Settings (הגדרות). בתצוגת ברירת המחדל מוצג מידע על דומיינים ודומיינים מותאמים אישית.
- בוחרים בתצוגה Deployment. בתצוגה הזו אפשר לשנות את הענף הפעיל להשקות, ולהשבית או להפעיל השקות אוטומטיות. בנוסף, יש אפשרויות להגדיר את תיקיית שורש של האפליקציה ואת הסביבה של הבק-אנד (ראו פריסה בסביבות מרובות).
ניהול ההשקות האוטומטיות
כברירת מחדל, App Hosting מניח שרשימת הקבצים "הנדרשים" כוללת את כל הקבצים, כלומר כל commit חדש למאגר מפעיל build והשקה חדשים. עם זאת, כדי לחסוך זמן ולמנוע פריסות מיותרות, אתם יכולים להגדיר ל-App Hosting לדלג על גרסאות build על סמך נתיבי הקבצים הספציפיים ששונו ב-commit.
אפשר להגדיר את זה בקטע הגדרות > השקות > טריגרים להשקה. כאן אפשר להשאיר את השדה Required Paths ריק אם רוצים שכל commit חדש למאגר יפעיל build והשקה חדשים, או לציין בדיוק אילו ספריות או קבצים תמיד יפעילו השקה. אם אתם מציינים ספריות, חשוב להוסיף את כל הנתיבים שבהם שינויים אמורים להפעיל השקה.
ספריות או קבצים שתוסיפו ל-Ignored Paths אף פעם לא יפעילו השקה אוטומטית. אם ספריית משנה נכללת גם ברשימת הספריות הנדרשות וגם ברשימת קטעי הקוד להתעלמות, השקה אוטומטית לא תופעל. אם מאכלסים רק את רשימת הנתיבים להתעלמות, App Hosting יאכלס באופן אוטומטי את הערך "*" בנתיבים הנדרשים.
אם תדחפו commit שבו אף אחד מהקבצים שהשתנו לא תואם לנתיבים הנדרשים (או אם כל השינויים הוחרגו באופן מפורש על ידי הנתיבים שהתעלמתם מהם), App Hosting עדיין יאשר את קבלת האירוע ב-GitHub, אבל יסמן את מצבי ה-build וההשקה כ-SKIPPED, ולא תופעל השקה אוטומטית.