Сборка nginx с модулем sticky на Ubuntu

Для корректной работы балансировщик nginx должен быть собран вместе с модулем sticky, который обеспечивает привязку определённой сессии пользователя к определённому BI-серверу. Рассмотрим порядок сборки в Ubuntu 18.04.

Сборка nginx

  1. Скачайте и распакуйте файлы модуля sticky по адресу: https://bitbucket.org/nginx-goodies/nginx-sticky-module-ng/src/master/.

  2. Скачайте nginx:

wget http://nginx.org/download/nginx-1.16.1.tar.gz
tar -xvf nginx-1.16.1.tar.gz
cd nginx-1.16.1/

  1. Установите зависимости, требуемые для работы nginx:

sudo apt-get install libxslt-dev
sudo apt install libgd-dev
sudo apt install openssl libssl-dev
sudo apt install libpcre3 libpcre3-dev
sudo apt install libgeoip-dev

  1. Сформируйте и выполните команду для конфигурирования сборки. В ключе --add-module укажите путь до установочных файлов sticky, полученных на первом шаге:

./configure --with-cc-opt='-g -O2 -fPIE -fstack-protector-strong -Wformat -Werror=format-security -Wdate-time -D_FORTIFY_SOURCE=2' --with-ld-opt='-Wl,-Bsymbolic-functions -fPIE -pie -Wl,-z,relro -Wl,-z,now' --prefix=/usr/share/nginx --conf-path=/etc/nginx/nginx.conf --http-log-path=/var/log/nginx/access.log --error-log-path=/var/log/nginx/error.log --lock-path=/var/lock/nginx.lock --pid-path=/run/nginx.pid --http-client-body-temp-path=/var/lib/nginx/body --http-fastcgi-temp-path=/var/lib/nginx/fastcgi --http-proxy-temp-path=/var/lib/nginx/proxy --http-scgi-temp-path=/var/lib/nginx/scgi --http-uwsgi-temp-path=/var/lib/nginx/uwsgi --with-debug --with-pcre-jit --with-ipv6 --with-http_ssl_module --with-http_stub_status_module --with-http_realip_module --with-http_auth_request_module --with-http_addition_module --with-http_dav_module --with-http_geoip_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_image_filter_module --with-http_v2_module --with-http_sub_module --with-http_xslt_module --with-stream --with-stream_ssl_module --with-mail --with-mail_ssl_module --with-threads --add-module=<путь до файлов sticky>

  1. Запустите сборку и установку nginx:

sudo make
sudo make install

Конфигурация nginx

При работе nginx использует настройки из конфигурационного файла nginx.conf, который располагается в папке /etc/nginx/. Пример структуры файла, необходимой для работы с BI-серверами, приведён в подразделе «Создание кластера BI-серверов>Настроить балансировщик на работу с BI-серверами». Более подробную информацию о директивах, используемых в конфигурационном файле, можно получить в документации разработчика по адресу https://nginx.org/ru/docs/.

Запуск nginx

Для запуска nginx выполните команду:

sudo /usr/share/nginx/sbin/nginx -h

Если требуется запустить nginx в виде фоновой службы выполните следующие действия:

  1. Создайте файл /lib/systemd/system/nginx.service.

  2. Добавьте в него параметры запуска службы:

[Unit]
Description=The NGINX HTTP and reverse proxy server
After=syslog.target network.target remote-fs.target nss-lookup.target
[Service]
Type=forking
PIDFile=/var/run/nginx.pid
ExecStartPre=/usr/share/nginx/sbin/nginx -t
ExecStart=/usr/share/nginx/sbin/nginx
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s QUIT $MAINPID
PrivateTmp=true
[Install]
WantedBy=multi-user.target

  1. Создайте каталог /var/lib/nginx:

sudo mkdir -p /var/lib/nginx

  1. Выполните команды для запуска службы:

systemctl unmask nginx.service
systemctl enable nginx
systemctl restart nginx

См. также:

Создание кластера BI-серверов