Programmierung und Softwareentwicklung

Cloudflare stellt das Open-Source-Projekt Forge zur Generierung von SDK-Paketen, CLI-Tools und Dokumentation aus API-Definitionen vor

Cloudflare hat Forge vorgestellt, eine erweiterbare Open-Source-Pipeline, die innerhalb von CI läuft und SDK-Pakete, CLI-Tools und Dokumentation direkt aus API-Definitionen generiert. Das Projekt ermöglicht die Erstellung von Vorschauversionen für jede Änderung, die Verknüpfung mehrerer Ausgaben und die Verringerung des Risikos von Inkompatibilitäten zwischen APIs und den darauf aufbauenden Tools.

2026-09-28
4 Min. Lesezeit
1,143 Aufrufe
certi.news Editorial Team
Cloudflare stellt das Open-Source-Projekt Forge zur Generierung von SDK-Paketen, CLI-Tools und Dokumentation aus API-Definitionen vor

Cloudflare hat Forge vorgestellt, eine erweiterbare Open-Source-Pipeline zur Generierung von SDK-Paketen, Kommandozeilen-Tools, Dokumentation und Bibliotheken direkt aus API-Definitionen. Forge läuft in Continuous-Integration-Umgebungen (CI) und kann kostenlos sowie selbstverwaltet betrieben werden, anstatt von einem gehosteten SaaS-Dienst abhängig zu sein.

Das Projekt ist eine Reaktion auf Cloudflares Bedarf, eine API mit mehr als 3.500 Operationen zu verwalten, die von Hunderten Diensten unterstützt wird, welche in Sprachen wie Rust, Go, TypeScript und Python geschrieben sind. Nach Angaben des Unternehmens generiert Forge derzeit die erforderlichen Ausgaben für das cf CLI-Tool; in den kommenden Monaten soll die Nutzung auf die Cloudflare-Dokumentation, SDK-Pakete und weitere Bereiche ausgeweitet werden.

Vorschauen für jede Änderung

Forge läuft innerhalb der Repositories der Produktteams. Dabei prüft es jede Änderung und erstellt Vorschauversionen des CLI-Tools, der Dokumentation und der SDK-Pakete, wobei die daraus resultierenden Anpassungen hervorgehoben werden. Die Teams können diese Versionen installieren und testen, bevor sie eine API-Änderung zusammenführen oder für Kunden bereitstellen.

Dieser Mechanismus zielt auf ein praktisches Problem in Umgebungen ab, in denen die API auf Hunderte von Diensten und Repositories verteilt ist: Eine einzelne Änderung kann die Generierung beeinträchtigen, und das betroffene Team entdeckt das Problem möglicherweise erst bei der Veröffentlichung. Wird die Generierung dagegen frühzeitig innerhalb von CI ausgeführt, verlagert sich die Überprüfung in eine Phase, die näher an der Quelle der Änderung liegt, und der erforderliche Abstimmungsaufwand zwischen den Teams sinkt.

Generierung miteinander verknüpfter Ausgaben

Forge beschränkt sich nicht auf herkömmliche Sprachziele. Das Projekt kann eine OpenAPI-Definition übernehmen und Ausgaben wie Cap’n Web generieren, ein RPC-System von Cloudflare, das den Aufruf entfernter TypeScript-Schnittstellen auf eine Weise ermöglicht, die dem Aufruf lokaler Funktionen ähnelt. Das Unternehmen verweist außerdem auf die Möglichkeit, denselben Ansatz zur Erstellung von TanStack-Query-Bindings, Zod- oder Valibot-Schemas sowie MCP-Servern zu verwenden.

Forge basiert auf verkettbaren Adaptern, sodass eine Ausgabe zur Erzeugung einer weiteren Ausgabe verwendet werden kann. OpenAPI wird derzeit als Eingabetyp unterstützt; das Design ermöglicht künftig die Ergänzung von AsyncAPI, GraphQL, Cap’n Proto und Protobuf. Nutzer können außerdem die Generierungskette festlegen, anstatt auf einen festen Ablauf beschränkt zu sein. Dies ist wichtig, wenn ein CLI-Tool in einer anderen Sprache als ein SDK-Paket erstellt wird oder wenn das Tool manuell geschriebene Befehle enthält.

Was ändert sich in der Praxis?

Forge bietet ein Modell, bei dem Tools für den API-Konsum Teil des Entwicklungszyklus der Schnittstelle selbst werden und nicht getrennte Produkte sind, die später aktualisiert werden. Dies hilft Teams, die SDK, Dokumentation und CLI synchron halten müssen. Es macht jedoch weiterhin eine Überprüfung der generierten Ausgaben erforderlich, insbesondere wenn das Tool generierten Code mit manuell geschriebenen Befehlen oder Verhaltensweisen kombiniert.

Cloudflare verknüpft das Projekt außerdem mit seinen Plänen für die Verwaltung von API-Versionen. Nach einem Jahrzehnt der Nutzung der Hauptversion v4 erklärt das Unternehmen, an einem Ansatz zu arbeiten, der die Veröffentlichung neuer Hauptversionen ermöglicht, ohne Kunden oder ältere SDK-Pakete zu beeinträchtigen. In dem Beitrag wurden weder Einzelheiten zu diesem Ansatz noch ein Zeitplan für seine Umsetzung bekannt gegeben.

Offene Lizenz und Grenzen der aktuellen Phase

Forge ist nun unter der Apache-2.0-Lizenz verfügbar und kann kostenlos ausgeführt, geändert sowie intern oder privat genutzt werden. Cloudflare beschreibt das Projekt trotz seiner Verwendung zur Generierung von cf-CLI-Ausgaben als noch in einer frühen Phase befindlich. Zugleich kündigte das Unternehmen spätere Einzelheiten zu den SDKs für TypeScript, Rust, Python, Go und PHP sowie Terraform an, mit besonderem Hinweis auf die Migrationsanforderungen beim Terraform-Provider.

Nachrichtenquelle
Cloudflare Blog
Originalquelle öffnen ↗
c
Autor

certi.news Editorial Team

Das Wichtigste

Cloudflare hat Forge angekündigt, eine Open-Source-Pipeline, die innerhalb von CI läuft, um SDK-Pakete, CLI-Tools und Dokumentation direkt aus API-Definitionen zu generieren. Forge ermöglicht die Erstellung von Vorschauen für jede Änderung und die Verknüpfung mehrerer Ausgaben, befindet sich jedoch noch in einer frühen Phase.

  • Forge läuft innerhalb von Continuous-Integration-Umgebungen und kann kostenlos selbst gehostet werden, anstatt einen gehosteten SaaS-Dienst zu nutzen.
  • Derzeit generiert Forge die für das cf CLI erforderlichen Ausgaben; geplant ist eine Ausweitung auf die Cloudflare-Dokumentation und SDK-Pakete.
  • Vor dem Zusammenführen von API-Änderungen oder deren Bereitstellung für Kunden erstellt Forge Vorschauen für CLI-Tools, Dokumentation und SDK-Pakete.
  • Forge unterstützt derzeit OpenAPI und wurde so konzipiert, dass künftig auch AsyncAPI, GraphQL, Cap’n Proto und Protobuf unterstützt werden können.
  • Forge verwendet kombinierbare Adapter, um verknüpfte Ausgaben wie Cap’n Web, TanStack-Query-Links, Zod- oder Valibot-Schemas und MCP-Server zu generieren.
  • Forge ist unter der Apache-2.0-Lizenz verfügbar. Bei der Zusammenführung generierten Codes mit manuell geschriebenen Befehlen ist jedoch weiterhin eine Überprüfung der Ausgaben erforderlich.

FAQ

Was ist Forge?

Forge ist eine Open-Source- und erweiterbare Pipeline von Cloudflare zur Generierung von SDK-Paketen, CLI-Tools, Dokumentation und Bibliotheken aus API-Definitionen.

Welche Eingabetypen unterstützt Forge?

Derzeit unterstützt Forge OpenAPI. Die Architektur ermöglicht künftig die Unterstützung von AsyncAPI, GraphQL, Cap’n Proto und Protobuf.

Ist Forge ein gehosteter Dienst?

Nein. Forge kann innerhalb von Continuous-Integration-Umgebungen selbst gehostet und kostenlos genutzt werden, anstatt auf einen gehosteten SaaS-Dienst angewiesen zu sein.

Ist Forge stabil und abgeschlossen?

Cloudflare beschreibt Forge als noch in einer frühen Phase, obwohl es derzeit zur Generierung von Ausgaben für das cf CLI verwendet wird.

Aus derselben Kategorie

Das könnte Sie interessieren

Alle Nachrichten anzeigen