📘 תיעוד 221

ממשק שורת הפקודה C3

עודכן לאחרונה: 25 באוגוסט 2026

Cloudflare מספקת פקודת CLI ליצירת פרויקטים חדשים של Workers ושל Pages: npm create cloudflare, שמבוססת על חבילת create-cloudflare ↗︎.

#יצירת יישום חדש

פתחו חלון טרמינל והריצו:

npm

npm create cloudflare@latest -- --platform=pages

yarn

yarn create cloudflare --platform=pages

pnpm

pnpm create cloudflare@latest --platform=pages

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

הערה

כדי ליצור פרויקט Pages חובה כעת לציין את הארגומנט --platform=pages, אחרת C3 תמיד ייצור פרויקט Workers.

#מסגרות אינטרנט

אם תבחרו באפשרות "Framework Starter", תתבקשו לבחור מסגרת לשימוש. המסגרות הבאות נתמכות כרגע:

• Angular
• Astro
• Docusaurus
• Gatsby
• Hono
• Next.js static exports
• Nuxt
• Qwik
• React
• Redwood
• Remix
• SolidStart
• SvelteKit
• Vue

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

#פריסה

לאחר שהפרויקט הוגדר, תישאל אם ברצונך לפרוס את הפרויקט ל-Cloudflare. זה אופציונלי.

אם תבחרו לפרוס, תתבקשו להתחבר לחשבון Cloudflare שלכם (אם אינכם מחוברים כבר), והפרויקט ייפרס.

#יצירת פרויקט Pages חדש שמחובר למאגר git

כדי ליצור פרויקט חדש באמצעות npm create cloudflare, ואז לחבר אותו למאגר Git בחשבון Github או Gitlab שלכם, בצעו את השלבים הבאים:

1. הריצו את npm create cloudflare@latest, ובחרו את האפשרויות הרצויות
2. בחרו no בהנחיה "Do you want to deploy your application?". זה חשוב: אם תבחרו yes ותפרסו את היישום מהטרמינל (Direct Upload), לא יהיה אפשר לחבר את פרויקט Pages הזה למאגר git מאוחר יותר. תצטרכו ליצור פרויקט Cloudflare Pages חדש.
3. צרו מאגר git חדש, באמצעות היישום ש-npm create cloudflare@latest יצר עבורכם זה עתה.
4. עקבו אחר השלבים המתוארים במדריך שילוב Git

#ארגומנטים של CLI

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

זהו הפורמט המלא של קריאה ל-C3, לצד ארגומנטי ה-CLI האפשריים:

npm

npm create cloudflare@latest -- --platform=pages [<DIRECTORY>] [OPTIONS] [-- <NESTED ARGS...>]

yarn

yarn create cloudflare --platform=pages [<DIRECTORY>] [OPTIONS] [-- <NESTED ARGS...>]

pnpm

pnpm create cloudflare@latest --platform=pages [<DIRECTORY>] [OPTIONS] [-- <NESTED ARGS...>]

• DIRECTORY string אופציונלי
  • התיקייה שבה יש ליצור את היישום. שם היישום נלקח משם התיקייה.
• NESTED ARGS.. string[] אופציונלי
  • ארגומנטי CLI להעברה לכלי CLI של צד שלישי ש-C3 עשוי להפעיל (במקרה של יישומי full-stack).
• --category string אופציונלי
  • סוג התבניות שיש ליצור.
  • הערכים האפשריים לאפשרות זו הם:
    • hello-world: דוגמת Hello World
    • web-framework: Framework Starter
    • demo: Application Starter
    • remote-template: תבנית ממאגר GitHub
• --type string אופציונלי
  • סוג היישום שיש ליצור.
  • הערכים האפשריים לאפשרות זו הם:
    • hello-world: Worker בסיסי של Cloudflare מסוג "Hello World".
    • hello-world-durable-object: Durable Object ו-Worker לתקשורת איתו.
    • common: Worker של Cloudflare שמממש דוגמה נפוצה של פונקציונליות ניתוב או פרוקסי.
    • scheduled: Worker מתוזמן של Cloudflare (מופעל באמצעות Cron Triggers).
    • queues: Worker של Cloudflare שהוא גם צרכן וגם מפיק של Queues.
    • openapi: Worker שמממש נקודת קצה REST של OpenAPI.
    • pre-existing: שליפת Worker שאותחל מלוח הבקרה של Cloudflare.
• --framework string אופציונלי
  • סוג המסגרת לשימוש ליצירת יישום אינטרנט (כאשר משתמשים באפשרות זו, מתעלמים מ---type).
  • הערכים האפשריים לאפשרות זו הם:
    • angular
    • astro
    • docusaurus
    • gatsby
    • hono
    • next
    • nuxt
    • qwik
    • react
    • redwood
    • remix
    • solid
    • svelte
    • vue
• --template string אופציונלי

  • יצירת פרויקט חדש באמצעות תבנית חיצונית שמתארחת במאגר git

  • אפשר לציין את הערך של אפשרות זו בכל אחת מהצורות הבאות:

    • user/repo
    • [email protected]:user/repo
    • https://github.com/user/repo
    • user/repo/some-template (תת-תיקיות)
    • user/repo#canary (ענפים)
    • user/repo#1234abcd (גיבוב commit)
    • bitbucket:user/repo (BitBucket)
    • gitlab:user/repo (GitLab)

    ראו את התיעוד ↗︎ של degit לפרטים נוספים.

    לכל הפחות, תבניות חייבות להכיל את הדברים הבאים:

    • package.json
    • קובץ תצורת Wrangler
    • src/ שמכיל סקריפט worker שמוזכר מקובץ התצורה של Wrangler

    ראו את תיקיית templates ↗︎ של מאגר זה לדוגמאות נוספות.

• --deploy boolean (ברירת מחדל: true) אופציונלי
  • פריסת היישום לאחר שנוצר.
• --lang string (ברירת מחדל: ts) אופציונלי
  • שפת התכנות של התבנית.
  • הערכים האפשריים לאפשרות זו הם:
    • ts
    • js
    • python
• --ts boolean (ברירת מחדל: true) אופציונלי
  • שימוש ב-TypeScript ביישום. הוצא משימוש. השתמשו ב---lang=ts במקום.
• --git boolean (ברירת מחדל: true) אופציונלי
  • אתחול מאגר git מקומי עבור היישום.
• --open boolean (ברירת מחדל: true) אופציונלי
  • פתיחת היישום שנפרס בדפדפן (אפשרות זו מתעלמת אם היישום לא נפרס).
• --existing-script string אופציונלי
  • השם של סקריפט Cloudflare Workers קיים לשכפול מקומית. כאשר משתמשים באפשרות זו, --type נכפה ל-pre-existing.
  • כאשר מצוין --existing-script, המערכת תתעלם מ-deploy.
• -y, --accept-defaults boolean אופציונלי
  • שימוש בכל אפשרויות ברירת המחדל של C3. אפשר גם לעקוף כל אחת מהן על ידי ציון שלה.
• --auto-update boolean (ברירת מחדל: true) אופציונלי
  • שימוש אוטומטי בגרסה האחרונה של C3.
• -v, --version boolean אופציונלי
  • הצגת מספר הגרסה.
• -h, --help boolean אופציונלי
  • הצגת הודעת עזרה.

הערה

את כל האפשרויות הבוליאניות שלמעלה אפשר לציין עם ערך או בלי ערך. לדוגמה, --open ו---open true בעלות אותו אפקט. הוספת הקידומת no- לשם האפשרות שוללת אותה, כך שלדוגמה --no-open ו---open false בעלות אותו אפקט.

#טלמטריה

Cloudflare אוספת נתוני שימוש אנונימיים כדי לשפר את create-cloudflare לאורך זמן. קראו עוד על כך במדיניות הנתונים ↗︎.

אפשר לבטל את ההשתתפות אם אינכם רוצים לשתף מידע.

npm

npm create cloudflare@latest -- telemetry disable

yarn

yarn create cloudflare telemetry disable

pnpm

pnpm create cloudflare@latest telemetry disable

לחלופין, אפשר להגדיר משתנה סביבה:

export CREATE_CLOUDFLARE_TELEMETRY_DISABLED=1

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

npm

npm create cloudflare@latest -- telemetry status

yarn

yarn create cloudflare telemetry status

pnpm

pnpm create cloudflare@latest telemetry status

אפשר תמיד להפעיל מחדש את איסוף הטלמטריה.

npm

npm create cloudflare@latest -- telemetry enable

yarn

yarn create cloudflare telemetry enable

pnpm

pnpm create cloudflare@latest telemetry enable