nsq: 基于 cosocket API 的 nginx-module-lua 的 Lua nsq 客户端驱动
安装
如果您尚未设置 RPM 仓库订阅,请 注册。然后您可以继续以下步骤。
CentOS/RHEL 7 或 Amazon Linux 2
yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install lua-resty-nsq
CentOS/RHEL 8+、Fedora Linux、Amazon Linux 2023
dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install lua5.1-resty-nsq
要在 NGINX 中使用此 Lua 库,请确保已安装 nginx-module-lua。
本文档描述了 lua-resty-nsq v0.1,发布于 2018 年 8 月 07 日。
此 Lua 库是 ngx_lua nginx 模块的 NSQ 客户端驱动:
此 Lua 库利用了 ngx_lua 的 cosocket API,确保 100% 非阻塞行为。
概述
server {
location /test {
content_by_lua_block {
local config = {
read_timeout = 3,
heartbeat = 1,
}
local producer = require "resty.nsq.producer"
local consumer = require "resty.nsq.consumer"
local cons = consumer:new()
local prod = producer:new()
local ok, err = cons:connect("127.0.0.1", 4150, config)
if not ok then
ngx.say("failed to connect: ", err)
return
end
local ok, err = prod:connect("127.0.0.1", 4150)
if not ok then
ngx.say("failed to connect: ", err)
return
end
ok, err = prod:pub("new_topic", "hellow world!")
if not ok then
ngx.say("failed to pub: ", err)
return
end
ok, err = prod:close()
if not ok then
ngx.say("failed to close: ", err)
return
end
ok, err = cons:sub("new_topic", "new_channel")
if not ok then
ngx.say("failed to sub: ", err)
return
end
local function read(c)
c:rdy(10)
local ret = cons:message()
ngx.say("sub success: ", require("cjson").encode(ret))
end
local co = ngx.thread.spawn(read, cons) -- read message in new thread
ngx.thread.wait(co)
ok, err = cons:close()
if not ok then
ngx.say("failed to close: ", err)
return
end
}
}
}
模块
resty.nsq.producer
方法
new
pub
resty.nsq.consumer
方法
new
另见
- ngx_lua 模块: https://github.com/openresty/lua-nginx-module/#readme
- nsq 有线协议规范: https://nsq.io/clients/tcp_protocol_spec.html
- openresty 中的信号量: ngx.sema
- openresty 中的线程: ngx.thread
GitHub
您可以在 nginx-module-nsq 的 GitHub 仓库 中找到此模块的其他配置提示和文档。