📘 תיעוד 245

בקרת פריסת ענפים

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

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

#בקרת ענף הייצור

Direct Upload

אם הפרויקט הוא פרויקט Direct Upload, לא תהיה לך האפשרות להגדיר בקרות של ענף הייצור. כדי לעדכן את ענף הייצור צריך לקרוא ידנית לנקודת הקצה 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\"}"

כדי להגדיר אפשרויות פריסה, עבור אל פרויקט Pages > Settings > Builds & deployments > Configure Production deployments. Pages מגדיר כברירת מחדל את סביבת הייצור לענף שאליו דחפת לראשונה, אבל אפשר להגדיר את הייצור לענף אחר אם תבחר בכך.

אפשר גם להפעיל או לכבות התנהגות של פריסה אוטומטית על ענף הייצור על ידי סימון התיבה Enable automatic production branch deployments. צריך לשמור את ההגדרות כדי שבקרות ענף הייצור החדשות ייכנסו לתוקף.

#בקרת ענפי תצוגה מקדימה

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

• All non-Production branches: כברירת מחדל, Pages פורס באופן אוטומטי כל commit לענף תצוגה מקדימה.
• None: מכבה בניות אוטומטיות לכל ענפי התצוגה המקדימה.
• Custom branches: התאמה אישית של הפריסות האוטומטיות של ענפי תצוגה מקדימה מסוימים.

#בקרת ענפי תצוגה מקדימה מותאמת

בבחירת Custom branches אפשר לציין ענפים שרוצים לכלול ולהחריג מפריסות אוטומטיות בשדות ההגדרה שמופיעים. אפשר למלא את שדות ההגדרה בשתי דרכים:

• Static branch names: הזן את השם המדויק של הענף שרוצים לכלול או להחריג (לדוגמה, staging או dev).
• Wildcard syntax: השתמש בתווי הכללה כדי להתאים למספר ענפים. אפשר לציין תו הכללה בתחילת הכלל או בסופו. סדר הביצוע של ההגדרה הוא (1) Excludes, (2) Includes, (3) Skip. Pages מעבד קודם את הגדרת ההחרגה, ואחר כך עובר להגדרת ההכללה. אם ענף לא תואם לאף אחת מהן, הוא ידולג.

Wildcard syntax

תו הכללה (*) הוא תו שנמצא בשימוש בתוך כללים. אפשר למקם אותו לבד כדי להתאים לכל דבר, או למקם אותו בתחילת כלל או בסופו כדי לאפשר שליטה טובה יותר בהגדרת הענפים. תו הכללה יתאים לאפס תווים או יותר. לדוגמה, אם רוצים להתאים לכל הענפים שמתחילים ב־fix/, יוצרים את הכלל fix/* כדי להתאים למחרוזות כמו fix/1, fix/bugs או fix/.

דוגמה 1:

אם רוצים לאכוף קידומות ענפים כמו fix/, feat/ או chore/ עם תחביר תו הכללה, אפשר לכלול ולהחריג ענפים מסוימים עם הכללים הבאים:

• Include Preview branches: fix/*, feat/*, chore/*
• Exclude Preview branches: ``

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

דוגמה 2:

אם רוצים למנוע מ־dependabot ליצור פריסה עבור כל PR שהוא יוצר, אפשר להחריג את הענפים האלה כך:

• Include Preview branches: *
• Exclude Preview branches: dependabot/*

כאן Pages יכלול את כל הענפים מלבד כל ענף שמתחיל ב־dependabot. בדוגמה הזו, אפשרות ההחרגה אומרת שכל ענפי dependabot/ לא ייבנו.

דוגמה 3:

אם רוצים לפרוס רק ענפים עם קידומת release, אפשר להשתמש בכללים הבאים:

• Include Preview branches: release/*
• Exclude Preview branches: *

זה יפרוס רק ענפים שמתחילים ב־release/.