Cloudflare a annoncé Forge, un pipeline open source et extensible destiné à générer des SDK, des outils en ligne de commande, de la documentation et des bibliothèques directement à partir de définitions d’API. Forge fonctionne dans des environnements d’intégration continue CI et peut être exécuté gratuitement et de manière autonome, plutôt que de dépendre d’un service SaaS hébergé.
Le projet répond au besoin de Cloudflare de gérer une API comprenant plus de 3 500 opérations et prise en charge par des centaines de services écrits dans des langages incluant Rust, Go, TypeScript et Python. L’entreprise indique que Forge génère actuellement les sorties nécessaires à l’outil cf CLI, son utilisation devant s’étendre dans les prochains mois à la documentation de Cloudflare, aux SDK et à d’autres éléments.
Des aperçus pour chaque modification
Forge fonctionne au sein des dépôts des équipes produit, où il examine chaque modification puis crée des versions d’aperçu de l’outil CLI, de la documentation et des SDK, en mettant en évidence les changements qui en résultent. Les équipes peuvent installer ces versions et les tester avant de fusionner une modification de l’API ou de la déployer auprès des clients.
Ce mécanisme cible un problème concret dans les environnements où l’API est répartie entre des centaines de services et de dépôts : une seule modification peut interrompre le processus de génération, et l’équipe concernée ne découvre le problème qu’au moment de la publication. En exécutant la génération plus tôt dans la CI, la vérification intervient à une étape plus proche de la source de la modification et réduit la coordination nécessaire entre les équipes.
Générer des sorties interconnectées
Forge ne se limite pas aux cibles linguistiques traditionnelles. Le projet peut prendre une définition OpenAPI et générer des sorties telles que Cap’n Web, un système RPC de Cloudflare qui permet d’appeler des interfaces TypeScript distantes d’une manière similaire à l’appel de fonctions locales. L’entreprise évoque également la possibilité d’utiliser la même approche pour créer des liaisons TanStack Query, ainsi que des schémas Zod ou Valibot et des serveurs MCP.
Forge repose sur des adaptateurs composables, de sorte qu’une sortie puisse être utilisée pour en produire une autre. OpenAPI est actuellement pris en charge comme type d’entrée, avec une conception permettant d’ajouter à l’avenir AsyncAPI, GraphQL, Cap’n Proto et Protobuf. L’utilisateur peut également définir la chaîne de génération au lieu de se voir imposer un parcours fixe, ce qui est important lorsqu’un outil CLI est écrit dans un langage différent de celui du SDK ou lorsque l’outil contient des commandes écrites manuellement.
Qu’est-ce qui change concrètement ?
Forge propose un modèle qui fait des outils de consommation d’API une partie du cycle de développement de l’interface elle-même, plutôt que des produits distincts mis à jour ultérieurement. Cela profite aux équipes qui doivent maintenir la synchronisation entre les SDK, la documentation et le CLI, mais ne supprime pas la nécessité d’examiner les sorties générées, en particulier lorsque l’outil combine du code généré avec des commandes ou des comportements écrits manuellement.
Cloudflare relie également le projet à ses projets de gestion des versions d’API. Après une décennie d’utilisation de la version majeure v4, l’entreprise indique travailler sur une approche permettant de publier de nouvelles versions majeures sans casser les clients ni les anciens SDK. L’article ne fournit aucun détail sur cette approche ni aucun calendrier pour sa mise en œuvre.
Licence ouverte et limites de la phase actuelle
Forge est désormais disponible sous licence Apache 2.0 et peut être exécuté, modifié et utilisé en interne ou de manière privée sans frais. Cloudflare décrit le projet comme étant encore à un stade précoce, malgré son utilisation pour générer les sorties de cf CLI, et a promis de fournir ultérieurement des détails sur les SDK TypeScript, Rust, Python, Go, PHP et Terraform, avec une mention particulière des exigences de migration du fournisseur Terraform.