Linux下Nginx的安装、升级及动态添加模块

摘要：新版本主进程退出的同时，旧版本主进程将会自动启动它的工作进程。下面我们来看一下如何给运行中的添加模块。

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

系统基于ubuntu server 14.04.4 amd64

从Nginx官网下载Nginx，或者在Linux上执行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 编译器），这一步将报如下错误信息：

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，然后继续下面的操作

② 如果之前没有安装PCRE，这一步将报如下错误信息：

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，然后继续下面的操作

③ 如果之前没有安装zlib，这一步将报如下错误信息：

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，然后继续下面的操作

也可以跳过此步，执行默认安装，--prefix的默认值为/usr/local/nginx，Nginx官网对此有说明：Building nginx from Sources

make

sudo make install

当需要对正在运行的Nginx进行升级时，可以在不停止Nginx的情况下，使用新版本或者重编译的可执行程序替换旧版本的可执行程序，这里我们从nginx-1.10.1升级到nginx-1.11.1。

因为Nginx的升级，实质只是用新版本的可执行文件，替换旧版本的可执行程序，所以，对于备份，既可以只备份旧版本可执行文件，也可以打包备份整个旧版本安装目录，参考命令分别如下：
只备份旧版本可执行文件

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

打包备份整个旧版本安装目录

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

对于新版本Nginx压缩包的下载和解压，可以参考本文关于Nginx的安装部分的第一、二步。

因为只是对Nginx进行升级，并不涉及配置参数的修改，所以，我们一般使用和旧版本相同的配置(当然你也可以使用全新的配置信息)，来编译新版本的Nginx，使用如下命令查看旧版本配置信息：

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

可以得到结果如下：

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:]后面的参数信息，对新版本Nginx作相同配置，然后进行编译：

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

make

在上一步的基础上，执行一下命令即可：

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

执行这条命令，可能会报以下异常，提示文件被占用：

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$

可以使用以下命令进行强制覆盖：

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

发送 USR2信号给旧版本主进程号：

kill -USR2 旧版本的Nginx主进程号

旧版本Nginx主进程接收到-USR2信号，将重命名它的.pid文件为.oldpid，然后执行新版本的Nginx可执行程序，依次启动新版本的主进程和工作进程：

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)

此时，新、旧版本的Nginx实例会同时运行，共同处理请求，如果此时给旧版本主进程发送WINCH 信号，旧版本主进程将会给它的工作进程发送消息，请求它们从容关闭，此后，旧版本的工作进程开始逐步退出：

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)



从容关闭旧版本的工作进程命令：

kill -WINCH 旧版本的Nginx主进程号

经过一段时间后，旧的工作进程（work process）处理完了所有已连接的请求后退出，仅由新版本的工作进程来处理新的请求了：

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)



应该注意的是，此时，旧版本的主进程还尚未关闭它监听的套接字，如果有需要，你仍可以恢复旧版本工作进程。如果由于某些原因，新版本的可执行文件运行情况不理想，下面有几种方案可供参考：

给旧版本主进程发送 HUP 信号。旧版本主进程将在不重新读取配置信息的情况下，重新开启工作进程。然后，通过给新版本主进程发送 QUIT 信号，所有新版本的进程将会从容关闭。

给新版本主进程发送 TERM 信号。然后，他将会给它的工作进程发送消息，要求它们立即退出，紧接着，这些工作进程就会立即退出。（如果因为某些原因，新版本进程没有退出，应该给新版本主进程发送 KILL 信号，强制新版本主进程退出。）新版本主进程退出的同时，旧版本主进程将会自动启动它的工作进程。
新版本主进程退出后，旧版本主进程将会移除名字以.oldpid 结尾的文件，恢复为它的 .pid 文件。

如果升级成功，应该给旧版本主进程发送 QUIT 信号，使其退出，只保留新版本进程：

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时，只知道Nginx的功能是分模块的，并不清楚有些模块默认是不参与到构建中去的，比如ngx_http_ssl_module模块，是用来支持https协议的，默认情况下是没有构建到Nginx中的。
随着业务不断扩展，如果需要Nginx支持某些模块，而这些模块默认不在Nginx的构建计划中，构建Nginx时，又没有指定加入这些模块，该怎么办呢？是否能够给已经运行的Nginx动态添加这些模块呢？答案是肯定的！
给运行中的Nginx动态添加模块的方案，与上面提到的平滑升级Nginx的方案很类似。下面我们来看一下如何给运行中的Nginx添加 ngx_http_ssl_module 模块。

查看Nginx版本：

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

结果：

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

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

或者：

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

结果：

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:~$

这里可以看出，正在运行的Nginx版本为1.11.1，参照安装Nginx部分，下载并解压对应版本的Nginx

参考平滑升级的第三步，查看运行中的Nginx的配置参数，并在最后追加 -with-http_ssl_module。
如：原配置信息为 --prefix=/usr/local/nginx，则新配置信息为 --prefix=/usr/local/nginx --with_http_ssl_module，配置Nginx执行的命令如下：

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

这一步可以参考平滑升级的第四至八步