📘 תיעוד 195

תחילת העבודה

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

אפשר ליצור Preview ל-Worker חדש או קיים. אין צורך לפרוס Worker לייצור לפני יצירת ה-Preview הראשון שלו.

#לפני שמתחילים

Worker Previews דורש Wrangler 4.135.0 או גרסה חדשה יותר. עדכנו את תלות הפרויקט, כי פקודות הפרויקט לא משתמשות בהתקנה גלובלית חדשה יותר.

npm:

npm i -D wrangler@latest

yarn:

yarn add -D wrangler@latest

pnpm:

pnpm add -D wrangler@latest

bun:

bun add -d wrangler@latest

#שלב 1: הגדרת הגדרות Preview

הוסיפו בלוק previews לקובץ ההגדרות של Wrangler. הגדרות ברמה העליונה מגדירות ייצור, ובלוק previews מגדיר הגדרות Preview. בלוק previews יכול להיות ריק אם ה-Preview לא צריך הגדרות נפרדות.

{
  // ...
  "vars": {
    "ENVIRONMENT": "production"
  },
  // ...
  "previews": {
    // ...
    "vars": {
      "ENVIRONMENT": "preview"
    }
    // ...
  }
}

[vars]
ENVIRONMENT = "production"

[previews.vars]
ENVIRONMENT = "preview"

כדי לקבוע אילו הגדרות שייכות לרמה העליונה ואילו לבלוק previews, ראו מה נכנס לבלוק previews.

הגדרות שמוסיפים או מייבאים בלוח הבקרה צריך גם להעתיק אל קובץ ההגדרות של Wrangler.

#שלב 2: פריסת Preview

הריצו את אותה פקודת Preview באופן מקומי או בתהליך ה-CI הקיים:

npm:

npx wrangler preview

yarn:

yarn wrangler preview

pnpm:

pnpm wrangler preview

שם ה-Preview הוא כברירת מחדל שם ענף ה-Git הנוכחי. כדי לבחור שם, הוסיפו --name <PREVIEW_NAME>.

כדי לפרסם כתובות Preview באופן אוטומטי לבקשות משיכה או לבקשות מיזוג, חברו את מאגר Git והשתמשו ב-Workers Builds. Workers חדשים משתמשים ב-Worker Previews כברירת מחדל. אם Worker קיים כבר משתמש ב-Workers Builds, השלימו את ההגדרה החד פעמית.

פריסה מוצלחת מחזירה Preview URL שמצביע תמיד על השינויים האחרונים. היא גם מחזירה Unique Deployment URL לכל פריסה, כך שאפשר לגשת לגרסאות קודמות בהיסטוריית הפריסות של ה-Preview.

#השלבים הבאים

• הגדרות: הגדירו משתנים, סודות, bindings ו-Previews Base.
• משאבים ובידוד: החליטו אילו משאבים לשתף ואילו לבודד.
• מגבלות: עיינו בפערי התמיכה הנוכחיים ובדרכי העקיפה.
• דוגמאות: הוסיפו פריסות Preview ל-CI.