תיעוד 246
מטמון בנייה
עודכן לאחרונה: 27 במאי 2026
שפרו את זמני הבנייה של Pages על ידי שמירת תלויות ופלט בנייה במטמון בין בניות, באמצעות מטמון משותף לכל הפרויקט.
הבנייה הראשונה שתתרחש לאחר הפעלת מטמון הבנייה בפרויקט ה-Pages שלכם תישמר במטמון. כל בנייה לאחר מכן תשוחזר מהמטמון, אלא אם הוגדר אחרת.
#אודות מטמון הבנייה
כשהאפשרות מופעלת, מטמון הבנייה יזהה אוטומטית נתונים מכל בנייה וישמור אותם במטמון. עיינו במסגרות כדי לבדוק אילו תיקיות נשמרות ומשוחזרות אוטומטית ממטמון הבנייה.
#דרישות
מטמון בנייה דורש את מערכת הבנייה V2 או גרסה מאוחרת יותר. לעדכון מ-V1, עיינו בהוראות המעבר למערכת הבנייה V2.
#מנהלי חבילות
Pages ישמור במטמון את תיקיות המטמון הגלובליות של מנהלי החבילות הבאים:
| מנהל חבילות | תיקיות שנשמרות במטמון |
|---|---|
| npm ↗︎ | .npm |
| yarn ↗︎ | .cache/yarn |
| pnpm ↗︎ | .pnpm-store |
| bun ↗︎ | .bun/install/cache |
#מסגרות
חלק מהמסגרות מספקות תיקיית מטמון, שבדרך כלל מתמלאת על ידי המסגרת בפלטי בנייה ביניים או בתלויות בזמן הבנייה. Pages יזהה אוטומטית את המסגרת שבה אתם משתמשים, וישמור תיקייה זו במטמון לשימוש חוזר בבניות הבאות.
המסגרות הבאות תומכות בשמירת פלט בנייה במטמון:
| מסגרת | תיקיות שנשמרות במטמון |
|---|---|
| Astro | node_modules/.astro |
| Docusaurus | node_modules/.cache, .docusaurus, build |
| Eleventy | .cache |
| Gatsby | .cache, public |
| Hugo | .cache |
| Next.js | .next/cache |
| Nuxt | node_modules/.cache/nuxt |
| SvelteKit | node_modules/.cache/imagetools |
#מטמון בנייה של Hugo
Hugo אינו משתמש ב-.cache כברירת מחדל. כדי להשתמש במטמון בנייה עם Hugo, הגדירו את --cacheDir=$PWD/.cache בפקודת הבנייה. לדוגמה:
hugo --minify --cacheDir=$PWD/.cachePages מזהה פרויקטי Hugo לפי נוכחות קובץ תצורה hugo.toml, hugo.yaml, hugo.yml או hugo.json.
#מגבלות
המגבלות הבאות חלות על מטמון בנייה:
- שמירה: המטמון נמחק שבעה ימים אחרי תאריך הקריאה האחרון שלו. פריטי מטמון שלא נקראו נמחקים שבעה ימים אחרי היצירה.
- אחסון: לכל פרויקט מוקצים 10 GB. אם מטמון הפרויקט חורג מהמגבלה הזו, הפרויקט יתחיל אוטומטית למחוק פריטים שנקראו הכי פחות לאחרונה.
#הפעלת מטמון בנייה
כדי להפעיל מטמון בנייה:
- עברו אל Workers & Pages בלוח הבקרה של Cloudflare. מעבר אל Workers & Pages ↗
- מצאו את פרויקט ה-Pages שלכם.
- עברו אל Settings > Build > Build cache.
- בחרו ב-Enable כדי להפעיל את מטמון הבנייה.
#ניקוי מטמון הבנייה
אפשר לנקות את מטמון הבנייה של פרויקט בעת הצורך, למשל בזמן איתור תקלות בבנייה. כדי לנקות את מטמון הבנייה:
- עברו אל Workers & Pages בלוח הבקרה של Cloudflare. מעבר אל Workers & Pages ↗
- מצאו את פרויקט ה-Pages שלכם.
- עברו אל Settings > Build > Build cache.
- בחרו ב-Clear Cache כדי לנקות את מטמון הבנייה.