怎么用lua語言開發(fā)一個kong插件

這篇文章主要講解了“怎么用lua語言開發(fā)一個kong插件”，文中的講解內(nèi)容簡單清晰，易于學習與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學習“怎么用lua語言開發(fā)一個kong插件”吧！

站在用戶的角度思考問題，與客戶深入溝通，找到西鄉(xiāng)塘網(wǎng)站設(shè)計與西鄉(xiāng)塘網(wǎng)站推廣的解決方案，憑借多年的經(jīng)驗，讓設(shè)計與互聯(lián)網(wǎng)技術(shù)結(jié)合，創(chuàng)造個性化、用戶體驗好的作品，建站類型包括：成都網(wǎng)站制作、成都做網(wǎng)站、企業(yè)官網(wǎng)、英文網(wǎng)站、手機端網(wǎng)站、網(wǎng)站推廣、域名申請、網(wǎng)絡(luò)空間、企業(yè)郵箱。業(yè)務(wù)覆蓋西鄉(xiāng)塘地區(qū)。

需求：
 插件1: 把一個請求的 header、request、response 這些數(shù)據(jù)傳輸?shù)胶笈_，通過http接口、或者mq。
 插件2: 根據(jù) header 以及 request的信息，判斷用戶的權(quán)限，無權(quán)訪問或者訪問被限制，則直接網(wǎng)關(guān)層攔截返回response，不去調(diào)用后端服務(wù)。
lua版本：5.1
kong的版本：2.1.4
kong的架構(gòu)圖：

    從Kong的架構(gòu)圖中，可以看到Nginx和OpenResty的存在。OpenResty是以 Nginx 為核心的 Web 開發(fā)平臺，內(nèi)部包含lua-nginx-module，集成了大量精良的 Lua 庫，開發(fā)人員可以使用 Lua 腳本調(diào)動各類C和Lua 模塊。OpenResty目標是讓Web服務(wù)直接跑在 Nginx 服務(wù)內(nèi)部，利用 Nginx 的非阻塞I/O模型實現(xiàn)高性能響應(yīng)。而Kong 是OpenResty的一個應(yīng)用程序。
kong的插件開發(fā)基礎(chǔ)知識
 從基礎(chǔ)知識可以看出，我們的要開發(fā)插件主要是重寫kong提供的一些基礎(chǔ)方法，這些基礎(chǔ)方法對應(yīng)了網(wǎng)絡(luò)請求的生命周期的不同階段，實際上對應(yīng)了OpenResty 的不同執(zhí)行階段。所以在不同的生命周期，我們能拿到的數(shù)據(jù)是不同的，在不同的生命周期，有些函數(shù)和方法是不能使用的。
 如下報錯表示你的API放錯了生命周期：

function cannot be called in access phase (only in: header_filter, body_filter, log)

比如:Handler:access(請求被代理到上游服務(wù)之前執(zhí)行)階段調(diào)用獲取response的信息 kong.response.get_header()

API disabled in the context of log_by_lua*

比如：你在生命周期里直接調(diào)用http.new()去創(chuàng)建網(wǎng)絡(luò)請求。在NGINX的執(zhí)行階段使用某些函數(shù)，會影響客戶端的響應(yīng)時長。
 所以可以通過一個非常強大的方法 ngx.timer.at 在請求的生命周期中處理一些高延遲的業(yè)務(wù)邏輯。定時調(diào)用是在后臺運行，并且他們的執(zhí)行不會增加任何客戶端的響應(yīng)時長。

local timer_at = ngx.timer.at
local ok, err = timer_at(0, send_payload, conf, cjson.encode(json_str))
if not ok then
    kong.log.err("failed to create timer: ", err)
end
---timer_at(0, send_payload, conf, cjson.encode(json_str)) 0表示零延遲，send_payload表示要調(diào)用的方法，后面的參數(shù)表示send_payload該方法需要的入?yún)ⅰ?/p>

以上解決了一些插件編寫的基本規(guī)則層面的問題。

那么生命周期的不同階段如何共享數(shù)據(jù)呢？

比如：在 handler:log()階段獲取請求的reponse結(jié)果，在該階段可以獲取到

json_str['header'] = cjson_encode(kong.request.get_headers())
 json_str['request'] = cjson_encode(basic_serializer.serialize(ngx))
但是response是不能直接過去到的。所以我們可以在body_filter階段獲取到response 然后通過kong.ctx.shared or kong.ctx.plugin

kong.ctx.shared

一個 table 結(jié)構(gòu)的數(shù)據(jù)，它用于在給定請求的多個插件之間共享數(shù)據(jù)，由于它只與請求的上下文相關(guān)，所有無法從 Lua 模塊的頂級塊訪問此表，只能在請求段中訪問，對應(yīng)插件的 rewrite、 access、 header_filter、 body_filter、 log 接口
所有插件都可以看到單個插件在此 table 中插入的值命名時必須謹慎，因為命名沖突會導(dǎo)致數(shù)據(jù)被覆蓋。

kong.ctx.plugin

一個 table 結(jié)構(gòu)的數(shù)據(jù)，與 kong.ctx.shared 不同，此 table 不在插件之間共享，相反，它僅對當前插件實例可見，也就是說，如果配置了多個限流插件實例（在不同的服務(wù)上），每個實例對于每個請求都有自己的 table
由于它自帶命名空間，所以它比 kong.ctx.shared 更安全，因為它避免了潛在的命名沖突，這可能導(dǎo)致多個插件在不知不覺中覆蓋了彼此的數(shù)據(jù)

擴展部分：

在開發(fā)過程中，如果你像我一樣不太了解OpenResty的運行原理，那么可能會產(chǎn)生這樣的疑問：
 在高并發(fā)的情況下，會出現(xiàn)類似多線程的問題嗎？不同的請求在同一個插件下數(shù)據(jù)獲取會出錯嗎？
 解釋：
   Nginx采用多進程模型，單Master進程—多Worker進程（一般跟CPU的核數(shù)相同）由Master處理外部信號、配置文件的讀取及Worker的初始化，Worker進程采用單線程、非阻塞的事件模型（Event Loop，事件循環(huán)）來實現(xiàn)端口的監(jiān)聽及客戶端請求的處理和響應(yīng)，同時Worker還要處理來自Master的信號。由于Worker使用單線程處理各種事件，所以一定要保證主循環(huán)是非阻塞的，否則會大大降低Worker的響應(yīng)能力。
每個請求都有一個協(xié)程進行處理。

協(xié)程類似一種多線程，與多線程的區(qū)別有：

1. 協(xié)程并非os線程，所以創(chuàng)建、切換開銷比線程相對要小。

2. 協(xié)程與線程一樣有自己的棧、局部變量等，但是協(xié)程的棧是在用戶進程空間模擬的，所以創(chuàng)建、切換開銷很小。

3. 多線程程序是多個線程并發(fā)執(zhí)行，也就是說在一瞬間有多個控制流在執(zhí)行。而協(xié)程強調(diào)的是一種多個協(xié)程間協(xié)作的關(guān)系，只有當一個協(xié)程主動放棄執(zhí)行權(quán)，另一個協(xié)程才能獲得執(zhí)行權(quán)，所以在某一瞬間，多個協(xié)程間只有一個在運行。

4. 由于多個協(xié)程時只有一個在運行，所以對于臨界區(qū)的訪問不需要加鎖，而多線程的情況則必須加鎖。

5. 多線程程序由于有多個控制流，所以程序的行為不可控，而多個協(xié)程的執(zhí)行是由開發(fā)者定義的所以是可控的。
   Nginx的每個Worker進程都是在epoll或kqueue這樣的事件模型之上，封裝成協(xié)程，每個請求都有一個協(xié)程進行處理。這正好與Lua內(nèi)建協(xié)程的模型是一致的，所以即使ngx_lua需要執(zhí)行Lua，相對C有一定的開銷，但依然能保證高并發(fā)能力。

openresty/lua-nginx-module（官方介紹）
Kong的日志記錄（log）自定義插件
Kong插件開發(fā)工具包
OpenResty原理和緩存的實現(xiàn)
nginx+lua的基本原理概念介紹

 

感謝各位的閱讀，以上就是“怎么用lua語言開發(fā)一個kong插件”的內(nèi)容了，經(jīng)過本文的學習后，相信大家對怎么用lua語言開發(fā)一個kong插件這一問題有了更深刻的體會，具體使用情況還需要大家實踐驗證。這里是創(chuàng)新互聯(lián)，小編將為大家推送更多相關(guān)知識點的文章，歡迎關(guān)注！

網(wǎng)站名稱：怎么用lua語言開發(fā)一個kong插件
URL分享：http://bm7419.com/article40/igopho.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供動態(tài)網(wǎng)站、企業(yè)網(wǎng)站制作、網(wǎng)站收錄、移動網(wǎng)站建設(shè)、網(wǎng)站導(dǎo)航、用戶體驗

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請盡快告知，我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時需注明來源： 創(chuàng)新互聯(lián)