Building a CLI for all of Cloudflare

TL;DR

Cloudflare đang tái cấu trúc CLI của họ (từ Wrangler quen thuộc sang cf) để quản lý toàn bộ sản phẩm, từ Workers đến DNS, bằng một công cụ duy nhất. Mục tiêu là giúp dev và AI agent tự động hóa, quản lý tài nguyên Cloudflare một cách nhất quán, từ local đến production.

Nói đơn giản: Như có một remote control vạn năng cho cả hệ sinh thái Cloudflare vậy.

Tổng quan

Cloudflare đang trong quá trình xây dựng lại CLI của mình. Từ cái tên quen thuộc Wrangler, họ đang chuyển sang một công cụ mới tên là cf với tham vọng bao quát hơn 100 sản phẩm và gần 3000 HTTP API operations của họ.

Lý do chính là vì ngày càng nhiều “agent” (bao gồm cả AI agent) đang là khách hàng chính của các API Cloudflare. Họ cần một CLI thống nhất, dễ dùng cho cả con người lẫn AI, cho phép cấu hình mọi thứ bằng infrastructure-as-code.

Để làm được điều này, Cloudflare đã phải xây dựng một hệ thống code generation hoàn toàn mới, dựa trên TypeScript schema thay vì chỉ OpenAPI. Điều này giúp họ định nghĩa toàn bộ scope của API, CLI commands, arguments và context cần thiết để tạo ra bất kỳ giao diện nào (SDKs, Terraform, Workers Bindings, Agent Skills, docs) một cách nhất quán.

Hiện tại, bản Technical Preview của cf đã ra mắt (chạy npx cf hoặc npm install -g cf). Dù mới chỉ hỗ trợ một phần nhỏ sản phẩm, đây là bước đầu cho một CLI toàn diện, hứa hẹn sẽ tích hợp với các tính năng của Wrangler trong tương lai gần.

Xài vào việc gì?

Bạn đang dùng nhiều dịch vụ Cloudflare và muốn quản lý chúng hiệu quả hơn Chạy cf để tạo, cập nhật, xóa mọi thứ từ Workers, R2, D1 đến DNS records hay Cache Rules. Thay vì phải nhảy qua lại giữa dashboard và nhiều CLI khác nhau, bạn có một điểm tập trung duy nhất. Kết quả: Tiết kiệm thời gian chuyển đổi context, chuẩn hóa workflow, giảm thiểu lỗi thủ công.

Bạn muốn tự động hóa việc triển khai và cấu hình hạ tầng Cloudflare Viết script hoặc dùng AI agent để tự động provision DNS records, cache rules, Workers, R2 buckets, D1 databases. cf được thiết kế để thân thiện với automation. Kết quả: Giảm lỗi thủ công, tăng tốc độ triển khai, dễ dàng scale hệ thống mà hông cần tăng headcount.

Bạn đang phát triển ứng dụng Cloudflare Workers và cần debug local hiệu quả Dùng Local Explorer (tính năng mới trong cf và Cloudflare Vite plugin) để kiểm tra dữ liệu của KV, R2, D1, Durable Objects ngay trên máy local. Bạn có thể xem, thêm, sửa, xóa dữ liệu giả lập. Kết quả: Debug nhanh hơn, viết test hiệu quả hơn mà hông cần deploy lên staging môi trường, tăng tốc độ phát triển.

Bạn muốn đảm bảo tính nhất quán trong đội ngũ dev khi làm việc với Cloudflare Với các quy tắc và guardrails được enforce ở schema layer (ví dụ: luôn dùng get, hông dùng info; luôn --force, hông --skip-confirmations), mọi dev trong team sẽ dùng cùng một cú pháp. Kết quả: Giảm nhầm lẫn, tăng hiệu suất làm việc nhóm và dễ dàng onboarding dev mới.

Các điểm chính

• AI Agents là khách hàng chính của API: Cloudflare nhận ra AI agents đang ngày càng dùng API của họ nhiều hơn. Điều này có nghĩa là các tools phải được thiết kế cho cả con người và AI.
  • Hành động: Khi build tool hoặc API, mình cần nghĩ xem AI agent sẽ tương tác với nó như thế nào, hông chỉ dừng lại ở UI/UX cho con người. Đây là một “timing window” quan trọng.
• Tính nhất quán là chìa khóa cho tự động hóa: Cloudflare đang enforce các quy tắc cú pháp ở schema layer để đảm bảo mọi lệnh CLI đều nhất quán.
  • Hành động: Trong các dự án automation của mình, cần xây dựng các “guardrails” từ sớm để giữ cho hệ thống dễ bảo trì và mở rộng, tránh tình trạng “Swiss cheese” (chỗ có chỗ không).
• Chỉ dùng OpenAPI schema là hông đủ: OpenAPI tốt cho REST API, nhưng hông thể mô tả hết các tương tác phức tạp của CLI, Workers Bindings hay Agent Skills.
  • Hành động: Đừng giới hạn mình vào một loại schema duy nhất. Cần một schema đủ “mạnh” để mô tả toàn bộ hệ thống, hông chỉ một phần nhỏ của nó. Đây là “obsolete wisdom” nếu mình cứ khăng khăng chỉ dùng OpenAPI cho mọi thứ.
• Quyết định xây dựng hệ thống code generation mới là hông thể đảo ngược: Đây là một khoản đầu tư lớn, nhưng cần thiết để scale.
  • Hành động: Đối với các hệ thống lớn, việc đầu tư vào hạ tầng code generation/automation pipeline từ sớm sẽ quyết định khả năng mở rộng và tốc độ phát triển trong tương lai.
• Cloudflare đang mở rộng cửa cho AI agents: Việc thiết kế CLI và API thân thiện với AI agents là một bước đi chiến lược quan trọng.
  • Hành động: Các dev và founder cần nhanh chóng thích nghi với xu hướng “agent-first” này để tận dụng tối đa các nền tảng như Cloudflare, nếu hông sẽ lỡ mất cơ hội (“competitive timing”).
• Người làm config thủ công và “click-ops” sẽ bị chậm lại: Nếu hông adapt, những người quen click trên dashboard để cấu hình mọi thứ sẽ bị chậm lại so với team dùng CLI và automation.
  • Hành động: Học cách dùng CLI và infrastructure-as-code là kỹ năng sống còn. “Who dies?” chính là những workflow thủ công, chậm chạp đó.
• “What you can do remotely, you can now do locally”: Câu này nhấn mạnh sự đồng bộ giữa môi trường dev local và production.
  • Hành động: Tìm cách áp dụng nguyên tắc này vào các dự án của mình để giảm thiểu sự khác biệt giữa dev và prod, giúp quá trình phát triển mượt mà hơn. Đây là một “emotional anchor” giúp mình nhớ về giá trị của Local Explorer.

Workflow gợi ý

1. Khởi tạo project Cloudflare Workers mới: Dùng cf để tạo project mới, cấu hình Workers, R2, D1 bindings ngay trong wrangler.jsonc.
2. Phát triển và debug local: Chạy Workers local với cf dev, sau đó nhấn e để mở Local Explorer và kiểm tra dữ liệu R2/D1/KV giả lập.
3. Deploy và quản lý production: Dùng cf deploy để đẩy code, sau đó dùng các lệnh cf khác để quản lý DNS, Cache Rules, v.v. trên môi trường production.

Quick Start

1. Làm ngay tuần này: Cài npx cf hoặc npm install -g cf và thử tạo một Workers project đơn giản. Sau đó, chạy cf dev và nhấn e để bật Local Explorer, xem dữ liệu local của KV/R2/D1.
2. Bước tiếp: Dùng cf để cấu hình một dịch vụ Cloudflare khác mà bạn đang dùng (ví dụ: tạo DNS record, quản lý R2 bucket) thay vì dùng dashboard.
3. Thói quen duy trì: Tích hợp cf vào CI/CD pipeline của bạn để tự động hóa việc triển khai và quản lý tài nguyên Cloudflare, biến nó thành một phần hông thể thiếu trong workflow của team.

FAQ

• cf có thay thế hoàn toàn Wrangler hông?
  • Hiện tại cf là bản technical preview. Cloudflare sẽ dần tích hợp nó với các tính năng hiện có của Wrangler để tạo ra một CLI toàn diện. Mục tiêu cuối cùng là cf sẽ là CLI cho toàn bộ nền tảng Cloudflare.
• Tại sao Cloudflare lại build lại CLI từ đầu?
  • Để hỗ trợ toàn bộ sản phẩm của Cloudflare, đảm bảo tính nhất quán và khả năng mở rộng cho cả dev và AI agent. Hệ thống cũ chỉ dựa vào OpenAPI hông đủ để mô tả hết các tương tác phức tạp.
• Local Explorer là gì và nó giúp gì cho mình?
  • Local Explorer là tính năng giúp bạn xem và quản lý các tài nguyên Cloudflare được giả lập local (KV, R2, D1, Durable Objects) ngay trong môi trường phát triển. Nó giúp debug và test nhanh hơn mà hông cần deploy lên môi trường thật.
• Mình có thể đóng góp feedback cho cf ở đâu?
  • Bạn có thể tham gia Cloudflare Developers Discord để chia sẻ mong muốn và những tính năng bạn muốn thấy trong CLI mới. Cloudflare đang rất muốn nghe ý kiến từ cộng đồng.