Programação e desenvolvimento de software

A Cloudflare lança o Forge de código aberto para gerar pacotes SDK, ferramentas CLI e documentação a partir de definições de API

A Cloudflare anunciou o Forge, um pipeline extensível e de código aberto que funciona dentro do CI para gerar pacotes SDK, ferramentas CLI e documentação diretamente de definições de API. O projeto permite criar versões de pré-visualização para cada alteração, encadear múltiplas saídas e reduzir os riscos de incompatibilidade entre APIs e as ferramentas que dependem delas.

2026-09-28
4 min de leitura
1,143 visualizações
certi.news Editorial Team
A Cloudflare lança o Forge de código aberto para gerar pacotes SDK, ferramentas CLI e documentação a partir de definições de API

A Cloudflare anunciou o Forge, um pipeline de código aberto e extensível para gerar pacotes SDK, ferramentas de linha de comando, documentação e bibliotecas diretamente de definições de APIs. O Forge funciona em ambientes de integração contínua, ou CI, e pode ser executado gratuitamente e de forma autônoma, em vez de depender de um serviço SaaS hospedado.

O projeto surge em resposta à necessidade da Cloudflare de gerenciar uma API que inclui mais de 3.500 operações e é apoiada por centenas de serviços escritos em linguagens que incluem Rust, Go, TypeScript e Python. A empresa afirma que o Forge atualmente gera as saídas necessárias para a ferramenta cf CLI, e que seu uso deverá se estender nos próximos meses à documentação da Cloudflare, aos pacotes SDK e a outros recursos.

Pré-visualizações para cada alteração

O Forge funciona dentro dos repositórios das equipes de produto, onde examina cada alteração e depois cria versões de pré-visualização da ferramenta CLI, da documentação e dos pacotes SDK, destacando as modificações resultantes. As equipes podem instalar essas versões e testá-las antes de integrar uma alteração da API ou disponibilizá-la aos clientes.

Esse mecanismo tem como alvo um problema prático em ambientes nos quais a API está distribuída por centenas de serviços e repositórios: uma única alteração pode interromper o processo de geração, e a equipe afetada só descobre o problema no momento do lançamento. Já executar a geração antecipadamente dentro do CI transfere a validação para uma etapa mais próxima da origem da alteração e reduz a coordenação necessária entre as equipes.

Geração de saídas interligadas

O Forge não se limita aos destinos tradicionais de linguagens. O projeto pode receber uma definição OpenAPI e gerar saídas como Cap’n Web, um sistema RPC da Cloudflare que permite chamar APIs remotas de TypeScript de maneira semelhante à chamada de funções locais. A empresa também aponta a possibilidade de usar a mesma abordagem para criar integrações com TanStack Query, esquemas Zod ou Valibot e servidores MCP.

O Forge baseia-se em transformadores encadeáveis, de modo que uma saída pode ser usada para produzir outra saída. Atualmente, ele oferece suporte a OpenAPI como tipo de entrada, com um design que permite adicionar AsyncAPI, GraphQL, Cap’n Proto e Protobuf futuramente. O usuário também pode definir a cadeia de geração, em vez de ser obrigado a seguir um caminho fixo, algo importante quando uma ferramenta CLI é construída em uma linguagem diferente da usada no pacote SDK ou quando a ferramenta contém comandos escritos manualmente.

O que muda na prática?

O Forge apresenta um modelo que torna as ferramentas de consumo de APIs parte do próprio ciclo de desenvolvimento da interface, e não produtos separados que são atualizados posteriormente. Isso beneficia as equipes que precisam manter SDK, documentação e CLI sincronizados, mas não elimina a necessidade de revisar as saídas geradas, especialmente quando a ferramenta combina código gerado com comandos ou comportamentos escritos manualmente.

A Cloudflare também relaciona o projeto aos seus planos para gerenciar versões de APIs. Após uma década usando a versão principal v4, a empresa afirma que está trabalhando em uma abordagem que permita lançar novas versões principais sem quebrar clientes ou pacotes SDK antigos. O material não informou detalhes dessa abordagem nem um cronograma para sua implementação.

Licença aberta e limites da fase atual

O Forge está disponível sob a licença Apache 2.0 e pode ser executado, modificado e usado internamente ou de forma privada sem custos. A Cloudflare descreve o projeto como ainda estando em uma fase inicial, apesar de já ser usado para gerar saídas do cf CLI, e prometeu fornecer posteriormente detalhes sobre os SDKs de TypeScript, Rust, Python, Go, PHP e Terraform, com uma menção especial aos requisitos de migração no provedor do Terraform.

Fonte da notícia
Cloudflare Blog
Abrir fonte original ↗
c
Autor

certi.news Editorial Team

O que você precisa saber

A Cloudflare anunciou o Forge, um pipeline de código aberto que é executado dentro do CI para gerar pacotes SDK, ferramentas CLI e documentação diretamente a partir de definições de API. O Forge permite criar pré-visualizações para cada alteração e vincular múltiplas saídas, mas ainda está em uma fase inicial.

  • O Forge é executado em ambientes de integração contínua e pode ser hospedado pelo próprio usuário gratuitamente, em vez de depender de um serviço SaaS hospedado.
  • Atualmente, ele gera as saídas necessárias para a ferramenta cf CLI, com planos de ampliar seu uso para a documentação e os pacotes SDK da Cloudflare.
  • Ele cria pré-visualizações de ferramentas CLI, documentação e pacotes SDK antes que as alterações de API sejam integradas ou disponibilizadas aos clientes.
  • Atualmente, oferece suporte a OpenAPI e foi projetado para permitir futuramente o suporte a AsyncAPI, GraphQL, Cap’n Proto e Protobuf.
  • Usa adaptadores conectáveis para gerar saídas interconectadas, como Cap’n Web, links do TanStack Query, esquemas Zod ou Valibot e servidores MCP.
  • O Forge está disponível sob a licença Apache 2.0, mas a revisão das saídas geradas continua sendo necessária ao integrar código gerado com comandos escritos manualmente.

Perguntas frequentes

O que é o Forge?

O Forge é um pipeline de código aberto e extensível da Cloudflare para gerar pacotes SDK, ferramentas CLI, documentação e bibliotecas a partir de definições de API.

Quais tipos de entrada o Forge suporta?

Atualmente, ele oferece suporte a OpenAPI, com um design que permite adicionar futuramente AsyncAPI, GraphQL, Cap’n Proto e Protobuf.

O Forge é um serviço hospedado?

Não. Ele pode ser executado pelo próprio usuário em ambientes de integração contínua e utilizado sem custos, em vez de depender de um serviço SaaS hospedado.

O Forge já está estável e finalizado?

A Cloudflare descreve o Forge como estando ainda em uma fase inicial, embora ele já seja usado para gerar saídas do cf CLI.

Explore esta história

Tópicos e entidades relacionados

Na mesma categoria

Você também pode gostar

Ver todas as notícias