📘 תיעוד 50

תמונת בנייה

עודכן לאחרונה: 18 בספטמבר 2026

סביבת הבנייה של Cloudflare Pages כוללת תמיכה רחבה במגוון שפות, כגון Ruby, Node.js, Python, PHP ו-Go.

אם עליך להשתמש בגרסה מסוימת של שפה (לדוגמה, Node.js או Ruby), באפשרותך לציין אותה על ידי הגדרת משתנה סביבה תואם בהגדרות הבנייה שלך, או על ידי הגדרת הקובץ הרלוונטי בקוד המקור שלך.

#שפות וכלים נתמכים

בטבלאות הבאות תוכל לבדוק את הגרסאות המותקנות מראש עבור שפות וכלים הכלולים בתמונת הבנייה של Cloudflare Pages, ואת משתני הסביבה ו/או הקבצים הזמינים לצורך עקיפת הגרסה המותקנת מראש:

#שפות וסביבות ריצה

#v3

#v2

#v1

כל גרסה

תחת גרסאות נתמכות, "כל גרסה" מתייחס לתמיכה בכל הגרסאות של השפה או הכלי, כולל גרסאות חדשות יותר מגרסת ברירת המחדל.

#כלים

#v3

#v2

#v1

כל גרסה

תחת גרסאות נתמכות, "כל גרסה" מתייחס לתמיכה בכל הגרסאות של השפה או הכלי, כולל גרסאות חדשות יותר מגרסת ברירת המחדל.

#פריימוורקים

כדי להשתמש בגרסה מסוימת של פריימוורק, ציין אותה בקובץ ההגדרות של מנהל החבילות בפרויקט. לדוגמה, אם אתה משתמש ב-Gatsby, קובץ ה-package.json שלך צריך לכלול את הדברים הבאים:

"dependencies": {
	"gatsby": "^5.13.7",
}

כאשר הבנייה שלך מתחילה, אם היא עדיין לא במטמון, גרסה 5.13.7 של Gatsby תותקן באמצעות npm install.

#הגדרות מתקדמות

#עקיפת גרסאות ברירת מחדל

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

כדי להגדיר את הגרסה באמצעות משתני סביבה, באפשרותך:

1. למצוא את שם משתנה הסביבה עבור השפה או הכלי בטבלה זו.
2. להוסיף את משתנה הסביבה בלוח הבקרה על ידי מעבר אל Settings > Environment variables בפרויקט ה-Pages שלך, או להוסיף את משתנה הסביבה באמצעות Wrangler.

או, כדי להגדיר את הגרסה על ידי הוספת קובץ לפרויקט שלך, באפשרותך:

1. למצוא את שם הקובץ עבור השפה או הכלי בטבלה זו.
2. להוסיף את שם הקובץ שצוין לתיקיית השורש של הפרויקט שלך, ולהוסיף את מספר הגרסה הרצוי כתוכן הקובץ.

לדוגמה, אם הסתמכת בעבר על גרסת ברירת המחדל של Node.js במערכת הבנייה v1, כדי להגר ל-v2 עליך לציין שאתה זקוק ל-Node.js בגרסה 12.18.0 על ידי הגדרת משתנה סביבה NODE_VERSION = 12.18.0, או על ידי הוספת קובץ .node-version או .nvmrc לפרויקט שלך כאשר הערך 12.18.0 מוגדר כתוכן הקובץ.

#דילוג על התקנת תלויות

באפשרותך להוסיף את משתנה הסביבה הבא כדי לבטל התקנה אוטומטית של תלויות, ולהריץ במקום זאת פקודת התקנה מותאמת אישית:

#מערכת בנייה v3

מערכת הבנייה v3 מעדכנת את כלי ברירת המחדל, הספריות והשפות לגרסאות ה-LTS שלהם, נכון למאי 2025.

#הגירה מ-v2 ל-v3

כדי להגר לגרסה חדשה זו, הגדר את הגדרות פרויקט ה-Pages שלך בלוח הבקרה:

1. בלוח הבקרה של Cloudflare, עבור לדף Workers & Pages. מעבר אל Workers & Pages ↗
2. בחר את פרויקט ה-Pages שלך.
3. עבור אל Deployments > All deployments > ובחר את הגרסה העדכנית ביותר.

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

#מגבלות

היכולות הבאות אינן נתמכות כעת בעת שימוש במערכת הבנייה v3:

• ציון גרסאות Node.js כשמות קוד (לדוגמה, hydrogen או lts/hydrogen).
• זיהוי גרסת Yarn מגרסת הקובץ yarn.lock.
• זיהוי גרסת pnpm המבוסס על גרסת הקובץ pnpm-lock.yaml.
• זיהוי Node.js ומנהלי חבילות מתוך package.json -> "engines".
• תמיכה ב-pipenv וב-Pipfile.

#סביבת בנייה

תהליכי בנייה ב-Cloudflare Pages רצים בתוך קונטיינר gVisor ↗.

#v3

#v2

#v1

#מדיניות תמונת הבנייה

#הוצאה משימוש של גרסאות תמונת הבנייה

אם אתה משתמש כעת בתמונת הבנייה v1 או v2, הפרויקט שלך יועבר אוטומטית ל-v3:

• תמונת בנייה v1: אם אתה משתמש בתמונת הבנייה של Pages גרסה v1, הפרויקט שלך יועבר אוטומטית ל-v3 ב-15 בספטמבר 2026.
• תמונת בנייה v2: אם אתה משתמש בתמונת הבנייה של Pages גרסה v2, הפרויקט שלך יועבר אוטומטית ל-v3 ב-23 בפברואר 2027.

תקבל הודעה של 6 חודשים מראש לפני מועד ההוצאה משימוש באמצעות יומן השינויים של Cloudflare ↗, התראות בלוח הבקרה ודוא"ל.

בהמשך, תמונת הבנייה v3 תקבל עדכונים שוטפים עבור תוכנות המותקנות מראש לפי המדיניות המפורטת להלן. לא יהיו שינויי גרסאות נוספים של תמונת הבנייה.

#עדכוני תוכנה מותקנת מראש

תוכנות המותקנות מראש (שפות וכלים) יעודכנו לפני שיגיעו לסוף מחזור החיים שלהן (EOL). עדכונים אלה חלים רק אם לא עקפת את גרסת ברירת המחדל.

• עדכוני גרסה משניים (Minor): עשויים להתעדכן לגרסה המשנית העדכנית ביותר הזמינה ללא הודעה מוקדמת. עבור כלים שאינם פועלים לפי ניהול גרסאות סמנטי (לדוגמה, Bun או Hugo), עדכונים שעשויים לכלול שינויים שוברים יקבלו הודעה של 3 חודשים מראש.
• עדכוני גרסה ראשיים (Major): יעודכנו לגרסת התמיכה לטווח ארוך (LTS) היציבה הבאה עם הודעה של 3 חודשים מראש.

כיצד תקבל הודעה (עבור שינויים הדורשים הודעה מראש):

• יומן השינויים של Cloudflare ↗
• התראות בלוח הבקרה עבור פרויקטים שיקבלו את העדכון
• הודעות דוא"ל לבעלי הפרויקט

כדי לשמור על גרסה מסוימת ולהימנע מעדכונים אוטומטיים, עקוף את גרסת ברירת המחדל.

#שיטות מומלצות

כדי למנוע כשלי בנייה בלתי צפויים:

• עקוב אחר הודעות באמצעות יומן השינויים של Cloudflare ↗, התראות בלוח הבקרה ודוא"ל
• תכנן את ההגירה כאשר אתה מקבל הודעות על עדכונים
• קבע גרסאות ספציפיות של תוכנות קריטיות המותקנות מראש על ידי עקיפת גרסאות ברירת המחדל