Skip to content

wrangler (Cloudflare Workers CLI)

wrangler 是用於開發和管理 Cloudflare Workers 的官方命令列介面（CLI）工具^[001-TODO__Cloudflare_Workers_自架短網址_-10_分鐘完工教學.md]。作為 Cloudflare Workers 生態系統的核心開發者工具，它允許開發者使用 TypeScript 或 JavaScript 建構 Serverless 應用程式，並將其部署到 Cloudflare 遍佈全球的 300 多個邊緣運算節點^[001-TODO__Cloudflare_Workers_自架短網址-_10_分鐘完工教學.md]。

核心功能

Wrangler 提供了從專案初始化到部署上線的完整工作流程支援：

  • 專案初始化：開發者可以通過簡單的指令（例如回答幾個問題）在 30 秒內建立一個新的 Workers 專案^[001-TODO__Cloudflare_Workers_自架短網址_-_10_分鐘完工教學.md]。
  • 資源管理：它能夠建立和配置 Cloudflare KV（Key-Value）命名空間，並將相關 ID 和綁定設定自動更新到專案的設定檔（如 wrangler.jsonc）中^[001-TODO__Cloudflare_Workers_自架短網址_-_10_分鐘完工教學.md]。
  • 型別定義生成：對於 TypeScript 專案，wrangler 可以根據環境配置自動產生型別定義（例如 Env 介面），確保 KV 等綁定在程式碼中具有型別安全^[001-TODO__Cloudflare_Workers_自架短網址_-_10_分鐘完工教學.md]。
  • 一鍵部署：透過單一指令即可將應用程式推送到 Cloudflare 的全球網絡^[001-TODO__Cloudflare_Workers_自架短網址_-_10_分鐘完工教學.md]。

設定與配置

Wrangler 的行為主要由專案根目錄下的設定檔控制（通常為 wrangler.jsonc 或 wrangler.toml）。此檔案定義了 Worker 的名稱、主程式進入點（main entrypoint）以及環境變數綁定^[001-TODO__Cloudflare_Workers_自架短網址_-_10_分鐘完工教學.md]。

在處理短網址服務等應用時，開發者需在設定檔中指定 KV namespace 的 ID，並定義程式碼中存取該資料庫所使用的變數名稱^[001-TODO__Cloudflare_Workers_自架短網址_-10_分鐘完工教學.md]。此外，wrangler 也支援配置自訂網域和路由，以將特定網域或路徑的流量導向 Worker 處理^[001-TODO__Cloudflare_Workers_自架短網址-_10_分鐘完工教學.md]。

開發工作流程

典型的 wrangler 開發流程包含以下步驟：

  1. 建立專案：使用指令建立支架，設定 Worker 名稱與檔案入口^[001-TODO__Cloudflare_Workers_自架短網址_-_10_分鐘完工教學.md]。
  2. 配置資源：使用 CLI 建立 KV 資料庫，並將設定輸出至配置檔^[001-TODO__Cloudflare_Workers_自架短網址_-_10_分鐘完工教學.md]。
  3. 本地開發：編寫邏輯，可選擇生成型別定義以輔助 TypeScript 開發^[001-TODO__Cloudflare_Workers_自架短網址_-_10_分鐘完工教學.md]。
  4. 部署：執行部署指令將程式碼上線，此時應用程式即運行於 Cloudflare 的全球基礎設施上^[001-TODO__Cloudflare_Workers_自架短網址_-_10_分鐘完工教學.md]。

相關概念

  • Cloudflare Workers：wrangler 所部署的目標執行環境。
  • [[Cloudflare KV]]：常與 Workers 搭配使用的分散式鍵值儲存服務。
  • [[Serverless]]：一種雲端原生開發模型，開發者無需管理伺服器。
  • 20/80學習原則：可應用於快速掌握 wrangler 的核心指令。

Sources

  • 001-TODO__Cloudflare_Workers_自架短網址_-_10_分鐘完工教學.md