📘 תיעוד 223

אינטגרציית Git

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

לא ניתן לעבור ל-Direct Upload בהמשך

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

#חיבור ספק Git ל-Pages

Pages תומך ב-GitHub ↗︎ וב-GitLab ↗︎. כדי ליצור את פרויקט Pages הראשון שלכם:

1. בלוח הבקרה של Cloudflare, עברו לדף Workers & Pages. עברו אל Workers & Pages ↗
2. בחרו Create application > Pages > Connect to Git.

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

הערה

התחברות עם GitLab תעניק ל-Pages גישה לכל המאגרים בחשבון שלכם. בנוסף, אם אתם חלק מחשבון Cloudflare מרובה משתמשים, ואתם מתחברים עם GitLab, גם לחברים אחרים תהיה היכולת לפרוס את המאגרים שלכם ל-Pages.

אם אתם משתמשים ב-GitLab, חייבת להיות לכם הרשאת Maintainer או גבוהה יותר במאגר כדי לפרוס בהצלחה עם Cloudflare Pages.

#בחירת מאגר GitHub

אפשר לבחור פרויקט GitHub מהחשבון האישי או מארגון שנתתם ל-Pages גישה אליו. זה מאפשר לכם לבחור מאגר GitHub לפריסה באמצעות Pages. נתמכים גם מאגרים פרטיים וגם מאגרים ציבוריים.

#בחירת מאגר GitLab

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

#הגדרת הפריסה

אחרי שבחרתם מאגר Git, בחרו Install & Authorize ו-Begin setup. לאחר מכן תוכלו להתאים את הפריסה ב-Set up builds and deployments.

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

Production branch מציין את הענף ש-Cloudflare Pages צריך להשתמש בו כדי לפרוס את גרסת הייצור של האתר. ברוב הפרויקטים זה ענף main או master. כל שאר הענפים שאינם ענף הייצור ישמשו ל-פריסות תצוגה מקדימה.

הערה

חייבים לדחוף לפחות ענף אחד לפרויקט GitHub או GitLab כדי לבחור Production branch מהתפריט הנפתח.

#הגדרת הגדרות הבנייה

בהתאם למסגרת, לכלי או לפרויקט שאתם מפרסים ל-Cloudflare Pages, תצטרכו לציין את build command ואת build output directory של האתר כדי לומר ל-Cloudflare Pages איך לפרוס את האתר. התוכן של ספרייה זו מועלה ל-Cloudflare Pages כתוכן האתר.

אין צורך במסגרת

אין צורך במסגרת כדי לפרוס עם Cloudflare Pages. אפשר להמשיך במדריך Get started בלי לבחור מסגרת, ולעיין ב-פריסת האתר למידע נוסף על פריסת האתר בלי מסגרת.

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

Cloudflare Pages מתחיל לעבוד מספריית השורש של המאגר. כל צינור הבנייה, כולל שלבי ההתקנה, יתחיל ממיקום זה. אם תרצו לשנות זאת, ציינו מיקום חדש של ספריית שורש דרך השדה Root directory (advanced) > Path.

הבנת הגדרת הבנייה

פקודת הבנייה מסופקת על ידי המסגרת. לדוגמה, מסגרת Gatsby משתמשת ב-gatsby build כפקודת הבנייה שלה. כשעובדים בלי מסגרת, השאירו את השדה Build command ריק.

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

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

עיינו ב-הגדרת בנייה למידע נוסף.

#משתני סביבה

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

עיינו ב-מדריך מסגרת Hexo למידע נוסף על הגדרת משתנה סביבה של גרסת Node.js.

אחרי שבחרתם את Framework preset או השארתם שדה זה ריק אם אתם עובדים בלי מסגרת, הגדרתם Root directory (advanced), והתאמתם את Environment variables (optional), אתם מוכנים לפרוס.

#הפריסה הראשונה

אחרי שסיימתם להגדיר את הגדרת הבנייה, בחרו Save and Deploy. יומני הבנייה של הפרויקט יוצגו בזמן ש-Cloudflare Pages מתקין את התלויות של הפרויקט, בונה את הפרויקט, ומפרס אותו לרשת הגלובלית של Cloudflare.

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

שגיאות DNS

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

#ניהול האתר

אחרי הפריסה הראשונה, בחרו Continue to project כדי לראות את הגדרת הפרויקט בלוח הבקרה של Cloudflare Pages. בדף זה אפשר לראות את מצב הפריסה הנוכחי של הפרויקט, את כתובת ה-URL של הייצור ואת ה-commit המשויך, ואת כל הפריסות הקודמות.

#מחיקת פרויקט

כדי למחוק את פרויקט Pages:

1. בלוח הבקרה של Cloudflare, עברו לדף Workers & Pages. עברו אל Workers & Pages ↗
2. בחרו את פרויקט Pages > Settings > Delete project.

זהירות

בפרויקטים עם דומיין מותאם אישית, קודם צריך למחוק את רשומת ה-CNAME המשויכת לפרויקט Pages. אי מחיקה עלולה להשאיר את רשומות ה-DNS פעילות, ולגרום לדומיין להצביע על פרויקט Pages שכבר לא קיים. עיינו ב-מחיקת דומיין מותאם אישית להוראות.

בפרויקטים בלי דומיין מותאם אישית (כל פרויקט בתת דומיין *.pages.dev), אפשר למחוק את הפרויקט בהגדרות הפרויקט.

#הגדרות פרויקט מתקדמות

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

#משאבים קשורים

• הגדרת דומיין מותאם אישית לפרויקט Pages.
• הפעלת Cloudflare Web Analytics.
• הגדרת מדיניות Access כדי לנהל מי יכול לצפות בתצוגות המקדימות של הפריסה.