Cloudflare מציגה את Forge: צינור קוד פתוח ליצירת SDK ו-CLI

Cloudflare הציגה את Forge, צינור יצירה מודולרי בקוד פתוח שהופך הגדרות API ל-SDK, ל-CLI, לתיעוד ולספריות. לפי החברה, כל אחד יכול לפרוס ולהריץ אותו בחינם.

הפרויקט נמצא בשלב מוקדם, אך כבר מייצר את הפלט הנדרש ל-cf CLI. בחודשים הקרובים הוא יפעיל את התיעוד וה-SDK של ה-API של Cloudflare.

למה Cloudflare בנתה את Forge

ה-API של Cloudflare כולל יותר מ-3,500 פעולות, ומאות השירותים שמאחוריו כתובים ב-Rust, Go, TypeScript ו-Python. כדי לבנות CLI אחד לכל ה-API נדרש צינור יצירה שיתמודד עם קנה מידה כזה.

Forge רץ ב-CI, במאגרי ה-API של כל צוות. הוא בודק כל שינוי ומייצר בניות מקדימות של CLI, תיעוד ו-SDK, שבהן מודגשים רק השינויים החדשים. הרעיון דומה ל-Workers Previews, אך מיושם על יצירת SDK.

טרנספורמרים ויצירה משורשרת

ניתן לשרשר טרנספורמרים של Forge, כך שפלט אחד משמש ליצירת פלטים אחרים. הגדרת ה-OpenAPI המקורית נבנית לתוך ה-SDK של TypeScript, שממנו נוצרות מפרטי cf CLI ו-Cap'n Web.

כיום Forge תומך ב-OpenAPI כקלט, אך תוכנן לאפשר בעתיד גם AsyncAPI, GraphQL, Cap'n Proto ו-Protobuf. בזכות השרשור אפשר לייצר גם קישורי TanStack Query, סכמות Zod או Valibot, שרתי MCP, לוחות בקרה ואפליקציות שלמות.

גרסאות וקוד פתוח

Forge מסייע גם לניהול גרסאות טוב יותר של ה-API. גרסת v4 היא הגרסה הראשית כבר עשר שנים, והחברה פועלת לגישה שתאפשר לשחרר גרסאות ראשיות חדשות בלי לשבור לקוחות או SDK ישנים.

SDK חדשים מתוכננים ל-TypeScript, Rust, Python, Go, PHP ו-Terraform. Forge משוחרר ברישיון Apache 2.0, וניתן להריץ אותו לכל מטרה, עם שינויים מותאמים, באופן פרטי ובחינם.