תיעוד 247
הגדרת בנייה
עודכן לאחרונה: 18 בספטמבר 2026. לפי התיעוד הרשמי.
אפשר לומר ל-Cloudflare Pages איך האתר צריך להיבנות, וגם איפה קובצי הפלט שלו יהיו.
#פקודות בנייה וספריות
יש לספק פקודת בנייה כדי לומר ל-Cloudflare Pages איך לבנות את היישום. בפרויקטים שלא מופיעים כאן, כדאי לקרוא את התיעוד של הכלי או של ה-framework, ולהגיש pull request כדי להוסיף אותו כאן.
ספריות הבנייה מציינות איפה פקודת הבנייה של הפרויקט מוציאה את הגרסה הבנויה של אתר Cloudflare Pages. לעתים קרובות ברירת המחדל היא public לפי הסטנדרט המקובל בתעשייה, אבל ייתכן שתצטרכו להתאים אותה.
#הבנת הגדרת הבנייה
פקודת הבנייה מסופקת על ידי ה-framework. לדוגמה, ה-framework Gatsby משתמש ב-gatsby build כפקודת הבנייה שלו. כשעובדים בלי framework, משאירים את השדה Build command ריק. Pages קובע אם בנייה הצליחה או נכשלה לפי קוד היציאה שחוזר מפקודת הבנייה שהמשתמש סיפק. כל קוד החזרה שאינו אפס יגרום לסימון הבנייה כנכשלת. קוד יציאה 0 יגרום לסימון בנייה של Pages כמוצלחת, והנכסים יועלו גם אם נכתבו יומני שגיאה אל standard error.
ספריית הבנייה נוצרת מפקודת הבנייה. לכל framework יש מוסכמת שמות משלו. לדוגמה, ספריית פלט הבנייה נקראת /public בהרבה frameworks.
ספריית השורש היא המקום שבו תוכן האתר נמצא. אם לא מציינים אותה, Cloudflare מניח שמאגר ה-git המקושר הוא ספריית השורש. צריך לציין את ספריית השורש במקרים כמו monorepos, שבהם יכולים להיות כמה פרויקטים במאגר אחד.
#הגדרות מוכנות של frameworks
Cloudflare מתחזק רשימה של הגדרות בנייה ל-frameworks ולכלים נפוצים. אלה זמינים במהלך יצירת הפרויקט. להלן כמה פקודות בנייה וספריות סטנדרטיות ל-frameworks ולכלים נפוצים.
אם לא משתמשים בהגדרה מוכנה, השתמשו ב-exit 0 כ-Build command.
| framework/כלי | פקודת בנייה | ספריית בנייה |
|---|---|---|
| React (Vite) | npm run build | dist |
| Gatsby | npx gatsby build | public |
| Next.js (Static HTML Export) | npx next build | out |
| Nuxt.js | npm run build | dist |
| Qwik | npm run build | dist |
| Remix | npm run build | build/client |
| Svelte | npm run build | public |
| SvelteKit | npm run build | .svelte-kit/cloudflare |
| Vue | npm run build | dist |
| Analog | npm run build | dist/analog/public |
| Astro | npm run build | dist |
| Angular | npm run build | dist/cloudflare |
| Brunch | npx brunch build --production | public |
| Docusaurus | npm run build | build |
| Elder.js | npm run build | public |
| Eleventy | npx @11ty/eleventy | _site |
| Ember.js | npx ember-cli build | dist |
| GitBook | npx gitbook-cli build | _book |
| Gridsome | npx gridsome build | dist |
| Hugo | hugo | public |
| Jekyll | jekyll build | _site |
| MkDocs | mkdocs build | site |
| Pelican | pelican content | output |
| React Static | react-static build | dist |
| Slate | ./deploy.sh | build |
| Umi | npx umi build | dist |
| VitePress | npx vitepress build | .vitepress/dist |
| Zola | zola build | public |
#משתני סביבה
אם הפרויקט משתמש במשתני סביבה כדי לבנות את האתר, אפשר לספק משתני סביבה מותאמים אישית:
- בלוח הבקרה של Cloudflare, עברו אל הדף Workers & Pages. מעבר אל Workers & Pages
- בחרו את פרויקט Pages שלכם.
- בחרו Settings > Environment variables.
משתני הסביבה של המערכת הבאים מוזרקים כברירת מחדל (אבל אפשר לדרוס אותם):
| משתנה סביבה | ערך מוזרק | דוגמה לשימוש |
|---|---|---|
CI | true | שינוי התנהגות הבנייה כשהיא רצה ב-CI לעומת הרצה מקומית |
CF_PAGES | 1 | שינוי התנהגות הבנייה כשהיא רצה ב-Pages לעומת הרצה מקומית |
CF_PAGES_COMMIT_SHA | <sha1-hash-of-current-commit> | העברת מזהה ה-commit הנוכחי לדיווח שגיאות, לדוגמה, Sentry |
CF_PAGES_BRANCH | <branch-name-of-current-deployment> | התאמת הבנייה לפי הענף, לדוגמה, השבתת יומן debug ב-production |
CF_PAGES_URL | <url-of-current-deployment> | מתן אפשרות לכלי הבנייה לדעת את כתובת ה-URL שאליה הדף ייפרס |