183 lines
8.4 KiB
Markdown
183 lines
8.4 KiB
Markdown
|
# Сборка пакета
|
|||
|
|
|
|||
|
|
## Сборка бинарного файла с использованием docker-образа
|
|||
|
|
|
|||
|
|
Для сборки образа скачайте и разархивируйте nginx в корень проекта:
|
|||
|
|
Например так:
|
|||
|
|
```
|
|||
|
|
wget https://nginx.org/download/nginx-1.26.3.tar.gz
|
|||
|
|
tar xvf nginx-1.26.3.tar.gz
|
|||
|
|
```
|
|||
|
|
Далее соберите образ, используя Dockerfile в корне проекта (сборка под almalinux:9):
|
|||
|
|
```
|
|||
|
|
docker build -t nginx-mod_rewrite .
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Получаем образ с nginx и собранным mod_rewrite.
|
|||
|
|
|
|||
|
|
Для запуска образа необходимо выполнить команду:
|
|||
|
|
```
|
|||
|
|
docker run --name nginx-mod_rewrite -p 8080:80 -p 8081:8081 nginx-mod_rewrite
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Сборка пакета под заданную операционную систему
|
|||
|
|
|
|||
|
|
В корне проекта расположен скрипт `package_preparer.sh`, который позволяет собрать rpm или deb пакет под определенную операционную систему. Под какую операционную систему и нативную версию nginx будет собран пакет, зависит от используемого образа.
|
|||
|
|
|
|||
|
|
Для сборки пакета необходимо запустить команду:
|
|||
|
|
```
|
|||
|
|
bash package_preparer.sh prepare "almalinux:9"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Сборка проверялась на образах:
|
|||
|
|
|
|||
|
|
* almalinux:9
|
|||
|
|
* almalinux:8
|
|||
|
|
* rockylinux:9
|
|||
|
|
* ubuntu:24.04
|
|||
|
|
* debian:stable
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
После сборки собранные пакеты появятся в каталоге tmpbuild:
|
|||
|
|
```
|
|||
|
|
$ ls -1 tmpbuild/*.rpm
|
|||
|
|
tmpbuild/nginx-mod-rewrite-0.1-1.el9.src.rpm
|
|||
|
|
tmpbuild/nginx-mod-rewrite-0.1-1.el9.x86_64.rpm
|
|||
|
|
tmpbuild/nginx-mod-rewrite-debuginfo-0.1-1.el9.x86_64.rpm
|
|||
|
|
tmpbuild/nginx-mod-rewrite-debugsource-0.1-1.el9.x86_64.rpm
|
|||
|
|
```
|
|||
|
|
или
|
|||
|
|
```
|
|||
|
|
$ ls -1 tmpbuild/nginx-mod-rewrite*
|
|||
|
|
tmpbuild/nginx-mod-rewrite_0.1-1_amd64.buildinfo
|
|||
|
|
tmpbuild/nginx-mod-rewrite_0.1-1_amd64.changes
|
|||
|
|
tmpbuild/nginx-mod-rewrite_0.1-1_amd64.deb
|
|||
|
|
tmpbuild/nginx-mod-rewrite_0.1-1.dsc
|
|||
|
|
tmpbuild/nginx-mod-rewrite_0.1-1.tar.gz
|
|||
|
|
tmpbuild/nginx-mod-rewrite-0.1.tar.gz
|
|||
|
|
tmpbuild/nginx-mod-rewrite-dbgsym_0.1-1_amd64.deb
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Для того чтобы команда
|
|||
|
|
```bash
|
|||
|
|
bash -x package_preparer.sh prepare "os-image"
|
|||
|
|
```
|
|||
|
|
работала корректно, в системе должны быть установлены и доступны следующие утилиты (каждая из которых берётся из пакета, поставляемого в вашем дистрибутиве Linux):
|
|||
|
|
|
|||
|
|
| Утилита | Что делает в `prepare`‑разделе | Пакет (Debian/Ubuntu) |
|
|||
|
|
|---------|--------------------------------|------------------------|
|
|||
|
|
| **`bash`** | Запуск самого скрипта | уже установлен |
|
|||
|
|
| **`rm`, `mkdir`, `cp`, `find`, `head`, `gzip`, `tee`** | Очистка/создание каталогов, копирование файлов, поиск, сжатие, логирование | `coreutils` |
|
|||
|
|
| **`sed`** (GNU sed) | Параметризация шаблонов, удаление/замена строк | `sed` (GNU sed, пакет `sed` из coreutils) |
|
|||
|
|
| **`awk`** | Извлечение версии из `CHANGELOG`, генерация changelog‑файла | `gawk` (или `awk`‑пакет) |
|
|||
|
|
| **`tar`** | Создание tar‑архива, добавление файлов | `tar` |
|
|||
|
|
| **`docker`** (команды `docker build`, `docker run`, `docker rmi`) | Построение временного образа, запуск контейнера, очистка | `docker.io` / `docker-ce` + работающий **daemon** |
|
|||
|
|
|
|||
|
|
> **Замечание по `sed`**
|
|||
|
|
> В скрипте используются расширенные регулярные выражения (`sed -E`) и модификация файла на месте (`sed -i`). Это GNU‑вариант `sed`. На системах, где `sed` – BSD‑вариант (например, macOS), команда `sed -E -i` не будет работать, поэтому в таких окружениях нужно установить GNU‑`sed` (`gsed`) и заменить вызовы на `gsed`.
|
|||
|
|
|
|||
|
|
Docker‑демон должен быть запущен, и пользователь должен иметь права на его использование (или быть в группе `docker`).
|
|||
|
|
|
|||
|
|
Основная сборка происходит в docker‑контейнере, поэтому основная система не засоряется лишними пакетами. Основной набор утилит, используемых скриптом, присутствует в дистрибутиве по умолчанию, поэтому необходимо только установить docker.
|
|||
|
|
|
|||
|
|
Сборщик анализирует версию nginx, установленную в дистрибутиве, и производит сборку в окружении исходных файлов аналогичной версии nginx дистрибутива, а также командами, аналогичными, которые использовались при сборке nginx из дистрибутива.
|
|||
|
|
|
|||
|
|
## Ручная сборка из исходников
|
|||
|
|
|
|||
|
|
Если же необходимо собрать модуль самостоятельно, необходимо выполнить следующие команды.
|
|||
|
|
|
|||
|
|
Привожу пример для Almalinux 9.
|
|||
|
|
|
|||
|
|
Установите необходимые пакеты для сборки:
|
|||
|
|
```
|
|||
|
|
dnf -y install openssl-devel pcre-devel zlib-devel gcc gcc-c++ make wget
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
В корне проекта:
|
|||
|
|
```
|
|||
|
|
bash package_preparer.sh download 1.22.1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
В качестве версии можно задать любую доступную на сайте `https://nginx.org/ru/download.html`, она будет скачана и распакована в текущий каталог.
|
|||
|
|
|
|||
|
|
Далее перейти в папку nginx-1.22.1:
|
|||
|
|
```
|
|||
|
|
cd nginx-1.22.1
|
|||
|
|
```
|
|||
|
|
и задать конфигурацию сборки. Я привожу пример конфигурации, она может отличаться; данный пример — это типичная конфигурация:
|
|||
|
|
```
|
|||
|
|
./configure \
|
|||
|
|
--with-compat \
|
|||
|
|
--add-dynamic-module=../modules/mod_rewrite \
|
|||
|
|
--prefix=/etc/nginx \
|
|||
|
|
--sbin-path=/usr/sbin/nginx \
|
|||
|
|
--modules-path=/etc/nginx/modules \
|
|||
|
|
--conf-path=/etc/nginx/nginx.conf \
|
|||
|
|
--error-log-path=/var/log/nginx/error.log \
|
|||
|
|
--http-log-path=/var/log/nginx/access.log \
|
|||
|
|
--pid-path=/var/run/nginx.pid \
|
|||
|
|
--lock-path=/var/run/nginx.lock \
|
|||
|
|
--http-client-body-temp-path=/var/lib/nginx/body \
|
|||
|
|
--http-proxy-temp-path=/var/lib/nginx/proxy \
|
|||
|
|
--http-fastcgi-temp-path=/var/lib/nginx/fastcgi \
|
|||
|
|
--http-uwsgi-temp-path=/var/lib/nginx/uwsgi \
|
|||
|
|
--http-scgi-temp-path=/var/lib/nginx/scgi \
|
|||
|
|
--with-http_ssl_module \
|
|||
|
|
--with-http_v2_module \
|
|||
|
|
--with-http_realip_module \
|
|||
|
|
--with-http_gzip_static_module \
|
|||
|
|
--with-http_stub_status_module \
|
|||
|
|
--with-http_slice_module \
|
|||
|
|
--with-http_dav_module \
|
|||
|
|
--with-http_auth_request_module \
|
|||
|
|
--with-http_secure_link_module \
|
|||
|
|
--with-stream \
|
|||
|
|
--with-stream_ssl_module \
|
|||
|
|
--with-stream_realip_module \
|
|||
|
|
--with-stream_ssl_preread_module \
|
|||
|
|
--with-pcre-jit
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Во время выполнения команды должно появиться:
|
|||
|
|
```
|
|||
|
|
adding module in ../modules/mod_rewrite
|
|||
|
|
+ ngx_http_apache_rewrite_module was configured
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Можно добавить `--add-dynamic-module=../modules/mod_rewrite` в свою конфигурацию nginx.
|
|||
|
|
|
|||
|
|
Далее:
|
|||
|
|
```
|
|||
|
|
make modules
|
|||
|
|
```
|
|||
|
|
данная команда соберет модуль:
|
|||
|
|
```
|
|||
|
|
# ls -1 objs/ngx_http_apache_rewrite_module.so
|
|||
|
|
objs/ngx_http_apache_rewrite_module.so
|
|||
|
|
```
|
|||
|
|
Далее его можно переложить в каталог модулей nginx:
|
|||
|
|
```
|
|||
|
|
cp objs/ngx_http_apache_rewrite_module.so /etc/nginx/modules/
|
|||
|
|
```
|
|||
|
|
и подключить модуль в файле конфигурации nginx:
|
|||
|
|
```
|
|||
|
|
cat /etc/nginx/nginx.conf
|
|||
|
|
|
|||
|
|
load_module modules/ngx_http_apache_rewrite_module.so;
|
|||
|
|
|
|||
|
|
...
|
|||
|
|
|
|||
|
|
server {
|
|||
|
|
...
|
|||
|
|
HtaccessEnable on;
|
|||
|
|
|
|||
|
|
RewriteEngine On;
|
|||
|
|
|
|||
|
|
location / {
|
|||
|
|
RewriteEngine On;
|
|||
|
|
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
}
|