라이프스타일

Cloudflare, Forge 오픈소스 공개: SDK·CLI·문서를 자동 생성하는 생성 파이프라인

Cloudflare는 2026년 9월 28일 API 사양에서 SDK, 명령줄 도구, 문서를 자동으로 생성하는 오픈소스 생성 파이프라인 Forge를 발표했습니다. 이 글은 Cloudflare 공식 블로그를 바탕으로 그 내용과 설계 철학, 개발자와 일반 사용자에게 미칠 수 있는 영향을 정리합니다.

읽는 데 약 7분

Cloudflare, Forge 오픈소스 공개: SDK·CLI·문서를 자동 생성하는 생성 파이프라인
사진: Mokaair (Original editorial artwork)

Cloudflare가 발표한 내용

Cloudflare는 2026년 9월 28일 공식 블로그에 Dimitri Mitropoulos, Matt “TK” Taylor, Samuel Macleod가 작성한 글을 게시하고 Forge 출시를 발표했습니다. Cloudflare에 따르면 Forge는 오픈소스이자 플러그형(기능을 부품처럼 끼워 넣어 확장할 수 있는) 생성 파이프라인으로, SDK(소프트웨어 개발 키트), CLI(명령줄 도구), 문서, 라이브러리를 생성할 수 있으며 누구나 무료로 배포하고 실행할 수 있습니다. 여기서 API는 프로그램끼리 기능과 데이터를 주고받는 창구를 말합니다.

Cloudflare는 Forge가 아직 초기 단계이지만 이미 cf CLI에 필요한 출력물 생성에 사용되고 있으며, 향후 몇 달 안에 Cloudflare의 API 문서, SDK 등을 지원할 것이라고 밝혔습니다. 또한 Forge를 개발한 이유는 AI 에이전트(agents)를 고객으로 대응하기 위해서이며, CLI, API SDK, MCP 서버(AI 에이전트가 외부 서비스와 도구에 연결할 때 쓰는 규격의 서버)와 그에 맞는 문서는 이제 모든 제품의 기본 구성 요소라고 설명했습니다.

Cloudflare, Forge 오픈소스 공개: SDK·CLI·문서를 자동 생성하는 생성 파이프라인
Mokaair 편집 검증 절차 · 사진: Mokaair (Original editorial artwork)
자세한 설명 보기

출처를 수집하고 독립적으로 검증한 뒤 Jev가 판단합니다.

Cloudflare가 Forge를 직접 만든 이유

Cloudflare에 따르면 자사 API에는 3,500개가 넘는 작업(operation)이 있고, 그 뒤에는 Rust, Go, TypeScript, Python 등 여러 언어로 작성된 수백 개의 서비스가 있습니다. Cloudflare는 여러 호스팅 제품을 시험하고 프로덕션 환경에서 의존하기도 했지만 모두 문제를 해결하지 못했고, 일부 제품은 서비스가 완전히 중단되기도 했다고 밝혔습니다. 과거에는 한 팀이 병합한 변경이 의도치 않게 생성 파이프라인을 망가뜨렸는데, 다른 팀이 릴리스 시점에야 이를 발견한 일도 있었다고 합니다.

Cloudflare는 Forge가 각 팀의 API 저장소에서 CI(지속적 통합, 코드 변경 때마다 자동으로 검사·빌드하는 과정)로 실행되어 모든 변경을 검사하고, 해당 변경만 부각한 설치·테스트 가능한 CLI, 문서, SDK 미리보기 버전을 생성함으로써 이후 단계에 영향을 주기 전에 문제를 발견할 수 있게 한다고 설명했습니다.

Cloudflare 공식 블로그를 바탕으로 정리했으며, 내용은 Cloudflare의 일방적 주장임
측면Cloudflare가 설명한 과거 상황Cloudflare가 설명한 Forge의 방식
문제 발견 시점변경이 릴리스 시점에야 다른 팀에 의해 발견될 수 있음CI에서 모든 변경을 검사하고 미리보기 생성
도구 통제권통제할 수 없는 호스팅 도구에 의존, 일부는 서비스 중단오픈소스로 직접 무료 배포·실행 가능
입력 형식글에서 자세히 설명하지 않음현재 OpenAPI 지원, 향후 AsyncAPI, GraphQL, Cap’n Proto, Protobuf 등 지원 가능하도록 설계
출력물 간의 관계다른 생성기는 보통 도구가 연결 방식을 결정변환기를 연결할 수 있으며 사용자가 직접 제어

Forge의 주요 설계 특징

Cap’n Web을 포함한 다양한 출력물 생성

Cloudflare는 Forge가 OpenAPI 사양(API의 구조를 기계가 읽을 수 있게 적어 두는 표준 형식)에서 곧바로 Cap’n Web을 생성할 수 있다고 밝혔습니다. Cap’n Web은 Cloudflare의 RPC(원격 프로시저 호출, 다른 컴퓨터의 기능을 불러 쓰는 방식) 시스템으로, TypeScript에서 원격 API를 로컬 메서드처럼 호출할 수 있게 해 줍니다. Cloudflare는 같은 방식으로 TanStack Query 바인딩, Zod 또는 Valibot 스키마, MCP 서버 등도 생성할 수 있다고 예를 들었습니다.

변환기 연결 가능

Cloudflare에 따르면 Forge의 변환기(transformer, 입력을 받아 특정 산출물을 만들어 내는 구성 요소)는 한 대상의 출력물을 사용해 다른 출력물을 생성할 수 있으며, 연결 방식은 사용자가 직접 제어합니다. Cloudflare는 cf CLI를 예로 들었습니다. cf CLI는 TypeScript로 작성되었고, 생성된 출력물 위에 cf dev, cf build 등 직접 작성한 명령이 추가되어 있으며, 이 명령들은 Vite 등 패키지의 TypeScript API를 호출해야 합니다. Cloudflare는 이런 수작업 명령을 문서에 다시 반영해 주는 기존 도구를 찾지 못해 이 기능을 Forge에 구축하고 있다고 밝혔습니다.

API 버전 관리와의 관계

Cloudflare에 따르면 v4 API는 10년 동안 유일한 주요 버전이었습니다. Cloudflare는 앞으로 새 주요 API 버전을 출시해도 기존 클라이언트나 SDK가 깨지지 않도록 하는 버전 관리 방식을 연구 중이라고 밝혔으며, TypeScript, Rust, Python, Go, PHP, Terraform SDK에 관한 추가 소식을 곧 공개할 예정이고 Terraform 전환에는 특히 신중을 기하겠다고 했습니다.

일반 독자와 개발자에게 미치는 실제 영향

  • 일반 사용자: 이런 도구는 주로 뒤에서 작동합니다. Cloudflare가 밝힌 목표가 실현되면 CLI, SDK, 문서가 API 변경을 더 일관되게 따라갈 수 있겠지만, 이는 향후 실제 성과에 달려 있습니다.
  • 개발자: Cloudflare는 Forge가 오픈소스이며 무료로 배포할 수 있다고 밝혔으므로, 이론적으로는 자사 API의 SDK, CLI, 문서 생성에 활용할 수 있습니다. 다만 아직 초기 단계이므로 검토 전에 성숙도를 확인하는 것이 좋습니다.
  • AI 에이전트 생태계: Cloudflare가 MCP 서버 같은 인터페이스를 기본 구성 요소로 본다는 점은 API 제공자들이 AI 에이전트가 자사 서비스를 더 쉽게 이용하도록 하는 방법을 고민하고 있음을 보여 줍니다.
  • 기존 Cloudflare 사용자: Cloudflare가 Terraform을 포함해 API 버전 관리와 SDK를 조정할 것이라고 언급했으므로 후속 공지를 지켜볼 만합니다.

자주 묻는 질문

Forge란 무엇인가요?

Cloudflare에 따르면 Forge는 API 사양에서 SDK, CLI, 문서, 라이브러리를 생성하는 오픈소스이자 플러그형 생성 파이프라인으로, 누구나 무료로 배포하고 실행할 수 있습니다.

Forge는 지금 실제로 사용되고 있나요?

Cloudflare는 Forge가 아직 초기 단계이지만 이미 cf CLI에 필요한 출력물 생성에 쓰이고 있으며, 향후 몇 달 안에 Cloudflare의 API 문서와 SDK를 지원할 것이라고 밝혔습니다.

Forge는 어떤 입력 형식을 지원하나요?

Cloudflare에 따르면 Forge는 현재 OpenAPI를 지원하며, 향후 AsyncAPI, GraphQL, Cap’n Proto, Protobuf 등 다른 입력 형식도 지원할 수 있도록 설계되었습니다.

Cloudflare는 왜 기존 호스팅 도구를 계속 사용하지 않나요?

Cloudflare는 여러 호스팅 제품을 시험하고 의존해 왔지만 여러 팀과 수백 개 저장소에 걸친 요구를 해결하지 못했고, 일부 제품은 서비스가 중단되기도 했다고 밝혔습니다.

현재 사용 중인 Cloudflare API나 Terraform 설정에 영향이 있나요?

Cloudflare는 기존 클라이언트나 SDK를 깨뜨리지 않고 새 주요 버전을 출시하는 방식을 연구 중이며 Terraform 전환에 특히 신중을 기하겠다고 밝혔지만, 구체적인 내용은 아직 발표하지 않았습니다. Cloudflare의 후속 공식 공지를 확인하시기 바랍니다.

Forge에 관한 주장은 독립적으로 검증되었나요?

아니요. 이 글의 정보는 Cloudflare 공식 블로그에서만 나온 것으로, 해당 회사 자체의 주장입니다.

이 주제의 최신 뉴스 보기

최신 여행 소식·가이드

출처

라이프스타일