訂閱以接收新文章的通知:

用於實現生產安全的新工具:Gradual Deployments、來源對應、限速和新 SDK

2024/04/04

閱讀時間:16 分鐘
New tools for production safety — Gradual deployments, Source maps, Rate Limiting, and new SDKs

2024 年 Developer Week 的重點在於生產就緒。4 月 1 日(星期一),我們宣布 D1QueuesHyperdrive Workers Analytics Engine 已準備好進入生產規模且正式上市。4 月 2 日(星期二),我們宣布我們的推理平台 Workers AI 已正式上市。但我們並不會止步於此。

不過,生產就緒不僅僅是關於您構建時所使用的服務的規模和可靠性。您還需要工具來安全可靠地進行變更。您不僅依賴 Cloudflare 提供的功能,還依賴其根據應用程式需求精確控制和自訂 Cloudflare 行為方式的能力。

今天,我們宣布了五項更新,為您提供更強功能:Gradual Deployments、Tail Workers 中的來源對應堆疊追蹤、新的限速 API、全新的 API SDK 以及 Durable Objects 的更新,每一項更新的構建都將任務關鍵型生產服務納入了考量。我們使用 Workers 建立自己的產品,包括 AccessR2KVWaiting RoomVectorizeQueuesStream 等。我們依靠每一項新功能來確保我們已做好生產準備,現在我們很高興將它們帶給每個人。

對 Workers 和 Durable Objects 逐步部署變更

部署 Worker 幾乎瞬時就可完成——只需幾秒鐘,您的變更就會無處不在

當您達到生產規模時,您所做的每項變更都會帶來更大的風險,無論是在數量還是預期方面。您需要滿足 99.99% 的可用性 SLA,或擁有雄心勃勃的 P90 延遲 SLO。一個糟糕的部署如果針對全部流量持續 45 秒,可能意味著數以百萬計的請求失敗。如果一次全部推出,一個細微的程式碼變更可能會導致對不堪重負的後端進行大量的重試。這些都是我們針對自己基於 Workers 的服務所需要考量並緩解的風險。

減輕這些風險的方法是逐步部署變更——通常稱為滾動部署:

  1. 您的應用程式的當前版本在生產環境中執行。
  2. 您將應用程式的新版本部署到生產環境,但僅將一小部分流量路由到這個新版本,並等待它「浸泡」在生產環境中,監視遞歸和漏洞。如果發生不良情況,您可以在一小部分(例如 1%)流量中儘早發現並可以快速復原。
  3. 您逐漸增加流量百分比,直到新版本接收 100% 的流量,此時它已完全推出。

今天,我們開放了一個一流的方法,透過 Cloudflare APIWrangler CLI Workers 儀表板將程式碼變更逐漸部署到 Workers 和 Durable Objects。Gradual Deployments 正在進入公開測試階段,您可以將 Gradual Deployments 與 Workers Free 方案中的任何 Cloudflare 帳戶一起使用,而在不久之後,您將可以開始將 Gradual Deployments 與 Workers Paid 和企業方案中的 Cloudflare 帳戶一起使用。一旦您的帳戶具有存取權限,您就會在 Workers 儀表板上看到橫幅。

在不同版本的 Worker 之間拆分流量

當 Worker 或 Durable Object 有兩個版本在生產中同時執行時,您肯定會希望能夠按版本篩選指標、異常和記錄。將新版本僅推出到一小部分流量,可以幫助您及早發現生產問題,或在按 50/50 分配流量時比較效能指標。我們還在我們的平台上新增了版本層級的可觀察性:

您可能還想確保每個用戶端或使用者始終看到您的 Worker 的同一個版本。我們新增了 Version Affinity,以便與特定識別碼(例如使用者、工作階段或任何唯一 ID)關聯的請求始終由同一版本的 Worker 處理。當 Session Affinity規則集引擎一起使用時,可讓您完全控制用於確保「黏性」的機制和識別碼。

Gradual Deployments 正在進入公開測試階段。隨著我們邁向正式版,我們正在加倍努力,以支援:

  • 版本覆寫。叫用特定版本的 Worker,以便在其提供任何生產流量之前進行測試。這將允許您建立藍綠部署 (Blue-Green Deployments)。
  • Cloudflare Pages。讓 Cloudflare Pages 中的 CI/CD 系統自動代表您進行部署。
  • 自動復原。當新版 Worker 錯誤率激增時,自動復原部署。

我們期待聽到您的意見反應!請透過意見反應表單告訴我們您的想法,或透過 #workers-gradual-deployments-beta 頻道中的開發人員 Discord 聯絡我們。

Tail Workers 中的來源對應堆疊追蹤

生產就緒意味著追蹤錯誤和異常,並努力將其減少到零。發生錯誤時,最先需要查看的就是錯誤的堆疊追蹤——呼叫的具體函數、呼叫順序、來自哪行和檔案以及使用哪些引數。

大多數 JavaScript 程式碼(不管是在 Workers 上,還是其他各個平台上)首先會被捆綁,通常會被轉譯,然後在部署到生產環境之前進行縮製。這是在幕後完成的,目的是建立更小的套件以最佳化效能,並在需要時從 Typescript 轉換為 Javascript。

如果您曾經看到過異常傳回堆疊追蹤,例如:/src/index.js:1:342,這表示錯誤發生在函數縮製程式碼的第 342 個字元上。這對於偵錯顯然沒有多大幫助。

來源對應解決了這個問題,它們將編譯和縮製程式碼對應回您編寫的原始程式碼。來源對應與 JavaScript 執行階段傳回的堆疊追蹤相結合,為您提供人類可讀的堆疊追蹤。例如,以下堆疊追蹤顯示 Worker 在 down.ts 檔案的第 30 行收到意外的空值。這是一個有用的偵錯起點,您可以向下移動堆疊追蹤,以瞭解被設定為產生空值的所呼叫函數。

Unexpected input value: null
  at parseBytes (src/down.ts:30:8)
  at down_default (src/down.ts:10:19)
  at Object.fetch (src/index.ts:11:12)

其運作方式如下:

  1. 當您在 wrangler.toml 中設定 upload_source_maps = true 時,Wrangler 會在您執行 wrangler deploy wrangler versions upload 時自動產生並上傳任何來源對應檔案。
  2. 當您的 Worker 拋出未擷取的異常時,我們會擷取來源對應,並使用它將異常的堆疊追蹤對應回 Worker 的原始來源程式碼行。
  3. 然後,您可以在即時記錄 Tail Workers 中檢視這個反混淆的堆疊追蹤。

從今天開始,在公開測試版中,您可以在部署 Worker 時將來源對應上傳到 Cloudflare。請閱讀文件以開始使用。從 4 月 15 日開始,Workers 執行階段將開始使用來源對應來反混淆堆疊追蹤。當來源對應堆疊追蹤可用時,我們將在 Cloudflare 儀表板中發布通知,並在我們的 Cloudflare Developers X 帳戶上發布通知。

Workers 中的新限速 API

API 僅在具有合理的速率限制時才可用於生產。隨著您的成長,您需要執行的限制的複雜性和多樣性也會增加,以平衡特定客戶的需求、保護服務的健康狀況或在特定場景中執行和調整限制。Cloudflare 自己的 API 面臨著這項挑戰——我們數十種產品中的每一種產品(每種產品都有許多 API 端點)可能都需要強制執行不同的速率限制。

自 2017 年以來,您就可以在 Cloudflare 上設定限速規則。但在今天之前,仍是只能在 Cloudflare 儀表板中或透過 Cloudflare API 控制此操作。無法在執行階段定義行為,也無法在 Worker 中編寫直接與速率限制互動的程式碼——您只能在請求到達 Worker 之前控制其是否受到速率限制。

今天,我們推出了一個新 API 的開放測試版,讓您可以從 Worker 直接存取速率限制。它速度快如閃電,由 memcached 提供支援,並且可以輕鬆新增到您的 Worker 中。例如,以下設定定義了 60 秒內 100 個請求的速率限制:

[[unsafe.bindings]]
name = "RATE_LIMITER"
type = "ratelimit"
namespace_id = "1001" # An identifier unique to your Cloudflare account

# Limit: the number of tokens allowed within a given period, in a single Cloudflare location
# Period: the duration of the period, in seconds. Must be either 60 or 10
simple = { limit = 100, period = 60 } 

然後,在您的 Worker 中,您可以呼叫 RATE_LIMITER 綁定上的限制方法,並提供您選擇的鍵。對於上面的設定,一旦在 60 秒內對特定路徑發出超過 100 個請求,此程式碼將傳回 HTTP 429 回應狀態碼:

export default {
  async fetch(request, env) {
    const { pathname } = new URL(request.url)

    const { success } = await env.RATE_LIMITER.limit({ key: pathname })
    if (!success) {
      return new Response(`429 Failure – rate limit exceeded for ${pathname}`, { status: 429 })
    }

    return new Response(`Success!`)
  }
}

現在,Workers 可以直接連接到像 memcached 這樣的資料存放區,我們還能提供什麼?計數器?鎖?記憶體內快取?限速是我們試圖在 Workers 中提供的許多基本元件中的第一個,它解決了我們多年來一直遇到的問題,即跨多個 Worker 隔離群的臨時共用狀態應該存在於哪裡。如果您現在依賴於將狀態放入 Worker 的全域範圍內,我們正在研究專為特定使用案例建置的更好的基元。

Workers 中的限速 API 處於公開測試階段,您可以透過閱讀文件來開始使用。

為 Cloudflare API 自動產生的新 SDK

生產就緒意味著可以透過點擊儀表板中的按鈕進行變更,也可以使用 Terraform Pulumi 等基礎架構即程式碼方法,或直接發出 API 呼叫(自行或透過 SDK)的方法,以程式設計方式進行變更。

Cloudflare API規模龐大,並且不斷增加新功能——我們平均每天要更新 API 架構 20 到 30 次。但迄今為止,我們的 API SDK 都是手動建置和維護的,因此我們迫切需要將其自動化。

我們已經做到了這一點,今天我們宣布推出適用於 Cloudflare API 的新用戶端 SDK,支援三種語言(TypescriptPython Go),並且即將推出更多語言。

每個 SDK 都是使用 Stainless API 自動產生的,基於定義每個 API 端點的結構和功能的 OpenAPI 結構描述。這意味著,當我們在任何 Cloudflare 產品中向 Cloudflare API 新增任何新功能時,這些 API SDK 都會自動重新產生並發布新版本,以確保它們正確且最新。

您可以透過執行以下命令之一來安裝 SDK:

// Typescript
npm install cloudflare

// Python
pip install --pre cloudflare

// Go
go get -u github.com/cloudflare/cloudflare-go/v2

如果您使用 Terraform 或 Pulumi,在底層,Cloudflare 的 Terraform Provider 目前使用現有的非自動化 Go SDK。當您執行 terraform apply 時,Cloudflare Terraform Provider 會決定以什麼順序進行哪個 API 呼叫,並使用 Go SDK 執行這些操作。

利用自動產生的新 Go SDK,可以為所有 Cloudflare 產品提供更全面的 Terraform 支援,其提供了一組可以信賴的基本工具,這些工具恰到好處,且與最新的 API 變更保持同步。我們正在努力實現這樣一個未來:每當 Cloudflare 的產品團隊建立透過 Cloudflare API 提供的新功能時,SDK 都會自動支援它。預計 2024 年將有更多相關更新。

Durable Object 命名空間分析和 WebSocket Hibernation 正式上市

我們自己的許多產品,包括 Waiting RoomR2 Queues,以及 PartyKit 等平台,都是使用 Durable Objects 建構的。Durable Objects 在全球範圍內部署,且新增了對 Oceania 的支援,您可以將其視為可以提供單點協調和持久狀態的單獨 Workers。它們非常適合需要即時使用者協調的應用程式,例如互動式聊天或協作編輯。Atlassian 對此的評價是:

我們的一個新功能是 Confluence 白板,它提供了一種自由方式來擷取非結構化工作,例如腦力激盪法和團隊正式記錄之前的早期規劃。團隊考慮了多種即時協作選項,最終決定使用 Cloudflare 的 Durable Objects。事實證明,Durable Objects 非常適合這個問題領域,它具有獨特的功能組合,使我們能夠大大簡化基礎架構並輕鬆擴展到大量使用者。-Atlassian

我們之前沒有在儀表板中公開相關的分析趨勢,因此很難理解 Durable Objects 命名空間中的使用模式和錯誤率,除非您直接使用 GraphQL Analytics APIDurable Objects 儀表板現已改進,讓您可以深入瞭解指標,並根據需要進行更深度的鑽研。

第一天起,Durable Objects 就支援 WebSocket,允許許多用戶端直接連接到 Durable Object 來傳送和接收訊息。

然而,有時用戶端應用程式會開啟 WebSocket 連線,最後卻沒有執行任何操作。就好比您 5 個小時前在瀏覽器中開啟了一個索引標簽,卻並沒有使用過它。如果該用戶端使用 WebSocket 傳送和接收訊息,那麼它實際上擁有一個長期存在的 TCP 連線,該連線未用於任何用途。如果此連線指向一個 Durable Object,那麼該 Durable Object 必須保持執行,等待發生某些操作,在此過程中,這會消耗記憶體並花費您的金錢。

我們首先引入了 WebSocket Hibernation 來解決這個問題,今天,我們宣布該功能已經結束測試並正式上市。透過 WebSocket Hibernation,您可以設定在休眠時使用的自動回應,並序列化狀態,使其在休眠狀態下繼續存在。這可以為 Cloudflare 提供我們為維持來自用戶端的開啟 WebSocket 連線所需的輸入,同時「休眠」Durable Object,使其不主動執行,並且您無需為閒置時間付費。結果是,當您實際需要時,您的狀態始終在記憶體中可用,但在不需要時,也不會不必要地保留在記憶體中。只要您的 Durable Object 處於休眠狀態,即使仍有作用中用戶端透過 WebSocket 連接,也不會按持續時間向您收費。

此外,我們也聽取了開發人員關於向 Durable Objects 傳入 WebSocket 訊息的成本的意見反應,以便利於更小、更頻繁的即時通訊訊息。從今天開始,傳入的 WebSocket 訊息將按請求的 1/20 進行計費(而不是之前的 1 個訊息相當於 1 個請求)。以下是定價範例

WebSocket 連線請求 傳入的 WebSocket 訊息數 計費請求數 請求計費
之前 10K 432M 432,010,000 $64.65
之後 10K 432M 21,610,000 $3.09

生產就緒,沒有生產複雜性

在上一代雲端平台上做好生產準備意味著放慢發布速度。這意味著將許多互不相關的工具拼接在一起,或讓整個團隊在內部平台上工作。您必須將自己的生產力層遷移到無障礙的平台上。

Cloudflare 開發人員平台已經成熟,已準備好投入生產,並致力於成為一個整合式平台,產品可以直觀地協同工作,不需要 10 種方法來做同樣的事情,也不需要相容性矩陣來幫助瞭解哪些產品可以一起工作。這些更新中的每一個都展示了這一點,新功能在不同產品和不同的 Cloudflare 平台部分中進行了整合。

為此,我們不僅希望聽到您對未來產品的期待,也希望聽到您關於如何簡化產品的意見,或者您認為我們的產品可以在哪些方面更好地協同工作。如果您對我們有任何改進意見,請告訴我們,Cloudflare 開發人員 Discord 始終開放。

我們保護整個企業網路,協助客戶有效地建置網際網路規模的應用程式,加速任何網站或網際網路應用程式抵禦 DDoS 攻擊,阻止駭客入侵,並且可以協助您實現 Zero Trust

從任何裝置造訪 1.1.1.1,即可開始使用我們的免費應用程式,讓您的網際網路更快速、更安全。

若要進一步瞭解我們協助打造更好的網際網路的使命,請從這裡開始。如果您正在尋找新的職業方向,請查看我們的職缺
Developer Week (TW)Cloudflare Workers (TW)Rate Limiting (TW)SDK (TW)Observability (TW)繁體中文

在 X 上進行關注

Tanushree Sharma|@_tanushreeeee
Jacob Bednarz|@jacobbednarz
Cloudflare|@cloudflare

相關貼文

2024年4月05日 下午1:01

Browser Rendering API 正式上市,推出 Cloudflare Snippets、SWR,並向所有使用者提供 Workers for Platforms

Browser Rendering API 現已向所有付費 Workers 客戶提供,並改進了工作階段管理...

2024年4月02日 下午1:01

升級 Workers AI:正式上市以及更多新功能

今天,我們發佈了一系列公告,包括 Cloudflare 的推斷平台 Workers AI 正式上市,以及使用 LoRA 和 HuggingFace 的一鍵部署支援經過微調的模型。Cloudflare Workers 現可支援 Python 程式設計語言等...