1105_安裝Nginx+Lua+OpenResty開發環境配置全過程例項_OK
安裝Nginx+Lua+OpenResty開發環境配置全過程例項
安裝Nginx+Lua+OpenResty開發環境配置全過程例項
OpenResty由Nginx核心加很多第三方模組組成，預設集成了Lua開發環境，使得Nginx可以作為一個Web Server使用。
藉助於Nginx的事件驅動模型和非阻塞IO，可以實現高效能的Web應用程式。
而且OpenResty提供了大量元件如Mysql、Redis、Memcached等等，使在Nginx上開發Web應用更方便更簡單。
目前在京東如實時價格、秒殺、動態服務、單品頁、列表頁等都在使用Nginx+Lua架構，其他公司如淘寶、去哪兒網等。
以下是本人整理的Nginx+Lua架構思維導圖：
一、安裝環境,安裝步驟可以參考http://openresty.org/#Installation
1、建立目錄/usr/servers，以後我們把所有軟體安裝在此目錄
[email protected]:~$ sudo su
[email protected]:/home/user# mkdir -p /usr/servers
[email protected]:/home/user# cd /usr/servers/
2、安裝依賴（我的環境是ubuntu，可以使用如下命令安裝，其他的可以參考openresty安裝步驟）
[email protected]:/usr/servers# apt-get install make
3、下載ngx_openresty-xxx.tar.gz並解壓(ngx_openresty-xxx/bundle目錄裡存放著nginx核心和很多第三方模組，比如有我們需要的Lua和LuaJIT。)
[email protected]:/usr/servers# wget https://openresty.org/download/ngx_openresty-1.9.7.1.tar.gz
[email protected]:/usr/servers# cd ngx_openresty-1.9.7.1
4、安裝LuaJIT
[email protected]:/usr/servers/ngx_openresty-1.9.7.1# cd bundle/LuaJIT-2.1-20151219/
[email protected]:/usr/servers/ngx_openresty-1.9.7.1/bundle/LuaJIT-2.1-20151219# make clean && make && make install
[email protected]:/usr/servers/ngx_openresty-1.9.7.1/bundle/LuaJIT-2.1-20151219# ln -sf luajit-2.1.0-alpha /usr/local/bin/luajit
5、下載ngx_cache_purge模組，該模組用於清理nginx快取
[email protected]:/usr/servers/ngx_openresty-1.9.7.1/bundle# wget https://github.com/FRiCKLE/ngx_cache_purge/archive/2.3.tar.gz
[email protected]:/usr/servers/ngx_openresty-1.9.7.1/bundle# tar -xvf 2.3.tar.gz
6、下載nginx_upstream_check_module模組，該模組用於ustream健康檢查
[email protected]:/usr/servers/ngx_openresty-1.9.7.1/bundle# wget https://github.com/yaoweibin/nginx_upstream_check_module/archive/v0.3.0.tar.gz
[email protected]:/usr/servers/ngx_openresty-1.9.7.1/bundle# tar -xvf v0.3.0.tar.gz
7、安裝ngx_openresty
[email protected]:/usr/servers/ngx_openresty-1.9.7.1/bundle# cd ..
[email protected]:/usr/servers/ngx_openresty-1.9.7.1# ./configure --prefix=/usr/servers --with-http_realip_module --with-pcre --with-luajit --add-module=./bundle/ngx_cache_purge-2.3/ --add-module=./bundle/nginx_upstream_check_module-0.3.0/ -j2
[email protected]:/usr/servers/ngx_openresty-1.9.7.1# make && make install
引數說明：
--with*** 安裝一些內建/整合的模組
--with-http_realip_module 取使用者真實ip模組
-with-pcre Perl相容的達式模組
--with-luajit 整合luajit模組
--add-module 新增自定義的第三方模組，如此次的ngx_che_purge
8、到/usr/servers目錄下用ll命令檢視，會發現多出來瞭如下目錄，說明安裝成功
[email protected]:/usr/servers/ngx_openresty-1.9.7.1# cd /usr/servers/
[email protected]:/usr/servers# ll
total 3496
drwxr-xr-x 7 root root 4096 Jan 11 18:09 ./
drwxr-xr-x 11 root root 4096 Jan 11 17:14 ../
drwxr-xr-x 2 root root 4096 Jan 11 18:09 bin/
drwxr-xr-x 6 root root 4096 Jan 11 18:09 luajit/
drwxr-xr-x 5 root root 4096 Jan 11 18:09 lualib/
drwxr-xr-x 6 root root 4096 Jan 11 18:09 nginx/
drwxrwxr-x 5 user user 4096 Jan 11 18:08 ngx_openresty-1.9.7.1/
-rw-r--r-- 1 root root 3548444 Jan 1 06:15 ngx_openresty-1.9.7.1.tar.gz
[email protected]:/usr/servers#
說明：
/usr/servers/luajit ：luajit環境，luajit類似於java的jit，即即時編譯，lua是一種解釋語言，通過luajit可以即時編譯lua程式碼到機器程式碼，得到很好的效能；
/usr/servers/lualib：要使用的lua庫，裡邊提供了一些預設的lua庫，如redis，json庫等，也可以把一些自己開發的或第三方的放在這；
/usr/servers/nginx ：安裝的nginx，通過/usr/servers/nginx/sbin/nginx -V 檢視nginx版本和安裝的模組
[email protected]:/usr/servers# /usr/servers/nginx/sbin/nginx -V
nginx version: openresty/1.9.7.1
built by gcc 4.6.3 (Ubuntu/Linaro 4.6.3-1ubuntu5)
built with OpenSSL 1.0.1 14 Mar 2012
TLS SNI support enabled
configure arguments: --prefix=/usr/servers/nginx --with-cc-opt=-O2 --add-module=../ngx_devel_kit-0.2.19 --add-module=../echo-nginx-module-0.58 --add-module=../xss-nginx-module-0.05 --add-module=../ngx_coolkit-0.2rc3 --add-module=../set-misc-nginx-module-0.29 --add-module=../form-input-nginx-module-0.11 --add-module=../encrypted-session-nginx-module-0.04 --add-module=../srcache-nginx-module-0.30 --add-module=../ngx_lua-0.9.20 --add-module=../ngx_lua_upstream-0.04 --add-module=../headers-more-nginx-module-0.29 --add-module=../array-var-nginx-module-0.04 --add-module=../memc-nginx-module-0.16 --add-module=../redis2-nginx-module-0.12 --add-module=../redis-nginx-module-0.3.7 --add-module=../rds-json-nginx-module-0.14 --add-module=../rds-csv-nginx-module-0.07 --with-ld-opt=-Wl,-rpath,/usr/servers/luajit/lib --with-http_realip_module --with-pcre --add-module=/usr/servers/ngx_openresty-1.9.7.1/bundle/ngx_cache_purge-2.3 --add-module=/usr/servers/ngx_openresty-1.9.7.1/bundle/nginx_upstream_check_module-0.3.0 --with-http_ssl_module
[email protected]:/usr/servers#
7、啟動nginx
[email protected]:/usr/servers# /usr/servers/nginx/sbin/nginx
檢測配置是否正確（需要先切換到root使用者）：
[email protected]:/usr/servers# /usr/servers/nginx/sbin/nginx -t
重啟nginx：
[email protected]:/usr/servers# /usr/servers/nginx/sbin/nginx -s reload
--------------------------------------
二、配置nginx+lua開發環境
配置及Nginx HttpLuaModule文件在可以檢視http://wiki.nginx.org/HttpLuaModule
1、為了方便開發我們在/usr/servers/nginx/conf目錄下建立一個lua.conf
[email protected]:/home/user# cd /usr/servers/nginx/conf
[email protected]:/usr/servers/nginx/conf# vim lua.conf
server {
listen 80;
server_name _;
#HelloWorld
location /lua {
default_type 'text/html';
content_by_lua 'ngx.say("hello world")';
}
}
2、編輯nginx.conf配置檔案
vim /usr/servers/nginx/conf/nginx.conf
在http部分新增如下配置
lua_package_path "/usr/servers/lualib/?.lua;;"; #lua 模組
lua_package_cpath "/usr/servers/lualib/?.so;;"; #c模組
include lua.conf; #單獨lua配置
#lua模組路徑，多個之間”;”分隔，其中”;;”表示預設搜尋路徑，預設到/usr/servers/nginx下找
例如：
http {
include mime.types;
default_type application/octet-stream;
//.....
lua_package_path "/usr/servers/lualib/?.lua;;";
lua_package_cpath "/usr/servers/lualib/?.so;;";
include lua.conf;
}
3、測試是否正常
[email protected]:/usr/servers/nginx/conf# /usr/servers/nginx/sbin/nginx -t
如果顯示如下內容說明配置成功
nginx: the configuration file /usr/servers/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/servers/nginx/conf/nginx.conf test is successful
4、重啟nginx
/usr/servers/nginx/sbin/nginx -s reload
5、訪問如http://10.0.2.81/lua（自己的機器根據實際情況換ip），可以看到如下內容
hello world
說明配置成功。
--------------------------------------
三、lua程式碼檔案和快取
1、lua_code_cache
預設情況下lua_code_cache 是開啟的，即快取lua程式碼，即每次lua程式碼變更必須reload nginx才生效，
如果在開發階段可以通過lua_code_cache off;關閉快取，這樣除錯時每次修改lua程式碼不需要reload nginx；但是正式環境一定記得開啟快取。
2、lua程式碼檔案
我們把lua程式碼放在nginx配置中會隨著lua的程式碼的增加導致配置檔案太長不好維護，因此我們應該把lua程式碼移到外部檔案中儲存。
[email protected]:/home/user# cd /usr/servers/
[email protected]:/usr/servers# mkdir lua
[email protected]:/usr/servers# cd lua
[email protected]:/usr/servers# vim test.lua
#新增如下內容
ngx.say("hello world by lua!");
然後lua.conf修改為：
location /lua {
default_type 'text/html';
lua_code_cache off;
content_by_lua_file /usr/servers/lua/test.lua;
}
3、重啟nginx
/usr/servers/nginx/sbin/nginx -s reload
關閉快取後會看到如下報警（忽略不管）
nginx: [alert] lua_code_cache is off; this will hurt performance in /usr/servers/nginx/conf/lua.conf:7
4、再次訪問如http://10.0.2.81/lua（自己的機器根據實際情況換ip），可以看到如下內容：
hello world by lua!
5、錯誤日誌
如果執行過程中出現錯誤，請不要忘記檢視錯誤日誌。
tail -f /usr/servers/nginx/logs/error.log
到此nginx+lua基本環境搭建完畢。
--------------------------------------
四、nginx+lua專案構建
把nginx lua開發檔案其專案化方便開發。專案目錄結構如下所示：
servers
lua.conf ---該專案的nginx 配置檔案
lua ---我們自己的lua程式碼
test.lua
lualib ---lua依賴庫/第三方依賴
*.lua
*.so
其中把lualib放到專案中以後可以一起部署，防止有的伺服器忘記複製依賴而造成缺少依賴的情況。
將專案放到/usr/servers/目錄下。
/usr/servers/nginx/conf/nginx.conf配置檔案如下(此處我們最小化了配置檔案)
#user nobody;
worker_processes 2;
error_log logs/error.log;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type text/html;
#lua模組路徑，其中”;;”表示預設搜尋路徑，預設到/usr/servers/nginx下找
lua_package_path "/usr/servers/lualib/?.lua;;"; #lua 模組
lua_package_cpath "/usr/servers/lualib/?.so;;"; #c模組
include /usr/servers/lua.conf;
}
通過絕對路徑包含我們的lua依賴庫和nginx專案配置檔案。
/usr/servers/lua.conf配置檔案如下（可以直接把上面配置的檔案移動過來，[email protected]:/usr/servers/nginx/conf# mv lua.conf /usr/servers/）
server {
listen 80;
server_name _;
location /lua {
default_type 'text/html';
lua_code_cache off;
content_by_lua_file /usr/servers/lua/test.lua;
}
}
lua檔案我們使用絕對路徑/usr/servers/lua/test.lua。