在 OpenResty Edge 中如何使用 EdgeLang
今天我將演示 OpenResty Edge 的另一個很酷的功能。就是如何使用我們基於規則的小語言,即 Edge 語言,簡稱 Edgelang。
Edgelang 簡介
使用者可以使用 Edgelang 來編寫複雜的閘道器規則,用於自定義認證、重寫請求和響應、配置動態上游路由等等。這些規則的執行速度通常要比手寫的 Lua 程式碼快很多。Edgelang 編譯器會生成高效的原生程式碼,在閘道器伺服器上執行。
Edgelang 編譯器是非常高效的。它實現了許多先進的最佳化技術。它支援將所有 Edgelang 規則所引用的正規表示式合併到一個狀態機中。這樣只需掃描一次請求資料,就會立即知道能匹配上哪些規則以及這些規則的哪些部分。
它還支援把所有 Edgelang 規則的常量字串字首和字尾模式組合成單一的樹狀資料結構。
新增使用 Edgelang 定義的頁面規則
讓我們進入 OpenResty Edge 的 Admin Web 控制檯。這就是我們控制檯的樣本部署。每個使用者都有自己的本地部署。
我們可以繼續使用之前的示例應用,test-edge.com。
進入該應用。
在之前的教程中我們已經建立了一個頁面規則。
這個頁面規則設定了一個反向代理到一個上游。
可以在這裡新增我們的 Edgelang 程式碼。
現在來新增第一條規則。
首先是規則的條件部分。條件是當 URI 是 “/foo/” 時。
用箭頭來標誌條件部分的結束。
箭頭之後,我們指定當條件得到滿足時要執行的動作。
這個動作啟動了一個 HTTP 重定向到 “/bar/” 頁面。
儲存這個規則。
正如我們看到的那樣,Edgelang 規範由規則組成。每個規則都有兩個基本部分:
一個是條件部分,
另外一個是由動作組成的結果。
條件和結果由一個箭頭連線。
整個規則以一個分號結束。
這只是一個最簡單的規則。我們可以隨意新增各種規則。一條規則可以有多個條件,各個條件之間可以用 AND 或者 OR 連線。一條規則在其結果部分也可以執行多個動作。
像往常一樣,需要釋出一個新的版本來推送我們剛才的改動。
點選這個按鈕。
釋出!
新版本現在已經同步到所有的閘道器伺服器上了。
現在,新的頁面規則已經被推送到所有的閘道器叢集和伺服器。
這些配置的變化不需要伺服器過載、重啟或二進位制升級。所以它是非常高效和可擴充套件的。
測試
在終端上,我們透過 curl
命令列工具向一個由 DNS 解析的閘道器伺服器傳送 HTTP 請求。
curl -I http://test-edge.com/bar/
請注意響應頭沒有重定向。
接下來,讓我們傳送一個帶有 /foo/
URI 的 HTTP 請求。
curl -I http://test-edge.com/foo/
可以看到這個請求已經被重定向了。
它被重定向到 /bar/ 這個位置。剛才定義的 Edgelang 規則生效了!
讓我們測試另一個字首為 “/foo/” 的 URI。
這個 URI 有一個額外的字尾,“blah/"。
傳送請求。
可以看到這個請求並沒有命中 Edgelang 規則。這是因為我們的 Edgelang 條件需要完全匹配 “/foo/"。
修改頁面規則的 Edgelang 定義
我們可以修改 Edgelang 規則中的條件部分來處理這種情況。
單擊 “編輯” 按鈕。
刪除原來的條件。
將其改為匹配 URI 字首 “/foo/"。
儲存這個規則。
再做一次新配置的釋出。
回到終端。再次傳送我們之前的測試請求。
仍然採用 “blah/” URI 的字尾。
傳送請求。
可以看到它觸發了一個重定向,這次是命中了我們的 Edgelang 規則。
接下來,讓我們傳送一個沒有任何額外 URI 字尾的 HTTP 請求。
curl -I http://test-edge.com/foo/
仍然能夠命中。
使用 Edgelang 定義 WAF 規則
我們可以在 Web 控制檯的許多不同地方使用 Edgelang。例如,可以用 EdgeLang 為 WAF,或 Web 應用防火牆新增自定義規則。
建立一個新的 WAF 規則。
在這裡寫入 Edgelang。
Edgelang 使用者手冊
Edgelang 是一種非常強大的語言,有很多特性。
如需瞭解更多,歡迎閱讀 Edgelang 使用者手冊。
手冊裡有許多程式碼例項。
非常詳細地介紹了 Edgelang 的各種用法。
這就是我今天要講的內容。
如果你喜歡這個教程,請訂閱這個部落格網站和我們的 YouTube 頻道 或 B 站頻道。謝謝!
關於本文和關聯影片
本文和相關聯的影片都是完全由我們的 OpenResty Showman 產品從一個簡單的劇本檔案自動生成的。
關於作者
章亦春是開源 OpenResty® 專案創始人兼 OpenResty Inc. 公司 CEO 和創始人。
章亦春(Github ID: agentzh),生於中國江蘇,現定居美國灣區。他是中國早期開源技術和文化的倡導者和領軍人物,曾供職於多家國際知名的高科技企業,如 Cloudflare、雅虎、阿里巴巴, 是 “邊緣計算“、”動態追蹤 “和 “機器程式設計 “的先驅,擁有超過 22 年的程式設計及 16 年的開源經驗。作為擁有超過 4000 萬全球域名使用者的開源專案的領導者。他基於其 OpenResty® 開源專案打造的高科技企業 OpenResty Inc. 位於美國矽谷中心。其主打的兩個產品 OpenResty XRay(利用動態追蹤技術的非侵入式的故障剖析和排除工具)和 OpenResty Edge(最適合微服務和分散式流量的全能型閘道器軟體),廣受全球眾多上市及大型企業青睞。在 OpenResty 以外,章亦春為多個開源專案貢獻了累計超過百萬行程式碼,其中包括,Linux 核心、Nginx、LuaJIT、GDB、SystemTap、LLVM、Perl 等,並編寫過 60 多個開源軟體庫。
關注我們
如果您喜歡本文,歡迎關注我們 OpenResty Inc. 公司的部落格網站 。也歡迎掃碼關注我們的微信公眾號:
翻譯
我們提供了英文版原文和中譯版(本文) 。我們也歡迎讀者提供其他語言的翻譯版本,只要是全文翻譯不帶省略,我們都將會考慮採用,非常感謝!