摘要：新版本主進(jìn)程退出的同時(shí)，舊版本主進(jìn)程將會(huì)自動(dòng)啟動(dòng)它的工作進(jìn)程。下面我們來看一下如何給運(yùn)行中的添加模塊。

原文鏈接：http://xueliang.org/article/detail/20160615172540639

系統(tǒng)基于ubuntu server 14.04.4 amd64

從Nginx官網(wǎng)下載Nginx，或者在Linux上執(zhí)行wget http://nginx.org/download/nginx-1.10.1.tar.gz命令直接下載
解壓nginx-1.10.1.tar.gz文件：

tar zxvf nginx-1.10.1.tar.gz

cd nginx-1.10.1
./configure --prefix=/usr/local/nginx

注意：
① 如果之前沒有安裝C compiler（C 編譯器），這一步將報(bào)如下錯(cuò)誤信息：

xueliang@dev:~/download/nginx-1.10.1$ ./configure --prefix=/usr/local/nginx
checking for OS

Linux 4.2.0-27-generic x86_64

for C compiler ... not found

./configure: error: C compiler cc is not found
xueliang@dev:~/download/nginx-1.10.1$

可以參考這篇文章安裝C compiler，然后繼續(xù)下面的操作

② 如果之前沒有安裝PCRE，這一步將報(bào)如下錯(cuò)誤信息：

checking for PCRE library ... not found

checking for PCRE library in /usr/local/ ... not found
checking for PCRE library in /usr/include/pcre/ ... not found
checking for PCRE library in /usr/pkg/ ... not found
checking for PCRE library in /opt/local/ ... not found

./configure: error: the HTTP rewrite module requires the PCRE library.

You can either disable the module by using --without-http_rewrite_module
option, or install the PCRE library into the system, or build the PCRE library
statically from the source with nginx by using --with-pcre= option.

xueliang@dev:~/download/nginx-1.10.1$

可以參考這篇文章安裝PCRE，然后繼續(xù)下面的操作

③ 如果之前沒有安裝zlib，這一步將報(bào)如下錯(cuò)誤信息：

checking for md5 in system md library ... not found
checking for md5 in system md5 library ... not found
checking for md5 in system OpenSSL crypto library ... not found
checking for sha1 in system md library ... not found
checking for sha1 in system OpenSSL crypto library ... not found
checking for zlib library ... not found
./configure: error: the HTTP gzip module requires the zlib library.
You can either disable the module by using --without-http_gzip_module
option, or install the zlib library into the system, or build the zlib library
statically from the source with nginx by using --with-zlib= option.
xueliang@dev:~/download/nginx-1.10.1$

可以參考這篇文章安裝zlib，然后繼續(xù)下面的操作

也可以跳過此步，執(zhí)行默認(rèn)安裝，--prefix的默認(rèn)值為/usr/local/nginx，Nginx官網(wǎng)對(duì)此有說明：Building nginx from Sources

make

sudo make install

當(dāng)需要對(duì)正在運(yùn)行的Nginx進(jìn)行升級(jí)時(shí)，可以在不停止Nginx的情況下，使用新版本或者重編譯的可執(zhí)行程序替換舊版本的可執(zhí)行程序，這里我們從nginx-1.10.1升級(jí)到nginx-1.11.1。

因?yàn)镹ginx的升級(jí)，實(shí)質(zhì)只是用新版本的可執(zhí)行文件，替換舊版本的可執(zhí)行程序，所以，對(duì)于備份，既可以只備份舊版本可執(zhí)行文件，也可以打包備份整個(gè)舊版本安裝目錄，參考命令分別如下：
只備份舊版本可執(zhí)行文件

sudo cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak

打包備份整個(gè)舊版本安裝目錄

 sudo tar -cvf /usr/local/nginx.bak /usr/local/nginx

對(duì)于新版本Nginx壓縮包的下載和解壓，可以參考本文關(guān)于Nginx的安裝部分的第一、二步。

因?yàn)橹皇菍?duì)Nginx進(jìn)行升級(jí)，并不涉及配置參數(shù)的修改，所以，我們一般使用和舊版本相同的配置(當(dāng)然你也可以使用全新的配置信息)，來編譯新版本的Nginx，使用如下命令查看舊版本配置信息：

/usr/local/nginx/sbin/nginx -V

可以得到結(jié)果如下：

xueliang@dev:~/download/nginx-1.11.1$ /usr/local/nginx/sbin/nginx -V
nginx version: nginx/1.10.1
built by gcc 4.8.4 (Ubuntu 4.8.4-2ubuntu1~14.04.3)
configure arguments: --prefix=/usr/local/nginx
xueliang@dev:~/download/nginx-1.11.1$

其中 [configure arguments: --prefix=/usr/local/nginx] 這一行即為舊版本Nginx配置信息，這里可以看出，舊版本只是指定了安裝路徑，使用[configure arguments:]后面的參數(shù)信息，對(duì)新版本Nginx作相同配置，然后進(jìn)行編譯：

./configure --prefix=/usr/local/nginx

make

在上一步的基礎(chǔ)上，執(zhí)行一下命令即可：

sudo cp objs/nginx /usr/local/nginx/sbin/nginx

執(zhí)行這條命令，可能會(huì)報(bào)以下異常，提示文件被占用：

xueliang@dev:~/download/nginx-1.11.1$ sudo cp objs/nginx /usr/local/nginx/sbin/nginx
cp: cannot create regular file ‘/usr/local/nginx/sbin/nginx’: Text file busy
xueliang@dev:~/download/nginx-1.11.1$

可以使用以下命令進(jìn)行強(qiáng)制覆蓋：

sudo cp -rfp objs/nginx /usr/local/nginx/sbin/nginx

發(fā)送 USR2信號(hào)給舊版本主進(jìn)程號(hào)：

kill -USR2 舊版本的Nginx主進(jìn)程號(hào)

舊版本Nginx主進(jìn)程接收到-USR2信號(hào)，將重命名它的.pid文件為.oldpid，然后執(zhí)行新版本的Nginx可執(zhí)行程序，依次啟動(dòng)新版本的主進(jìn)程和工作進(jìn)程：

PID
PPID
USER
%CPU
VSZ
WCHAN
COMMAND



33126
1
root
0.0
1164
pause
nginx: master process /usr/local/nginx/sbin/nginx


33134
33126
nobody
0.0
1368
kqread
nginx: worker process (nginx)


33135
33126
nobody
0.0
1380
kqread
nginx: worker process (nginx)


33136
33126
nobody
0.0
1368
kqread
nginx: worker process (nginx)


36264
33126
root
0.0
1148
pause
nginx: master process /usr/local/nginx/sbin/nginx


36265
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)


36266
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)


36267
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)

此時(shí)，新、舊版本的Nginx實(shí)例會(huì)同時(shí)運(yùn)行，共同處理請(qǐng)求，如果此時(shí)給舊版本主進(jìn)程發(fā)送WINCH 信號(hào)，舊版本主進(jìn)程將會(huì)給它的工作進(jìn)程發(fā)送消息，請(qǐng)求它們從容關(guān)閉，此后，舊版本的工作進(jìn)程開始逐步退出：

PID
PPID
USER
%CPU
VSZ
WCHAN
COMMAND



33126
1
root
0.0
1164
pause
nginx: master process /usr/local/nginx/sbin/nginx


33135
33126
nobody
0.0
1380
kqread
nginx: worker process is shutting down (nginx)


36264
33126
root
0.0
1148
pause
nginx: master process /usr/local/nginx/sbin/nginx


36265
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)


36266
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)


36267
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)



從容關(guān)閉舊版本的工作進(jìn)程命令：

kill -WINCH 舊版本的Nginx主進(jìn)程號(hào)

經(jīng)過一段時(shí)間后，舊的工作進(jìn)程（work process）處理完了所有已連接的請(qǐng)求后退出，僅由新版本的工作進(jìn)程來處理新的請(qǐng)求了：

PID
PPID
USER
%CPU
VSZ
WCHAN
COMMAND



33126
1
root
0.0
1164
pause
nginx: master process /usr/local/nginx/sbin/nginx


36264
33126
root
0.0
1148
pause
nginx: master process /usr/local/nginx/sbin/nginx


36265
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)


36266
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)


36267
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)



應(yīng)該注意的是，此時(shí)，舊版本的主進(jìn)程還尚未關(guān)閉它監(jiān)聽的套接字，如果有需要，你仍可以恢復(fù)舊版本工作進(jìn)程。如果由于某些原因，新版本的可執(zhí)行文件運(yùn)行情況不理想，下面有幾種方案可供參考：

給舊版本主進(jìn)程發(fā)送 HUP 信號(hào)。舊版本主進(jìn)程將在不重新讀取配置信息的情況下，重新開啟工作進(jìn)程。然后，通過給新版本主進(jìn)程發(fā)送 QUIT 信號(hào)，所有新版本的進(jìn)程將會(huì)從容關(guān)閉。

給新版本主進(jìn)程發(fā)送 TERM 信號(hào)。然后，他將會(huì)給它的工作進(jìn)程發(fā)送消息，要求它們立即退出，緊接著，這些工作進(jìn)程就會(huì)立即退出。（如果因?yàn)槟承┰?，新版本進(jìn)程沒有退出，應(yīng)該給新版本主進(jìn)程發(fā)送 KILL 信號(hào)，強(qiáng)制新版本主進(jìn)程退出。）新版本主進(jìn)程退出的同時(shí)，舊版本主進(jìn)程將會(huì)自動(dòng)啟動(dòng)它的工作進(jìn)程。
新版本主進(jìn)程退出后，舊版本主進(jìn)程將會(huì)移除名字以.oldpid 結(jié)尾的文件，恢復(fù)為它的 .pid 文件。

如果升級(jí)成功，應(yīng)該給舊版本主進(jìn)程發(fā)送 QUIT 信號(hào)，使其退出，只保留新版本進(jìn)程：

PID
PPID
USER
%CPU
VSZ
WCHAN
COMMAND



36264
33126
root
0.0
1148
pause
nginx: master process /usr/local/nginx/sbin/nginx


36265
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)


36266
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)


36267
36264
nobody
0.0
1364
kqread
nginx: worker process (nginx)

剛接觸Nginx時(shí)，只知道Nginx的功能是分模塊的，并不清楚有些模塊默認(rèn)是不參與到構(gòu)建中去的，比如ngx_http_ssl_module模塊，是用來支持https協(xié)議的，默認(rèn)情況下是沒有構(gòu)建到Nginx中的。
隨著業(yè)務(wù)不斷擴(kuò)展，如果需要Nginx支持某些模塊，而這些模塊默認(rèn)不在Nginx的構(gòu)建計(jì)劃中，構(gòu)建Nginx時(shí)，又沒有指定加入這些模塊，該怎么辦呢？是否能夠給已經(jīng)運(yùn)行的Nginx動(dòng)態(tài)添加這些模塊呢？答案是肯定的！
給運(yùn)行中的Nginx動(dòng)態(tài)添加模塊的方案，與上面提到的平滑升級(jí)Nginx的方案很類似。下面我們來看一下如何給運(yùn)行中的Nginx添加 ngx_http_ssl_module 模塊。

查看Nginx版本：

/usr/local/nginx/sbin/nginx -v

結(jié)果：

xueliang@dev:~$ /usr/local/nginx/sbin/nginx -v

nginx version: nginx/1.11.1
xueliang@dev:~$

或者：

/usr/local/nginx/sbin/nginx -V

結(jié)果：

xueliang@dev:~$ /usr/local/nginx/sbin/nginx -V

nginx version: nginx/1.11.1
built by gcc 4.8.4 (Ubuntu 4.8.4-2ubuntu1~14.04.3)
configure arguments: --prefix=/usr/local/nginx
xueliang@dev:~$

這里可以看出，正在運(yùn)行的Nginx版本為1.11.1，參照安裝Nginx部分，下載并解壓對(duì)應(yīng)版本的Nginx

參考平滑升級(jí)的第三步，查看運(yùn)行中的Nginx的配置參數(shù)，并在最后追加 -with-http_ssl_module。
如：原配置信息為 --prefix=/usr/local/nginx，則新配置信息為 --prefix=/usr/local/nginx --with_http_ssl_module，配置Nginx執(zhí)行的命令如下：

./configure --prefix=/usr/local/nginx --with_http_ssl_module

這一步可以參考平滑升級(jí)的第四至八步