Xây dựng giao diện dòng lệnh (CLI) toàn diện cho hệ sinh thái Cloudflare

Cloudflare sở hữu một hệ thống API khổng lồ với hơn 100 sản phẩm và gần 3.000 thao tác HTTP API. Ngày càng nhiều, các tác nhân AI (agents) đang trở thành khách hàng chính của các API này khi chúng được sử dụng để xây dựng, triển khai ứng dụng và cấu hình tài khoản.

Để đáp ứng nhu cầu này, Cloudflare đang nỗ lực biến mọi sản phẩm của mình đều có sẵn thông qua các giao diện mà tác nhân cần, đặc biệt là giao diện dòng lệnh (CLI). Họ đang xây dựng lại Wrangler — công cụ CLI quen thuộc của Cloudflare — để trở thành công cụ dòng lệnh duy nhất cho toàn bộ hệ sinh thái Cloudflare.

Giao diện dòng lệnh mới của Cloudflare

Bản xem trước kỹ thuật của lệnh cf

Hiện tại, nhiều sản phẩm của Cloudflare chưa có lệnh CLI trong Wrangler, điều này gây khó khăn cho việc tự động hóa. Cloudflare đã giới thiệu một phiên bản sơ khai của Wrangler mới dưới dạng bản xem trước kỹ thuật. Bạn có thể thử nghiệm ngay hôm nay bằng cách chạy lệnh npx cf hoặc cài đặt toàn cầu với npm install -g cf.

Mặc dù phiên bản này hiện tại chỉ hỗ trợ một tập hợp con nhỏ các sản phẩm, nhưng Cloudflare đang thử nghiệm nội bộ một phiên bản hỗ trợ toàn bộ diện tích API. Mục tiêu là cung cấp các lệnh cho mọi sản phẩm, cho phép cấu hình chúng cùng nhau sử dụng cơ sở hạ tầng dưới dạng mã (Infrastructure-as-code).

Tái thiết kế quy trình tạo mã từ nguyên tắc cơ bản

Để giữ cho CLI đồng bộ với tốc độ phát triển sản phẩm nhanh chóng, Cloudflare đã tạo ra một hệ thống mới cho phép tạo ra các lệnh, tệp cấu hình, API ràng buộc (bindings) và nhiều thứ khác một cách tự động.

Trước đây, họ dựa vào lược đồ OpenAPI để tạo SDK, Terraform provider và máy chủ MCP. Tuy nhiên, việc cập nhật CLI, Workers Bindings, cấu hình wrangler.jsonc và tài liệu vẫn là thủ công và dễ xảy ra lỗi.

Quy trình tạo mã mới dựa trên TypeScript

Cloudflare đã giới thiệu một lược đồ TypeScript mới có thể định nghĩa toàn bộ phạm vi của API, các lệnh CLI và đối số. Vì đây là định dạng riêng của họ, nó có thể dễ dàng thích ứng để hỗ trợ bất kỳ giao diện nào cần thiết trong tương lai, đồng thời vẫn có thể tạo ra lược đồ OpenAPI.

Tính nhất quán và "Kỹ thuật ngữ cảnh" cho Tác nhân AI

Các tác nhân AI mong đợi sự nhất quán tuyệt đối từ CLI. Nếu một lệnh dùng info để lấy thông tin và lệnh khác dùng get, tác nhân sẽ bị nhầm lẫn. Trong một tổ chức kỹ thuật khổng lồ, việc thực thi tính nhất quán thủ công là gần như không thể.

Cloudflare đã bắt đầu tạo ra các quy tắc và rào chắn được thực thi ở tầng lược đồ. Ví dụ: luôn dùng get, không bao giờ dùng info; luôn dùng --force, không bao giờ dùng --skip-confirmations.

Điều này đặc biệt quan trọng với Wrangler CLI vì nó hỗ trợ cả tài nguyên cục bộ (local) và từ xa (remote). Việc đảm bảo các mặc định nhất quán giúp tác nhân AI hiểu rõ liệu chúng đang thao tác trên cơ sở dữ liệu cục bộ hay từ xa, tránh những lỗi khó hiểu trong quá trình phát triển.

Local Explorer: Những gì làm từ xa, giờ làm được cục bộ

Cùng với việc cập nhật CLI, Cloudflare cũng ra mắt tính năng Local Explorer trong bản beta mở. Tính năng này cho phép bạn kiểm tra (introspect) các tài nguyên được mô phỏng mà Worker của bạn sử dụng khi phát triển cục bộ, bao gồm KV, R2, D1, Durable Objects và Workflows.

Giao diện Local Explorer

Trước đây, để biết dữ liệu được lưu trữ cục bộ là gì, nhà phát triển phải đảo ngược kỹ thuật nội dung của thư mục .wrangler/state hoặc sử dụng công cụ của bên thứ ba. Giờ đây, khi chạy ứng dụng với Wrangler CLI hoặc plugin Cloudflare Vite, bạn sẽ được nhắc mở trình khám phá cục bộ (phím tắt e).

Điều này cung cấp một giao diện đơn giản để xem các ràng buộc hiện có của Worker và dữ liệu được lưu trữ trong chúng. Đây là công cụ tuyệt vời để hiểu tác nhân AI đang làm gì với dữ liệu, giúp chu kỳ phát triển cục bộ trở nên tương tác hơn nhiều.

API cho Local Explorer hiện có sẵn tại /cdn-cgi/explorer/api trên bất kỳ ứng dụng nào được hỗ trợ bởi Wrangler hoặc Vite Plugin. Bằng cách trỏ tác nhân AI đến địa chỉ này, nó có thể tìm thấy đặc tả OpenAPI để quản lý tài nguyên cục bộ một cách tự động.

Cloudflare đang mong muốn nhận được phản hồi từ cộng đồng về những gì họ mong muốn ở một CLI cho toàn bộ nền tảng. Bạn có thể tham gia Discord của Cloudflare Developers để đóng góp ý tưởng và theo dõi các cập nhật sắp tới.