### 歡迎訪問我的GitHub
> 這裡分類和彙總了欣宸的全部原創(含配套原始碼)：[https://github.com/zq2599/blog_demos](https://github.com/zq2599/blog_demos)

### 本篇概覽
- 本文是《Docker下的OpenResty三部曲》的第二章，在前文[《Docker下的OpenResty三部曲之一：極速體驗》](http://blog.itpub.net/70017844/viewspace-2895181/)我們簡單的體驗了Nginx+Lua提供的web服務，但是並沒有深入開發細節，今天就來一起實戰這個映象的製作過程；

### 實戰環境

- 作業系統：Ubuntu16；
- Docker版本：17.03.2-ce；

### 步驟列舉
- 此映象的準備工作如下：
1. 提前下載必要的資源：ngx_openresty、ngx_cache_purge、nginx_upstream_check_module；
2. 定製nginx.conf；
3. 開發用於demo演示的配置檔案和lua指令碼；

- 映象的Dockerfile指令碼中要做以下事情：
1. 源映象為Ubuntu 16；
2. 準備兩個目錄：nginx工作目錄/usr/servers，lua指令碼的存放目錄/usr/local/work；
3. apt換源，用阿里雲的源；
4. apt更新；
5. 安裝必要的應用，如gcc、libreadline-dev等；
6. 安裝ngx_cache_purge、nginx_upstream_check_module、ngx_openresty；
7. 將定製好的nginx.conf放入映象；
8. 將用於demo演示的配置檔案和lua指令碼放入映象；
9. 暴露80埠；
10. 配置容器啟動命令，啟動nginx；

### 準備材料
- 本次構建映象所需的材料我已準備齊全，您可以在github下載到：

| 名稱      |   連結 |   備註|
| :-------- | :----| :----|
| 專案主頁| https://github.com/zq2599/blog_download_files | 該專案在GitHub上的主頁 |
| git倉庫地址(https)| https://github.com/zq2599/blog_download_files.git | 該專案原始碼的倉庫地址，https協議 |
| git倉庫地址(ssh)| git@github.com:zq2599/blog_download_files.git | 該專案原始碼的倉庫地址，ssh協議 |

- 這個git專案中有多個目錄，本次所需的資源放在nginx_lua_docker_image_files，如下圖紅框所示：

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20201128154337612.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5,size_16,color_FFFFFF,t_70)
### Dockerfile檔案
- 下載了上述所有材料後，我們就可以進行構建了，Dockerfile也在上述材料中，內容如下，將我們前面列舉的工作逐個完成：

```bash
# Docker image for OpenResty study
# VERSION 0.0.1
# Author: bolingcavalry

#基礎映象使用ubuntu:16.04
FROM ubuntu:16.04

#作者
MAINTAINER BolingCavalry <zq2599>

#定義工作目錄
ENV WORK_PATH /usr/local/work

#定義安裝目錄
ENV INSTALL_PATH /usr/servers

#定義nginx-openresty資料夾名稱
ENV NGX_OPENRESTY_PACKAGE_NAME ngx_openresty-1.7.7.2

#定義ngx_cache_purge資料夾名稱，該模組用於清理nginx快取
ENV NGX_CACHE_PURGE_PACKAGE_NAME ngx_cache_purge-2.3

#定義nginx_upstream_check_module資料夾名稱，該模組用於ustream健康檢查
ENV NGX_UPSTREAM_CHECK_PACKAGE_NAME nginx_upstream_check_module-0.3.0

#建立工作目錄
RUN mkdir -p $WORK_PATH

#建立安裝目錄
RUN mkdir -p $INSTALL_PATH

#apt換源，用阿里雲的源，刪除原有的源
RUN rm /etc/apt/sources.list

#apt換源，用阿里雲的源，複製新的源
COPY ./sources.list /etc/apt/sources.list

#apt更新
RUN apt-get update

#建立安裝目錄
RUN apt-get install -y make gcc libreadline-dev libncurses5-dev libpcre3-dev libssl-dev perl

#把nginx-openresty資料夾複製到工作目錄
COPY ./$NGX_OPENRESTY_PACKAGE_NAME $INSTALL_PATH/$NGX_OPENRESTY_PACKAGE_NAME

######luajit start######
#進入make目錄，執行編譯luajit
RUN cd $INSTALL_PATH/$NGX_OPENRESTY_PACKAGE_NAME/bundle/LuaJIT-2.1-20150120/ && make clean && make && make install

#軟連線
RUN ln -sf luajit-2.1.0-alpha /usr/local/bin/luajit
######luajit end######

######module start######
#把ngx_cache_purge資料夾複製到工作目錄
COPY ./$NGX_CACHE_PURGE_PACKAGE_NAME $INSTALL_PATH/$NGX_OPENRESTY_PACKAGE_NAME/bundle/$NGX_CACHE_PURGE_PACKAGE_NAME

#把nginx_upstream_check_module資料夾複製到工作目錄
COPY ./$NGX_UPSTREAM_CHECK_PACKAGE_NAME $INSTALL_PATH/$NGX_OPENRESTY_PACKAGE_NAME/bundle/$NGX_UPSTREAM_CHECK_PACKAGE_NAME
######module end######

######ngx_openresty start######
#進入ngx_openresty目錄，執行configure，執行構建
RUN cd $INSTALL_PATH/$NGX_OPENRESTY_PACKAGE_NAME && ./configure --prefix=$INSTALL_PATH --with-http_realip_module  --with-pcre  --with-luajit --add-module=./bundle/$NGX_CACHE_PURGE_PACKAGE_NAME/ --add-module=./bundle/$NGX_UPSTREAM_CHECK_PACKAGE_NAME/ -j2 && make && make install  
######ngx_openresty end######

######複製配置檔案 start######
#刪除原有的nginx.conf
RUN rm $INSTALL_PATH/nginx/conf/nginx.conf
#用定製的nginx.conf
COPY ./nginx.conf $INSTALL_PATH/nginx/conf/ 
#將新的conf檔案放入指定位置，nginx.conf中對此檔案有include
COPY ./boling_cavalry.conf $WORK_PATH/
#建立放置lua庫的目錄
RUN mkdir $WORK_PATH/lualib
#複製一個lua庫檔案
COPY ./sequare.lua $WORK_PATH/lualib
#建立放置lua指令碼的目錄
RUN mkdir $WORK_PATH/lua
#複製一個lua的demo指令碼
COPY ./test_request.lua $WORK_PATH/lua
COPY ./get_sequare.lua $WORK_PATH/lua
######複製配置檔案 end######

#暴露8080埠
EXPOSE 80

#啟動NGINX
CMD ["/usr/servers/nginx/sbin/nginx", "-g", "daemon off;"]
```

-

- 以上指令碼都有註釋，就不再贅述太多了，有幾個關鍵點需要注意：
1. Nginx和OpenResty等安裝在/usr/servers目錄，而我們實戰的時候配置的conf檔案以及編寫的lua指令碼都存放在/usr/local/work目錄；
2. 記得安裝make、gcc等工具，否則無法編譯構建Nginx；
3. 雖然/usr/servers/nginx/sbin/nginx可以啟動nginx，但是會在後臺執行，在docker容器中如果最後一個啟動的程式不再佔有終端，docker服務就會停止該容器，所以需要新增"-g daemon off"引數，使得nginx程式不要以後臺服務的方式執行，這樣容器就不會退出了；

### 定製的nginx.conf
- 從Dockerfile中我們看見原有的nginx.conf被我們定製的同名檔案替換了，新的nginx.conf相比而言做了以下改動：

- 新增自定義模組所在目錄：
```bash
lua_package_path "/usr/local/work/lualib/?.lua;;";  #lua 模組  
lua_package_cpath "/usr/local/work/lualib/?.so;;";  #c模組
```

* 新增自定義配置檔案：
```bash
include /usr/local/work/boling_cavalry.conf;
```

### 自定義配置檔案boling_cavalry.conf

- 我們將lua相關實戰的配置都放在boling_cavalry.conf，避免頻繁修改nginx.conf：

```bash
server {  
    listen       80;  
    server_name  _;  
  
    location ~ /lua_request/(\d+)/(\d+) {  
        #設定nginx變數  
        set $a $1;   
        set $b $host;  
        default_type "text/html";  
        #nginx內容處理  
        content_by_lua_file /usr/local/work/lua/test_request.lua;  
        #內容體處理完成後呼叫  
        echo_after_body "ngx.var.b $b";  
    }

location ~ /lua_sequare/(\d+)/(\d+) {
        set $a $1;
        set $b $2;
        default_type "text/html";
        set_by_lua_file $num /usr/local/work/lua/get_sequare.lua;
	echo "長 : $a , 寬 : $b , 面積 : $num";
    }
}
```
- 如上所示，定義了兩個二級域名的入口邏輯：lua_request和lua_sequare，lua_request用content_by_lua_file命令委託test_request.lua生成頁面內容，lua_sequare用set_by_lua_file給num變數賦值；

### 指令碼test_request.lua

- 這個指令碼里是一些常用的OpenResty的API示例，來自開濤大神的文章[《第二章 OpenResty(Nginx+Lua)開發入門》](http://jinnianshilongnian.iteye.com/blog/2186448)；

### 指令碼get_sequare.lua
- 這個指令碼演示瞭如何使用自定義module，有個根據長和寬計算長方形面積的module：sequare.lua，如下所示：

```lua
-- square.lua 長方形模組
local _M = {}           -- 區域性的變數
_M._VERSION = '1.0'     -- 模組版本

local mt = { __index = _M }

function _M.new(self, width, height)
    return setmetatable({ width=width, height=height }, mt)
end

function _M.get_square(self)
    return self.width * self.height
end

function _M.get_circumference(self)
    return (self.width + self.height) * 2
end

return _M
```

- square可以接收長和寬兩個引數，然後返回計算結果，呼叫該module的程式碼在get_sequare.lua，如下：

```lua
local var = ngx.var
local i = var.a
local j = var.b
local sequare = require("sequare")
local s1 = sequare:new(i, j)

return s1:get_square() 
```

- 如上所示，接收boling_cavalry.conf中的配置傳來的長和寬兩個引數，呼叫sequare計算，返回結果；

### 構建映象
- 將上述材料全部準備完畢後，在Dockerfile檔案所在目錄執行以下命令即可構建Docker映象：

```bash
docker build -t bolingcavalry/ubuntu16-openresty:0.0.1 .
```

- 輸出資訊如下：

```bash
root@lua:~/work# docker build -t bolingcavalry/ubuntu16-openresty:0.0.1 .
Sending build context to Docker daemon 24.14 MB
Step 1/29 : FROM ubuntu:16.04
 ---> 0458a4468cbc
Step 2/29 : MAINTAINER BolingCavalry <zq2599>
 ---> Using cache
 ---> 16f3fb4a718e
Step 3/29 : ENV WORK_PATH /usr/local/work
 ---> Using cache
 ---> 921914bc99f0
Step 4/29 : ENV INSTALL_PATH /usr/servers
 ---> Using cache
 ---> d9b43a681758
Step 5/29 : ENV NGX_OPENRESTY_PACKAGE_NAME ngx_openresty-1.7.7.2
 ---> Using cache
 ---> 54b1aa1a7185
Step 6/29 : ENV NGX_CACHE_PURGE_PACKAGE_NAME ngx_cache_purge-2.3
 ---> Using cache
 ---> de9f34f26719
Step 7/29 : ENV NGX_UPSTREAM_CHECK_PACKAGE_NAME nginx_upstream_check_module-0.3.0
 ---> Using cache
 ---> 343a711f2ec7
Step 8/29 : RUN mkdir -p $WORK_PATH
 ---> Using cache
 ---> 7737165f680e
Step 9/29 : RUN mkdir -p $INSTALL_PATH
 ---> Using cache
 ---> f11bbb0c557d
Step 10/29 : RUN rm /etc/apt/sources.list
 ---> Using cache
 ---> 862747a9c96f
Step 11/29 : COPY ./sources.list /etc/apt/sources.list
 ---> Using cache
 ---> 3ca0839fc2ec
Step 12/29 : RUN apt-get update
 ---> Using cache
 ---> 81f808e0748b
Step 13/29 : RUN apt-get install -y make gcc libreadline-dev libncurses5-dev libpcre3-dev libssl-dev perl
 ---> Using cache
 ---> f4b9ff74e25d
Step 14/29 : COPY ./$NGX_OPENRESTY_PACKAGE_NAME $INSTALL_PATH/$NGX_OPENRESTY_PACKAGE_NAME
 ---> Using cache
 ---> 6877069f83e7
Step 15/29 : RUN cd $INSTALL_PATH/$NGX_OPENRESTY_PACKAGE_NAME/bundle/LuaJIT-2.1-20150120/ && make clean && make && make install
 ---> Using cache
 ---> b2a7f42a08b6
Step 16/29 : RUN ln -sf luajit-2.1.0-alpha /usr/local/bin/luajit
 ---> Using cache
 ---> c5cf9ba881aa
Step 17/29 : COPY ./$NGX_CACHE_PURGE_PACKAGE_NAME $INSTALL_PATH/$NGX_OPENRESTY_PACKAGE_NAME/bundle/$NGX_CACHE_PURGE_PACKAGE_NAME
 ---> Using cache
 ---> c49c78734c6d
Step 18/29 : COPY ./$NGX_UPSTREAM_CHECK_PACKAGE_NAME $INSTALL_PATH/$NGX_OPENRESTY_PACKAGE_NAME/bundle/$NGX_UPSTREAM_CHECK_PACKAGE_NAME
 ---> Using cache
 ---> b2257e5816d1
Step 19/29 : RUN cd $INSTALL_PATH/$NGX_OPENRESTY_PACKAGE_NAME && ./configure --prefix=$INSTALL_PATH --with-http_realip_module --with-pcre --with-luajit --add-module=./bundle/$NGX_CACHE_PURGE_PACKAGE_NAME/ --add-module=./bundle/$NGX_UPSTREAM_CHECK_PACKAGE_NAME/ -j2 && make && make install
 ---> Using cache
 ---> 84959b5d75d4
Step 20/29 : RUN rm $INSTALL_PATH/nginx/conf/nginx.conf
 ---> Using cache
 ---> 23c01dded8c4
Step 21/29 : COPY ./nginx.conf $INSTALL_PATH/nginx/conf/
 ---> Using cache
 ---> 776be05466ac
Step 22/29 : COPY ./boling_cavalry.conf $WORK_PATH/
 ---> 4aa8b7334045
Removing intermediate container f7e28f9fefba
Step 23/29 : RUN mkdir $WORK_PATH/lualib
 ---> Running in 053c920c4881
 ---> 90a35711cb82
Removing intermediate container 053c920c4881
Step 24/29 : COPY ./sequare.lua $WORK_PATH/lualib
 ---> 7d5ddc4a2896
Removing intermediate container ab8f06369aaa
Step 25/29 : RUN mkdir $WORK_PATH/lua
 ---> Running in 82739117102b
 ---> 440da8a1d071
Removing intermediate container 82739117102b
Step 26/29 : COPY ./test_request.lua $WORK_PATH/lua
 ---> adbce564c888
Removing intermediate container 1814b85953a4
Step 27/29 : COPY ./get_sequare.lua $WORK_PATH/lua
 ---> 7dd1d9c25b56
Removing intermediate container d7f97d15993a
Step 28/29 : EXPOSE 80
 ---> Running in 236bf062b73c
 ---> 3df5b6bbf8e7
Removing intermediate container 236bf062b73c
Step 29/29 : CMD /usr/servers/nginx/sbin/nginx -g daemon off;
 ---> Running in 20e3d9ce31de
 ---> 98b44edabb60
Removing intermediate container 20e3d9ce31de
Successfully built 98b44edabb60
```

### 實戰OpenResty
- 映象構建成功後，就可以像上一章那樣執行和體驗Nginx+Lua服務了，您也可以在容器中自己去修改或者新增Lua指令碼，實現更多的功能，修改完畢conf或者Lua指令碼後，記得執行以下兩個命令：
1. 測試Nginx配置：/usr/servers/nginx/sbin/nginx -t
2. Nginx重新載入配置：/usr/servers/nginx/sbin/nginx -c /usr/servers/nginx/conf/nginx.conf -s reload

- 至此，整個映象的製作過程就完成了，接下來的章節，我們去kubernetes實戰，搭建Nginx+Lua+Tomcat的綜合服務；

### 歡迎關注ITpub：程式設計師欣宸
> [學習路上，你不孤單，欣宸原創一路相伴...](http://blog.itpub.net/70017844/)</zq2599></zq2599>

Docker下的OpenResty三部曲之二：細說開發

相關文章