פריסה בשידור חי & תצוגה מקדימה של ערוצים באמצעות בקשות משיכה ב-GitHub

אפשר לשלב פריסות ב-Firebase Hosting באמצעות GitHub Action. כך תוכלו להשתמש בפעולה הזו ב-GitHub:

  • הכלי יוצר ערוץ תצוגה מקדימה חדש (וכתובת ה-URL המשויכת לתצוגה המקדימה) לכל בקשת תיקון (PR) במאגר שלכם ב-GitHub.

  • המערכת תוסיף הערה לבקשת הערעור עם כתובת ה-URL של התצוגה המקדימה, כדי שתוכלו לבדוק את השינויים שבבקשת הערעור בגרסה 'preview' של האפליקציה.

    תמונה של תגובה בבקשת PR ב-GitHub Action עם כתובת URL לתצוגה מקדימה

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

  • (אופציונלי) פריסת המצב הנוכחי של המאגר ב-GitHub בערוץ החי אחרי המיזוג של ה-PR.

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

הגדרת GitHub Action לפריסה ב-Firebase Hosting

  1. יוצרים מאגר ב-GitHub (ציבורי או פרטי) או משתמשים במאגר קיים. צריכות להיות לכם הרשאות אדמין במאגר.

  2. בגרסה המקומית של המאגר, מגדירים את Firebase Hosting באמצעות הפקודה firebase init.

    • אם לא הגדרתם את Hosting, מריצים את הגרסה הזו של הפקודה מהשורש של הספרייה המקומית:

      firebase init hosting
    • אם כבר הגדרתם את Hosting, עליכם רק להגדיר את החלק של GitHub Action ב-Hosting. מריצים את הגרסה הזו של הפקודה מהרמה הבסיסית (root) של הספרייה המקומית:

      firebase init hosting:github
  3. פועלים לפי ההנחיות ב-CLI, והפקודה תבצע באופן אוטומטי את ההגדרה של GitHub Action:

    • יצירת חשבון שירות בפרויקט Firebase עם הרשאה לפריסה ב-Firebase Hosting.

    • הצפנת מפתח ה-JSON של חשבון השירות הזה והעלאה שלו למאגר GitHub שצוין בתור סוד GitHub.

    • כתיבת קובצי תצורה של תהליך עבודה ב-GitHub מסוג yaml שמפנים לסוד שנוצר. הקבצים האלה מגדירים את GitHub Action לפריסה ב-Firebase Hosting.

  4. ב-GitHub, יוצרים הסתעפות חדשה ומבצעים השמירה (commit) של קובצי yaml של תהליך העבודה שנוצרו על ידי ה-CLI.

  5. מפרסמים את ההסתעפות במאגר שלכם ב-GitHub.

  6. ממזגים את ההסתעפות.

זהו זה! לכל בקשת המשיכה הבאה במאגר הזה ב-GitHub תהיה 'כתובת URL של תצוגה מקדימה' משלה באופן אוטומטי.

מידע נוסף על GitHub Action

  • Firebase מטפלת ב-GitHub Action‏ 'פריסה ל-Firebase Hosting' כפרויקט בקוד פתוח. הצגת קוד המקור

  • אפשר להגדיר עוד פרטים ב-GitHub Action 'פריסה אל Firebase Hosting', למשל להתאים אישית את תאריך התפוגה של ערוץ תצוגה מקדימה או להגדיר ערוץ שלא פעיל לפריסה כשממזגים בקשת תיקון (PR). מידע על אפשרויות ההגדרה הזמינות

  • מידע נוסף על GitHub Actions