תהליך ה-build של App Hosting

‫Firebase App Hosting משתמש ב-Cloud Build כדי להפוך את קוד המקור של האפליקציה לפורמט בקונטיינר שמתאים לפריסה ב-Cloud Run.

תהליך היצירה פועל בשלבים העיקריים הבאים:

  1. ubuntu: אתחול סביבת העבודה.

  2. ‫preparer: אוסף את קוד המקור וההגדרות של האפליקציה.

  3. ‫pre-buildpack: הכנת הסביבה של ה-buildpack.

  4. ‫build: מתקין את יחסי התלות ויוצר את האפליקציה.

  5. בעל תוכן דיגיטלי: משלים את מאגר התגים של Cloud Run בסביבת הייצור.

חמשת השלבים האלה תואמים ישירות לשלבי ה-build שמוצגים ב-Cloud Build במסוף Google Cloud:

צילום מסך של תצוגת השלבים של Cloud Build במסוף Google Cloud

הפעלת Workspace

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

מכין הדוח

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

לפני Buildpack

בשלב הזה מכינים את הסביבה למחזור החיים של Cloud Native Buildpacks. השלב הזה כולל הפעלת shim שמתרגם את ההגדרות ומשתני הסביבה שהוכנו בשלב הקודם לפורמט שצפוי על ידי כלי ה-CNB.

אני רוצה לבנות

זהו החלק העיקרי בתהליך ה-build, שאחראי ליצירת קובץ אימג' בקונטיינר שאפשר להריץ וקובץ bundle.yaml שמגדיר את תצורת ה-build. הוא משתמש ב-Cloud Native Buildpacks ובקובץ הבינארי lifecycle creator כדי לארוז את האפליקציה ביעילות. מידע נוסף על הקובץ bundle.yaml זמין ב-GitHub.

ה-buildpacks אחראים להפוך את קוד המקור של האפליקציה לקובצי אימג' של קונטיינרים שמוכנים לייצור. ‫Firebase App Hosting מחבר יחד כמה חבילות buildpack כדי להשלים את תהליך ה-build:

  1. ‫Runtime Buildpack: מוודא שכל הרכיבים שדרושים להרצת אפליקציית Node.js בסיסית כלולים, ושיחסי התלות מותקנים.
  2. ‫Monorepo Buildpack: מגדיר את ה-buildpacks הבאים כדי לטפל בתרחישים שונים של מונוריפו.
  3. ‫Framework Buildpack: מתקין את מתאם ה-framework הנכון (כמו Angular או Next.js) ומכין את ה-buildpacks הבאים.

    מתאמי Framework אחראים להפעלת פקודת ה-build בסביבת הייצור ולמיפוי של כל ערכי ההגדרות הרלוונטיים הספציפיים ל-Framework לפורמט סטנדרטי שניתן לקריאה על ידי App Hosting.

  4. ‫Package Manager Buildpack: מפעיל את ההתקנה של יחסי התלות ויוצר את האפליקציה באמצעות npm,‏ yarn או pnpm.

  5. Output Bundle Buildpack: מגדיר את פקודת ההרצה ומכין את חבילת הפלט להפעלה.

בעל תוכן דיגיטלי

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

מדיניות ניקוי של גרסאות build

Firebase App Hosting אוכף מדיניות אוטומטית של שמירה וניקוי של גרסאות build. לפי המדיניות הזו, App Hosting שומר את גרסאות ה-Build המוצלחות ואת הגרסאות המשויכות של Cloud Run מ-14 הימים האחרונים. בנוסף, כדי לוודא שתמיד יהיה לכם build שאפשר לחזור אליו, המערכת של App Hosting שומרת את 5 ה-builds וההשקות האחרונים שהצליחו, בלי קשר לגיל שלהם.

‫App Hosting לא ימחק או יסיר גרסה שנמצאת כרגע בחלוקת התנועה הפעילה או שמשויכת להשקה שמתבצעת.

כשגרסאות build ישנות יותר חורגות ממגבלות השמירה האלה, הסטטוס הפנימי שלהן מתעדכן ל-EXPIRED. אי אפשר לבצע חזרה מיידית לגרסה קודמת של גרסת build מסוג EXPIRED, והאפשרות לחזור לגרסאות ה-build האלה תוסר ממסוף Firebase. במקום זאת, תצטרכו ליצור גרסה חדשה שמטרגטת את אותו המקור (git commit, קונטיינר ב-Artifact Registry או קטגוריה ב-Google Cloud Storage) ולהשיק אותה.

אחת הדרכים לחסוך במשאבי build היא לשלוט בתדירות שבה מפעילים השקות אוטומטיות. איך מנהלים השקות אוטומטיות

מידע נוסף

כל תהליך הפיתוח של App Hosting הוא בקוד פתוח.