תיעוד 49
תצורת בנייה
עודכן לאחרונה: 18 בספטמבר 2026 | הצג כ-Markdown | הגדרת סוכן
באפשרותך להגדיר ל-Cloudflare Pages כיצד יש לבנות את האתר שלך, וכן היכן ימוקמו קובצי הפלט שלו.
#פקודות ותיקיות בנייה
עליך לספק פקודת בנייה כדי להודיע ל-Cloudflare Pages כיצד לבנות את היישום שלך. עבור פרויקטים שאינם מופיעים כאן, מומלץ לקרוא את התיעוד של הכלי או סביבת הפיתוח (framework), ולהגיש pull request כדי להוסיף אותו לכאן.
תיקיות בנייה מציינות היכן פקודת הבנייה של הפרויקט מוציאה כפלט את הגרסה הבנויה של אתר ה-Cloudflare Pages שלך. לעיתים קרובות, ברירת המחדל היא התקן המקובל בתעשייה public, אך ייתכן שתגלה שעליך להתאים אותה אישית.
הבנת תצורת הבנייה שלך
פקודת הבנייה מסופקת על ידי סביבת הפיתוח שלך. לדוגמה, סביבת הפיתוח Gatsby משתמשת ב-gatsby build כפקודת הבנייה שלה. כאשר אתה עובד ללא סביבת פיתוח, השאר את השדה Build command ריק. Pages קובע אם בנייה הצליחה או נכשלה על ידי קריאת קוד היציאה שמוחזר מפקודת הבנייה שסופקה על ידי המשתמש. כל קוד חזרה שאינו אפס יגרום לבנייה להיות מסומנת ככזו שנכשלה. קוד יציאה של 0 יגרום לבנייה של Pages להיות מסומנת כמוצלחת ומשאבים יועלו ללא קשר לשאלה אם נכתבו יומני שגיאות אל standard error.
תיקיית הבנייה נוצרת מתוך פקודת הבנייה. לכל סביבת פיתוח יש מוסכמת שמות משלה, לדוגמה, תיקיית פלט הבנייה נקראת /public בסביבות פיתוח רבות.
תיקיית השורש היא המקום שבו נמצא תוכן האתר שלך. אם לא צוינה, Cloudflare מניחה שמאגר ה-git המקושר שלך הוא תיקיית השורש. יש לציין את תיקיית השורש במקרים כמו monorepos, שבהם עשויים להיות מספר פרויקטים במאגר אחד.
#ערכות מוגדרות מראש עבור סביבות פיתוח (Framework presets)
Cloudflare מתחזקת רשימה של תצורות בנייה עבור סביבות פיתוח וכלים פופולריים. אלה נגישות במהלך יצירת הפרויקט. להלן מספר פקודות ותיקיות בנייה סטנדרטיות עבור סביבות פיתוח וכלים פופולריים.
אם אינך משתמש בהגדרה מוכנה מראש (preset), השתמש ב-exit 0 בתור ה-Build command שלך.
סביבת פיתוח/כלי (Framework/tool) | פקודת בנייה (Build command) | תיקיית בנייה (Build directory) |
|---|---|---|
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 |
#משתני סביבה (Environment variables)
אם הפרויקט שלך עושה שימוש במשתני סביבה כדי לבנות את האתר שלך, באפשרותך לספק משתני סביבה מותאמים אישית:
- בלוח הבקרה של
Cloudflare, עבור אל הדף Workers & Pages. מעבר אל Workers & Pages ↗ - בחר את פרויקט ה-
Pagesשלך. - בחר Settings > Environment variables.
משתני הסביבה הבאים של המערכת מוזרקים כברירת מחדל (אך ניתן לעקוף אותם):
משתנה סביבה (Environment Variable) | ערך מוזרק (Injected value) | דוגמה למקרה שימוש (Example use-case) |
|---|---|---|
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> | התאמה אישית של הבנייה לפי ענף, לדוגמה, השבתת רישום יומני ניפוי שגיאות בסביבת production |
CF_PAGES_URL | <url-of-current-deployment> | מתן אפשרות לכלי הבנייה לדעת מהי כתובת ה-URL שבה הדף ייפרס |