📘 תיעוד 222

העלאה ישירה

עודכן לאחרונה: 21 באפריל 2026

העלאה ישירה מאפשרת להעלות את הנכסים שנבנו מראש אל Pages ולפרוס אותם ברשת הגלובלית של Cloudflare. כדאי לבחור בהעלאה ישירה במקום באינטגרציית Git אם רוצים לשלב פלטפורמת בנייה משלכם או להעלות מהמחשב המקומי.

המדריך הזה מסביר איך להעלות את הנכסים באמצעות Wrangler או בשיטת גרירה ושחרור.

אי אפשר לעבור לאינטגרציית Git אחר כך

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

#דרישות מוקדמות

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

#שיטות העלאה

אחרי שהנכסים שנבנו מראש מוכנים, יש שתי דרכים להתחיל בהעלאה:

• Wrangler.
• גרירה ושחרור.

הערה

בתוך פרויקט של העלאה ישירה אפשר לעבור בין יצירת פריסות באמצעות Wrangler או באמצעות גרירה ושחרור. בפרויקטים קיימים עם אינטגרציית Git אפשר ליצור פריסות באופן ידני באמצעות wrangler deploy. עם זאת, אי אפשר להשתמש בגרירה ושחרור בלוח הבקרה עם פרויקטים קיימים שמשולבים ב-Git.

#סוגי קבצים נתמכים

להלן סוגי הקבצים הנתמכים לכל אחת מאפשרויות ההעלאה הישירה:

• Wrangler: תיקייה אחת של נכסים. (קובצי Zip אינם נתמכים.)
• גרירה ושחרור: קובץ zip או תיקייה אחת של נכסים.

#ממשק שורת הפקודה Wrangler

#הגדרת Wrangler

כדי להתחיל, התקינו את npm ↗︎. לאחר מכן התקינו את Wrangler, ממשק שורת הפקודה של פלטפורמת המפתחים.

#יצירת הפרויקט

התחברו ל-Wrangler באמצעות הפקודה wrangler login. לאחר מכן הריצו את הפקודה pages project create:

npx wrangler pages project create

לאחר מכן תופיע בקשה לציין את שם הפרויקט. הפרויקט יוצג בכתובת <PROJECT_NAME>.pages.dev (או שם הפרויקט בתוספת כמה תווים אקראיים אם שם הפרויקט כבר תפוס). תופיע גם בקשה לציין את ענף הייצור.

פריסות נוספות ישתמשו מחדש בשני הערכים האלה (שנשמרים בתיקייה node_modules/.cache/wrangler).

#פריסת הנכסים

מכאן, יצרתם פרויקט ריק ואפשר עכשיו לפרוס את הנכסים לפריסה הראשונה ולכל הפריסות הבאות בסביבת הייצור. כדי לעשות זאת, הריצו את הפקודה wrangler pages deploy:

npx wrangler pages deploy <BUILD_OUTPUT_DIRECTORY>

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

פריסת הייצור תהיה זמינה בכתובת <PROJECT_NAME>.pages.dev.

הערה

לפני השימוש בפקודה wrangler pages deploy, צריך לוודא שאתם בתוך הפרויקט. אם לא, אפשר גם להעביר את נתיב הפרויקט.

כדי לפרוס נכסים לסביבת תצוגה מקדימה, הריצו:

npx wrangler pages deploy <OUTPUT_DIRECTORY> --branch=<BRANCH_NAME>

לכל ענף שיוצרים, כינוי ענף יהיה זמין בכתובת <BRANCH_NAME>.<PROJECT_NAME>.pages.dev.

הערה

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

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

#פקודות שימושיות נוספות

אם רוצים להשתמש ב-Wrangler כדי לקבל רשימה של כל הפרויקטים הזמינים להעלאה ישירה, השתמשו ב-pages project list:

npx wrangler pages project list

כדי לקבל את הפלט כ-JSON לשימוש תכנותי או לסקריפטים, השתמשו בדגל --json:

npx wrangler pages project list --json

אם רוצים להשתמש ב-Wrangler כדי לקבל רשימה של כל כתובות ה-URL הייחודיות לתצוגה מקדימה של פרויקט מסוים, השתמשו ב-pages deployment list:

npx wrangler pages deployment list

להנחיות צעד אחר צעד על שימוש ב-Wrangler ובכלי אינטגרציה רציפה כמו GitHub Actions, Circle CI ו-Travis CI יחד לפריסה רציפה, ראו שימוש בהעלאה ישירה עם אינטגרציה רציפה.

#גרירה ושחרור

#פריסת הפרויקט בגרירה ושחרור

כדי לפרוס בגרירה ושחרור:

1. בלוח הבקרה של Cloudflare, עברו אל הדף Workers & Pages. מעבר אל Workers & Pages ↗
2. בחרו Create application > Get started > Drag and drop your files.
3. הזינו את שם הפרויקט בשדה שסופק, וגררו ושחררו את הנכסים.
4. בחרו Deploy site.

הפרויקט יוצג מהכתובת <PROJECT_NAME>.pages.dev. לאחר מכן גררו ושחררו את תיקיית פלט הבנייה לתוך מסגרת ההעלאה. אחרי שהקבצים הועלו בהצלחה, בחרו Save and Deploy והמשיכו אל הפרויקט שנפרס זה עתה.

#יצירת פריסה חדשה

אחרי שהפרויקט נוצר, בחרו Create a new deployment כדי להתחיל גרסה חדשה של האתר. לאחר מכן, בחרו אם הפריסה החדשה תיעשה לסביבת הייצור או לסביבת התצוגה המקדימה. אם בוחרים בתצוגה מקדימה, אפשר ליצור ענף פריסה חדש או להזין ענף קיים.

#פתרון בעיות

#מגבלות

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

#הגדרת ענף הייצור

אם הפרויקט הוא פרויקט העלאה ישירה, לא תהיה אפשרות להגדיר בקרות של ענף הייצור. כדי לעדכן את ענף הייצור, צריך לקרוא באופן ידני לנקודת הקצה Update Project ב-API.

curl --request PATCH \
"https://api.cloudflare.com/client/v4/accounts/{account_id}/pages/projects/{project_name}" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data "{\"production_branch\": \"main\"}"

#פונקציות

פריסות בגרירה ושחרור שנעשות מלוח הבקרה של Cloudflare אינן תומכות כרגע בהידור של תיקיית functions של Pages Functions. כדי לפרוס תיקיית functions, חובה להשתמש ב-Wrangler. כשפורסים פרויקט באמצעות Wrangler, אם קיימת תיקיית functions במקום שבו הפקודה רצה, תיקיית functions הזו תועלה עם הפרויקט.

עם זאת, שימו לב שקובץ _worker.js נתמך גם ב-Wrangler וגם בפריסות גרירה ושחרור שנעשות מהלוח.