Cloudflare 전 제품을 아우르는 통합 CLI 구축

6 hours ago 1

Cloudflare는 100개 이상의 제품과 약 3,000개의 API 작업을 통합 관리할 수 있는 전역 CLI를 개발 중임
새로운 CLI는 기존 Wrangler를 확장해 모든 Cloudflare 서비스와 리소스를 코드 기반으로 제어 가능하게 함
TypeScript 스키마 시스템을 도입해 API, CLI 명령어, 인자 정의를 일관되게 자동 생성하며 OpenAPI 변환도 지원함
로컬 개발 환경에서는 Local Explorer를 통해 KV, R2, D1 등 리소스를 시각적으로 탐색하고 프로덕션과 동일한 API로 테스트 가능함
현재 기술 프리뷰(npx cf 또는 npm install -g cf)가 공개되어 있으며, Cloudflare는 사용자 피드백을 받아 완전한 통합 CLI 완성을 추진 중임

Cloudflare 전역 CLI 구축

Cloudflare는 100개 이상의 제품과 약 3,000개의 HTTP API 작업을 보유한 광범위한 API 생태계를 운영 중임
개발자와 에이전트(agents) 가 Cloudflare 플랫폼에서 애플리케이션과 플랫폼을 구축하고 API를 통해 분석 및 로그를 조회함
이를 위해 Cloudflare는 모든 제품을 CLI, SDK, Terraform, 설정 파일, 문서 등 다양한 인터페이스에서 사용할 수 있도록 확장 중임
기존 Wrangler CLI는 일부 제품만 지원했으나, 이제 Cloudflare 전 제품을 아우르는 새로운 CLI로 재구축 중임
새로운 CLI는 인프라를 코드로 구성할 수 있게 하며, 현재 npx cf 또는 npm install -g cf로 기술 프리뷰 버전을 사용할 수 있음

Cloudflare는 OpenAPI 스키마를 기반으로 SDK, Terraform provider, Code Mode MCP 서버를 자동 생성함
그러나 CLI, Workers Bindings, wrangler.jsonc, Agent Skills, 대시보드, 문서 등은 여전히 수동으로 관리되어 확장성과 일관성에 한계가 있었음
OpenAPI는 REST API만 표현할 수 있어 CLI 명령어, 로컬 개발, RPC 기반 Workers Bindings, Agent Skills 등 복합적 인터페이스를 표현하기 어려움
Cloudflare는 이를 해결하기 위해 TypeScript 기반의 새로운 스키마 시스템을 도입함
- TypeScript 타입 정의를 통해 API, CLI 명령어, 인자, 컨텍스트를 모두 기술 가능
- 일관성을 보장하는 linting 및 guardrail 규칙을 포함
- 필요 시 OpenAPI 스키마로 변환 가능
이 시스템을 통해 CLI뿐 아니라 향후 다양한 인터페이스를 자동 생성할 수 있는 통합 코드 생성 기반을 마련함

에이전트는 CLI 명령어의 일관된 패턴을 기대함
- 예: get은 항상 get, info는 사용하지 않음
- --force, --json 등 옵션 이름도 통일
이러한 규칙은 스키마 레벨에서 강제되어 대규모 조직에서도 명령어 불일치 문제를 방지함
Wrangler CLI는 로컬 및 원격 리소스를 모두 다루는 독특한 구조를 가짐
- D1, R2, KV 등 리소스를 로컬 또는 원격으로 동일한 명령어로 관리 가능
- 명령 실행 시 로컬/원격 여부를 명확히 표시해 혼동을 방지함
이러한 일관성은 에이전트가 로컬 개발 환경에서도 정확한 컨텍스트를 인식하도록 돕는 핵심 요소임

Cloudflare는 Local Explorer를 Wrangler와 Cloudflare Vite 플러그인에 오픈 베타로 공개함
Local Explorer는 로컬 개발 중 Worker가 사용하는 KV, R2, D1, Durable Objects, Workflows 등의 시뮬레이션 리소스를 탐색 가능
Cloudflare API나 대시보드에서 가능한 작업을 로컬에서도 동일한 API 구조로 수행할 수 있음
Miniflare 기반 로컬 환경에서 프로덕션과 동일한 API를 제공하며, SQLite 데이터베이스로 빠른 테스트와 오프라인 개발을 지원함
기존에는 .wrangler/state 디렉터리를 직접 분석해야 했으나, 이제는 키보드 단축키 e 로 Local Explorer를 열어 바인딩과 데이터를 시각적으로 확인 가능
Local Explorer는 스키마 검증, 테스트 데이터 삽입, 테이블 초기화 등 로컬 개발 주기를 대화형으로 개선함
/cdn-cgi/explorer/api 엔드포인트를 통해 로컬 리소스를 관리할 수 있으며, 에이전트는 이 주소의 OpenAPI 스펙을 사용해 로컬 자원을 제어 가능

Cloudflare는 Wrangler의 기존 기능과 새 시스템을 결합해 모든 제품을 지원하는 통합 CLI를 완성할 계획임
현재 기술 프리뷰(npx cf 또는 npm install -g cf)를 통해 초기 버전을 체험 가능
사용자에게 CLI에서 원하는 기능, 대시보드에서 클릭으로만 가능한 작업, wrangler.jsonc에서 설정하고 싶은 항목(DNS, Cache Rules 등)에 대한 피드백을 요청함
Cloudflare Developers Discord에서 의견을 공유할 수 있으며, 향후 지속적인 업데이트가 예정되어 있음

Cloudflare의 Connectivity Cloud는 기업 네트워크 보호, 대규모 애플리케이션 구축, 웹사이트 가속, DDoS 방어, 해킹 차단, Zero Trust 구현을 지원함
무료 앱 1.1.1.1을 통해 더 빠르고 안전한 인터넷 사용 가능
Cloudflare의 “더 나은 인터넷 구축” 미션과 채용 정보는 공식 웹사이트에서 확인 가능