尝试在 CentOS7 上运行 Nginx Unit

2017.10.19

网络系统开发

1 目录
2 什么是 Nginx Unit？
3 安装方法
4 首先，启动服务
5 检查 Nginx 单元配置
6 更改 Nginx 单元设置
7 删除 Nginx 单元配置
8 概括

你好。
我是Mandai，负责Wild 开发团队。

大家都很喜欢不久前发布的新 Nginx 系列产品“Nginx Unit”。

我做了一些研究，了解如何使用 Nginx Unit。

什么是 Nginx Unit？

Nginx Unit 是一个中间件，它充当 Web 应用程序服务器，就像 Nginx 一样。

Nginx Unit 的特点如下：

动态修改配置文件（无需重启）
单个 Nginx 服务器可以运行多种编程语言的服务

据说有这样一个地方。

这次，我想实际安装一下，亲身感受一下它的使用体验。

安装方法

对于 CentOS 系统，可以通过 yum 安装，非常简单。

基本上官方文档，不过我们还是先安装一下吧。

首先，注册 Nginx Unit 仓库。

sudo vi /etc/yum.repos.d/unit.repo # 粘贴以下内容 [unit] name=unit repo baseurl=http://nginx.org/packages/mainline/centos/7/$basearch/ gpgcheck=0 enabled=1

准备工作到此完成。
接下来，运行 yum 命令。

yum install unit 已加载插件：fastestmirror、langpacks 从缓存的主机文件加载镜像速度 * base: ftp.riken.jp * epel: mirror.dmmlabs.jp * extras: ftp.riken.jp * nux-dextop: li.nux.ro * remi-safe: mirror.bebout.net * updates: ftp.riken.jp 正在解析依赖关系 --> 正在运行事务检查 ---> 正在安装软件包 unit.x86_64 0:0.1-1.el7.ngx --> 正在处理依赖关系：软件包 unit-0.1-1.el7.ngx.x86_64 的 libphp5-5.4.so()(64bit) --> 正在运行事务检查 ---> 正在安装软件包 php-embedded.x86_64 0:5.4.16-42.el7 --> 正在处理依赖关系：php-common(x86-64) =正在为软件包 php-embedded-5.4.16-42.el7.x86_64 安装 5.4.16-42.el7 版本 --> 正在运行事务检查 ---> 正在安装软件包 php-common.x86_64 0:5.4.16-42.el7 --> 正在处理依赖项：软件包 php-common-5.4.16-42.el7.x86_64 的 libzip.so.2()(64bit) --> 正在运行事务检查 ---> 正在安装软件包 libzip.x86_64 0:0.10.1-8.el7 --> 依赖关系解析完成。依赖关系已解析 ~ 省略 ~ 感谢您安装 NGINX Unit！您可能需要加载演示配置并检查几个应用程序： # service unitd start # service unitd restoreconfig /usr/share/doc/unit/examples/example.config # curl http://localhost:8300/ # curl http://localhost:8400/ 在线文档可在 http://unit.nginx.org/ 获取 ---------------------------------------------------------------------- 测试：php-embedded-5.4.16-42.el7.x86_64 1/4 测试：libzip-0.10.1-8.el7.x86_64 2/4 测试：php-common-5.4.16-42.el7.x86_64 3/4 测试：unit-0.1-1.el7.ngx.x86_64 4/4 已安装：unit.x86_64 0:0.1-1.el7.ngx 已安装依赖项：libzip.x86_64 0:0.10.1-8.el7 php-common.x86_64 0:5.4.16-42.el7 php-embedded.x86_64 0:5.4.16-42.el7 完成！

令人费解的是，PHP（而且还是版本 5！）竟然出现在依赖项检查中（可能是因为它从基础仓库拉取，同时提供运行时环境）。
如果您已经安装了 PHP，或者想在 PHP7 环境中使用它，那么从源代码安装似乎是更好的选择。

如果是源代码安装，您需要准备并编译与您的环境相匹配的库。
使用 yum 安装 PHP7 时似乎特别困难，因此请尝试按照以下

首先，启动服务

在 yum 安装界面的最后，有一个启动服务的命令，所以我先试试这个。
虽然它需要 CentOS 7，但它是以 service 命令的形式出现的，所以我将向您展示 systemctl 命令，这是我最近才学到的！

# 首先，启动服务 sudo systemctl start unitd # 恢复配置文件 $ service unitd restoreconfig /usr/share/doc/unit/examples/example.config 正在从 /usr/share/doc/unit/examples/example.config 恢复配置... { "success": "重新配置完成。" }

对于第二个命令，我不知道如何将其转换为 systemctl 命令，所以我直接使用了 service 命令。

顺便一提，如果将第一个命令作为服务命令运行，结果将如下所示。

sudo service unitd start 重定向到 /bin/systemctl start unitd.service

程序运行正常，但一直提示我用 systemctl 命令运行的。
然而，我用 restoreconfig 命令运行时并没有出现类似的警告信息，所以我怀疑使用 service 命令是否是正确的方法。

如果已经完成了以上步骤，它应该可以正常启动，所以你可能需要用 curl 命令检查一下它是否正常工作……但关键在于：在 Nginx 中，上述命令的执行顺序是相反的。在
Nginx 中更新配置文件后，总是需要重启服务，因此不可避免地会出现在运行过程中难以更改配置的情况。这
或许会被你忽略，但这正是你体验 Nginx Unit 优势的时刻。

现在请再次尝试访问网络服务器。

$ curl http://localhost:8300/phpinfo()  
[email protected] 。
 $ curl http://localhost:8400/ 2017-10-17 02:11:15 AM ENV Variables: LANG ja_JP.utf8 PATH /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin UNITD_OPTIONS --log /var/log/unitd.log --pid /run/unitd.pid

端口 8300 似乎正在作为正常的 Web 服务器运行，phpinfo() 函数也已执行。
端口 8400 目前情况不明，但它似乎正在显示运行时环境设置。
这个端口的奥秘将在稍后揭晓。

安装似乎很顺利，接下来我们将检查设置。

检查 Nginx 单元配置

目前看来，唯一像 Nginx Unit 配置文件的文件是 /usr/share/doc/unit/examples/example.config，所以我们来看看它。

less /usr/share/doc/unit/examples/example.config { "applications": { "example_php": { "type": "php", "user": "nobody", "workers": 2, "root": "/usr/share/doc/unit/examples/php-app", "index": "index.php" }, "example_python": { "type": "python", "user": "nobody", "workers": 2, "path": "/usr/share/doc/unit/examples/python-app", "module": "wsgi" }, "example_go": { "type": "go", "user": "nobody", "executable": "/tmp/go-app" } }, "listeners": { "*:8300": { "application": "example_php" }, "*:8400": { "application": "example_python" }, "*:8500": { "application": "example_go" } } }

打开文件后，我发现它是一个JSON文件。JSON
文件便于理解配置结构。

前面提到的“http://localhost:8400”实际上是 Python 程序的备用 URL。

阅读文档后，
似乎

curl --unix-socket /path/to/socket http://localhost/

但是，要做到这一点，我们需要知道套接字文件的位置，所以我们将从进程活动的角度来看待这个问题。

首先，使用 ps 命令识别 Nginx Unit 进程。

ps auxwwwf | grep [u]nit root 5821 0.0 0.0 18256 636 ? Ss 00:21 0:00 unit: main [/usr/sbin/unitd --log /var/log/unitd.log --pid /run/unitd.pid] nobody 5824 0.0 0.0 18256 680 ? S 00:21 0:00 \_ unit: controller nobody 5825 0.0 0.0 18256 680 ? S 00:21 0:00 \_ unit: router

Nginx Unit 似乎运行着三个进程：守护进程、控制器和路由器。
根据配置的不同，进程数可能会增加或减少，但目前就是这样设置的。

接下来，使用 lsof 命令检查进程 5821 正在保存的文件。

lsof -p 5821 COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME unitd 5821 root cwd DIR 253,0 4096 2 / unitd 5821 root rtd DIR 253,0 4096 2 / unitd 5821 root txt REG 253,0 397232 806046 /usr/sbin/unitd unitd 5821 root mem REG 253,0 37352 805753 /usr/lib64/libnss_sss.so.2 unitd 5821 root mem REG 253,0 62184 787847 /usr/lib64/libnss_files-2.17.so unitd 5821 root mem REG 253,0 2118128 787829 /usr/lib64/libc-2.17.so unitd 5821 root mem REG 253,0 143944 787855 /usr/lib64/libpthread-2.17.so unitd 5821 root mem REG 253,0 19776 787835 /usr/lib64/libdl-2.17.so unitd 5821 root mem REG 253,0 44448 787859 /usr/lib64/librt-2.17.so unitd 5821 root mem REG 253,0 1141928 787837 /usr/lib64/libm-2.17.so unitd 5821 root mem REG 253,0 155464 806682 /usr/lib64/ld-2.17.so unitd 5821 root 0u CHR 1,3 0t0 1028 /dev/null unitd 5821 root 1u CHR 1,3 0t0 1028 /dev/null unitd 5821 root 2w REG 253,0 258231 136119 /var/log/unitd.log unitd 5821 root 3u a_inode 0,9 0 5832 [eventpoll] unitd 5821 root 4u a_inode 0,9 0 5832 [signalfd] unitd 5821 root 5u a_inode 0,9 0 5832 [eventfd] unitd 5821 root 6u unix 0xffff8800783ba400 0t0 48362 /var/run/control.unit.sock # <- 此单元 5821 root 7w REG 253,0 258231 136119 /var/log/unitd.log unitd 5821 root 8u unix 0xffff880023ebb400 0t0 49423 socket unitd 5821 root 9u unix 0xffff880023ebb800 0t0 49424 socket unitd 5821 root 12u unix 0xffff8800b1954800 0t0 49428 socket unitd 5821 root 13u unix 0xffff880023eb9c00 0t0 49430 插座

看起来“/var/run/control.unit.sock”是套接字文件，因此检查设置的命令如下。

curl --unix-socket /var/run/control.unit.sock http://localhost/ { "applications": { "example_php": { "type": "php", "user": "nobody", "workers": 2, "root": "/usr/share/doc/unit/examples/php-app", "index": "index.php" }, "example_python": { "type": "python", "user": "nobody", "workers": 2, "path": "/usr/share/doc/unit/examples/python-app", "module": "wsgi" }, "example_go": { "type": "go", "user": "nobody", "executable": "/tmp/go-app" } }, "listeners": { "*:8300": { "application": "example_php" }, "*:8400": { "application": "example_python" }, "*:8500": { "application": "example_go" } } }

使用 curl 命令检查 Web 服务器配置对我来说是件很陌生的事，但返回的内容与“/usr/share/doc/unit/examples/example.config”相同。
这意味着测试配置文件已成功加载。

接下来，我想更改设置。

更改 Nginx 单元设置

查看
官方文档使用

# 示例：创建完整配置 curl -X PUT -d @/path/to/start.json \ --unix-socket ./control.unit.sock http://localhost/ # 示例：创建应用程序对象 curl -X PUT -d @/path/to/wiki.json \ --unix-socket ./control.unit.sock http://localhost/applications/wiki

第一种应用 JSON 文件的方法很容易理解，但第二种设置方法却很棘手。
你只能应用 JSON 文件的一部分，但必须使用 URL 指定要应用哪一部分……！

我还想测试读取我自己创建的JSON文件。
为了方便起见，我准备了以下JSON文件。

{
"type": "php",
"user": "nobody",
"workers": 4,
"root": "/var/www/html",
"index": "index.php"
}

这是一个简单的配置，将文档根目录设置为常见的“/var/www/html”目录，但它能正常工作吗？
请将此文件保存为“/home/hogehoge/test-php.json”。

让我们使用 curl 命令将此消息发送到 Nginx 单元！
直接将其添加到 applications 目录下。

curl -X PUT -d @/home/hogehoge/test-php.json --unix-socket /var/run/control.unit.sock http://localhost/applications/test { "success": "重新配置完成。" }

注册似乎成功了。
我们再检查一下当前的设置。

curl --unix-socket /var/run/control.unit.sock http://localhost/ { "applications": { "example_php": { "type": "php", "user": "nobody", "workers": 2, "root": "/usr/share/doc/unit/examples/php-app", "index": "index.php" }, "example_python": { "type": "python", "user": "nobody", "workers": 2, "path": "/usr/share/doc/unit/examples/python-app", "module": "wsgi" }, "example_go": { "type": "go", "user": "nobody", "executable": "/tmp/go-app" }, "test": { "type": "php", "user": "nobody", "workers": 4, "root": "/var/www/html", "index": "index.php" } }, "listeners": { "*:8300": { "application": "example_php" }, "*:8400": { "application": "example_python" }, "*:8500": { "application": "example_go" } } }

看起来添加成功了。
现在，我们用 curl 命令检查一下它是否正常工作……但是由于路由只有在监听器注册后才能生效，所以我们还需要添加一个用于路由的 JSON 文件。

{
“应用程序”：“测试”
}

我们将使用 curl 以与之前相同的方式注册上述 JSON。

curl -X PUT -d @/home/hogehoge/test-php-listener.json --unix-socket /var/run/control.unit.sock http://localhost/listeners/*:8301 { "success": "重新配置完成。" }

最后一个 URL 不太可能是这种情况，但它实际上并不是 URL，所以不用太担心。
成功返回后，请检查整个配置。

curl --unix-socket /var/run/control.unit.sock http://localhost/ { "applications": { "example_php": { "type": "php", "user": "nobody", "workers": 2, "root": "/usr/share/doc/unit/examples/php-app", "index": "index.php" }, "example_python": { "type": "python", "user": "nobody", "workers": 2, "path": "/usr/share/doc/unit/examples/python-app", "module": "wsgi" }, "example_go": { "type": "go", "user": "nobody", "executable": "/tmp/go-app" }, "test": { "type": "php", "user": "nobody", "workers": 4, "root": "/var/www/html", "index": "index.php" } }, "listeners": { "*:8300": { "application": "example_php" }, "*:8400": { "application": "example_python" }, "*:8500": { "application": "example_go" }, "*:8301": { "application": "test" } } }

设置似乎已成功应用。
使用 curl 命令或在浏览器中
“ （我之前使用 fuelPHP 开发的内容仍然位于此文档根目录下，并且没有出现任何问题。）

删除 Nginx 单元配置

进行更改时，您发送 curl HTTP 方法 PUT，因此删除时，您自然会使用 DELETE 方法。

您或许无需查看官方文档就能自行摸索，但我们还是再确认一下。
用于删除的 curl 命令如下：

curl -X DELETE --unix-socket ./control.unit.sock \ 'http://localhost/listeners/*:8400'

我们来尝试删除之前添加的监听器设置。

curl -X DELETE --unix-socket /var/run/control.unit.sock http://localhost/listeners/*:8301 { "success": "重新配置完成。" }

是的，似乎已经成功删除了。

这部分很简单。

顺便一提，由于输入和输出都是 JSON 格式，所以保存设置非常容易。

# 将 curl 的结果写入文件 curl --unix-socket /var/run/control.unit.sock http://localhost/ > /path/to/unitd.conf.json # 检查写入是否可行 cat /path/to/unitd.conf.json { "applications": { "example_php": { "type": "php", "user": "nobody", "workers": 2, "root": "/usr/share/doc/unit/examples/php-app", "index": "index.php" }, "example_python": { "type": "python", "user": "nobody", "workers": 2, "path": "/usr/share/doc/unit/examples/python-app", "module": "wsgi" }, "example_go": { "type": "go", "user": "nobody", "executable": "/tmp/go-app" }, "test": { "type": "php", "user": "nobody", "workers": 4, "root": "/var/www/html", "index": "index.php" } }, "listeners": { "*:8300": { "application": "example_php" }, "*:8400": { "application": "example_python" }, "*:8500": { "application": "example_go" } } } # 重启 Nginx Unit systemctl restart unitd # 检查配置，未输入任何内容 curl --unix-socket /var/run/control.unit.sock http://localhost/ { "listeners": {}, "applications": {} } # 将之前输出的 JSON 数据输入到文件中 curl -X PUT -d @/root/unitd.conf.json --unix-socket /var/run/control.unit.sock http://localhost { "success": "重新配置完成。" } # 检查设置是否生效 curl --unix-socket /var/run/control.unit.sock http://localhost/ { "applications": { "example_php": { "type": "php", "user": "nobody", "workers": 2, "root": "/usr/share/doc/unit/examples/php-app", "index": "index.php" }, "example_python": { "type": "python", "user": "nobody", "workers": 2, "path": "/usr/share/doc/unit/examples/python-app", "module": "wsgi" }, "example_go": { "type": "go", "user": "nobody", "executable": "/tmp/go-app" }, "test": { "type": "php", "user": "nobody", "workers": 4, "root": "/var/www/html", "index": "index.php" } }, "listeners": { "*:8300": { "application": "example_php" }, "*:8400": { "application": "example_python" }, "*:8500": { "application": "example_go" } } }

成功了！