Модель процессов
Rapira запускает один мастер-процесс и отдельный пул воркеров для каждого включённого протокола. Мастер владеет слушающими сокетами, инициализированным движком PHP и pid-файлом. Затем мастер создаёт процессы воркеров. Каждый воркер наследует PHP и принимает соединения с общего сокета своего пула. Rapira не передаёт запросы между процессами.
HTTP и gRPC имеют отдельные слушатели, входные скрипты и пулы. [http.pool] и [grpc.pool] настраивают их независимо. Пул gRPC использует режим Dispatcher и обрабатывает один активный вызов на воркер.
Если в конфигурации есть таблица [observability], мастер также запускает один процесс для метрик и проверок состояния. Этот процесс не выполняет код PHP. В Linux имя этого процесса rapira-obs, а воркеры PHP имеют имя rapira-worker. Мастер контролирует и останавливает этот процесс вместе с воркерами PHP. Перезагрузка его не меняет, потому что у него нет приложения для перезапуска. Подробнее - в разделе Метрики и проверки состояния.
Эта модель процессов одинакова в режимах Classic, Worker и Dispatcher. http.pool.mode управляет обработкой запросов внутри воркера. Эта настройка не меняет создание пула, контроль воркеров и перезагрузку. Подробнее - в разделе Режимы выполнения.
Мастер и воркеры
Инициализация идёт в таком порядке:
- Занять слушающий сокет или сокеты. Конфликт портов останавливает инициализацию до запуска PHP.
- Один раз запустить PHP. Мастер выполняет
MINITв своём единственном потоке. В этот момент OPcache создаёт свою разделяемую память, и каждый воркер наследует её. Когда один воркер компилирует файл, другие воркеры используют результат из кеша. - Создать воркеры через fork. Каждый дочерний процесс наследует занятый сокет и инициализированный движок.
Схема показывает один пул. Каждый воркер выполняет один интерпретатор PHP в сборке NTS и асинхронный сервер HTTP или gRPC. Сервер использует hyper на отдельном рантайме tokio из двух потоков. Каждый воркер вызывает accept() на унаследованном сокете. Операционная система назначает каждое новое соединение одному воркеру.
Мастер не обслуживает запросы. Его единственный поток ждёт сигналы, завершения воркеров и таймеры.
Мастер держит модуль PHP всё время своей работы. Только мастер выключает модуль. Воркер завершается, но не выключает это общее состояние движка.
Контроль воркеров
Мастер выполняет обслуживание раз в секунду. Он также обрабатывает каждое завершение воркера сразу, когда оно происходит.
- Замена воркера. После штатного завершения мастер сразу заменяет воркер. После сбоя или завершения в нерабочем состоянии задержка замены начинается со 100 мс. Задержка удваивается после каждого последовательного сбоя и останавливается на 25,6 секунды. Воркер, который работает не меньше 10 секунд, сбрасывает задержку.
- Сбои запуска. В режимах Worker и Dispatcher запуск завершается сбоем, если входной скрипт заканчивается до получения запроса. Тогда воркер ждёт до 5 секунд и снова выполняет входной скрипт. На запрос, который приходит во время ожидания, воркер отвечает HTTP
503или gRPCUNAVAILABLE. После пяти сбоев запуска подряд воркер завершается в нерабочем состоянии. - Остановка мастера при сбое запуска. Мастер останавливается с кодом завершения 70, когда завершается нерабочий воркер. Это правило действует, только если в пуле нет успешного запроса и нет простаивающего или активного воркера. Во всех других случаях мастер заменяет воркер после задержки замены. Сбой воркера никогда не останавливает мастер.
- Ограничение запросов. В режимах Worker и Dispatcher
http.pool.max_requestsограничивает число запросов одного экземпляра приложения. После случайного числа запросов отmax_requests + 1до примерно1.5 × max_requestsворкер перезапускает приложение. Процесс воркера, его соединения и его очередь остаются. Следующий запрос ждёт запуска приложения. Случайный диапазон предотвращает одновременные перезапуски. Режим Classic игнорирует эту настройку, потому что каждый запрос выполняется в новом запросе PHP. - Тайм-аут запроса. С
http.pool.request_terminate_timeout_secsмастер отправляет воркеруSIGTERM, когда его текущий запрос превышает лимит. Если воркер всё ещё активен при следующем обслуживании, мастер отправляетSIGKILL. Затем мастер сразу заменяет воркер. Мастер не применяет этот тайм-аут во время остановки. - Предел памяти. Пока мастер не останавливается, он проверяет RSS каждого воркера раз в секунду и отправляет
SIGQUITодин раз при превышенииhttp.pool.max_memory_mb. Воркер прекращает принимать новые соединения; существующие соединения могут получить ответ на следующий запрос в пределах тайм-аута завершения. Ответы, которые превышают этот тайм-аут, могут оборваться. Мастер запускает замену после выхода воркера, который освобождает память внутри и вне PHP. RSS может оставаться высоким после перезапуска приложения, потому что PHP сохраняет часть освобождённой памяти для повторного использования. - Контроль мастера. Каждый воркер читает из канала, который мастер держит открытым. Если мастер завершается, каждый воркер прекращает принимать новую работу, завершает текущие запросы и завершается.
Размер пула
Следующие настройки используют [http.pool]. Те же настройки применяются к [grpc.pool].
http.pool.processes задаёт число воркеров. Мастер создаёт эти воркеры при инициализации и заменяет каждый завершившийся воркер. По умолчанию Rapira создаёт один воркер на каждый процессор, который доступен процессу. Если у контейнера есть ограничение по процессорам, значение по умолчанию следует этому ограничению.
Общее число воркеров всех пулов должно быть не больше 4096. Если observability включено, его процесс считается одним воркером. Большее общее число останавливает Rapira с кодом завершения 70.
PHP работает синхронно, поэтому каждый воркер обрабатывает один запрос за раз. Приложения с большим числом операций ввода-вывода могут требовать больше воркеров, чем ядер процессора. Приложения с высокой нагрузкой на процессор обычно не требуют.
Число воркеров не меняется во время работы сервера. Чтобы менять ёмкость под нагрузку, меняйте число экземпляров Rapira, например с помощью оркестратора контейнеров.
Полный справочник по ключам - на странице Конфигурация.
Сигналы
Сигналы останавливают работающий сервер, перезагружают его и заставляют его сообщить своё состояние. Все сигналы отправляются мастеру.
| Сигнал | Что делает мастер |
|---|---|
SIGTERM, SIGINT | Мастер даёт текущим запросам завершиться, затем останавливает воркеры. Второй сигнал останавливает воркеры принудительно. |
SIGQUIT | Мастер выполняет ту же контролируемую остановку. Ещё один SIGQUIT ничего не меняет. |
SIGUSR2, SIGHUP | Мастер сообщает каждому воркеру, что нужно перезапустить приложение. Ни один процесс воркера не заменяется. |
SIGUSR1 | Мастер записывает состояние пула в лог. |
Задайте supervisor.pidfile, чтобы у скриптов было постоянное место для идентификатора процесса мастера:
kill -USR2 $(cat /run/rapira.pid) # Перезапустить приложение в каждом воркере.
kill -USR1 $(cat /run/rapira.pid) # Записать состояние пула в лог.
kill -TERM $(cat /run/rapira.pid) # Остановить после завершения текущих запросов.Отправляйте сигналы только мастеру. Воркеры игнорируют SIGUSR1. SIGUSR2 заставляет воркер перезапустить приложение. SIGTERM и SIGHUP сразу останавливают воркер и прерывают его текущие запросы. Тайм-аут запроса использует SIGTERM. Прямой сигнал воркеру обходит контроль мастера.
Ctrl-C в терминале отправляет SIGINT мастеру и всем воркерам. Затем каждый воркер также получает SIGQUIT от мастера. Второй сигнал остановки заставляет воркер сразу завершиться с кодом 131, поэтому его текущие запросы не завершаются. Чтобы текущие запросы завершились, отправьте SIGTERM только мастеру.
Остановка
После сигнала остановки мастер сразу отправляет SIGQUIT каждому воркеру. Воркеры не принимают новые соединения и завершают текущие запросы. Каждый воркер сохраняет свои соединения. Он отвечает на следующий запрос в каждом соединении с Connection: close, и затем соединение закрывается. После supervisor.process_control_timeout_secs мастер отправляет оставшимся воркерам SIGTERM. Значение по умолчанию - 30 секунд. Если воркеры остаются, мастер отправляет SIGKILL через одну секунду после SIGTERM.
Срок завершения соединений равен тайм-ауту управления минус меньшее из двух значений: пять секунд или половина тайм-аута. При настройках по умолчанию соединения получают 25 секунд на завершение. Ответы, которые превышают этот срок, могут быть прерваны. Соединение, которое простаивает весь срок, закрывается в конце срока.
Второй SIGTERM или SIGINT пропускает ожидание и сразу принудительно завершает сервер. Коды завершения мастера описаны в разделе Коды завершения.
Перезагрузка перезапускает приложения
SIGUSR2 или SIGHUP перезапускает приложение в каждом воркере каждого пула. Воркер завершает запрос PHP приложения и снова запускает входной скрипт в том же процессе. Перед запуском скрипта воркер разрешает символические ссылки в пути входного скрипта и делает каталог скрипта рабочим каталогом. Слушающий сокет, соединения и запросы в очереди остаются. Старое приложение обслуживает запросы, которые ждут в очереди до сигнала. Последующие запросы получает новое приложение.
В режиме Classic каждый запрос выполняет входной скрипт в новом запросе PHP. Поэтому изменённый файл работает без перезагрузки, кроме случая opcache.validate_timestamps = 0. Развёртывание, которое переключает символическую ссылку в пути входного скрипта, требует перезагрузки во всех режимах, включая режим Classic. Режимы Worker и Dispatcher держат приложение в памяти. Перезагружайте пул после каждого развёртывания в этих режимах. Подробнее - в разделе Запуск в продакшене.
Перезагрузка очищает OPcache, поэтому приложения загружают новый код и при opcache.validate_timestamps = 0. Значение manual_restarts в opcache_get_status() считает эти перезагрузки. После перезагрузки первые запросы снова компилируют свои файлы PHP. Запросы выполняются без OPcache, пока не завершится самый долгий запрос, который был активен в момент перезагрузки. В режиме Classic запрос, который начинается после того, как его воркер получил команду перезагрузки, выполняет новый код, а активные запросы завершаются со старым кодом.
Каждый воркер перезапускает приложение самостоятельно. В режимах Worker и Dispatcher с OPcache большинство воркеров запускает приложение два раза во время перезагрузки. Поэтому код перед циклом воркера выполняется два раза. Если все воркеры перезапускаются одновременно, каждая очередь ждёт только запусков приложения своего воркера. Клиент не замечает перезапуск, кроме этого ожидания.
Мастер игнорирует сигнал перезагрузки во время остановки. Мастер не записывает проигнорированный сигнал в лог.
Перезагрузка перезапускает приложения, но не процессы. Воркеры сохраняют тот же инициализированный движок. Перезапустите Rapira, чтобы применить изменения бинарного файла или файлов, которые читает мастер, например rapira.toml и php.ini. Также перезапустите Rapira после изменения файла, который загружает opcache.preload.
OPcache планирует перезапуск, когда код приложения вызывает opcache_reset() или когда кеш заполнен. Тогда Rapira перезагружает каждый пул и записывает в лог одно предупреждение. Ни один процесс воркера не останавливается, и ни одно соединение не закрывается. В Rapira значение opcache.force_restart_timeout по умолчанию равно 0, и значение в php.ini заменяет его. При значении больше 0 OPcache может принудительно завершить воркер, запрос которого во время перезапуска OPcache, в том числе при перезагрузке, длится дольше этого времени. Оставьте значение 0.
Запись состояния в лог
SIGUSR1 заставляет мастер записать в лог состояние каждого пула. Первая строка пула показывает число работающих и простаивающих воркеров. Затем строка для каждого слота воркера показывает идентификатор процесса, состояние и три счётчика:
status: http pool: 4 running, 3 idle
slot 0 pid 4242 state 2 handled 1500 errors 2 recycles 0| Состояние | Значение |
|---|---|
1 | Запуск. Приложение ещё не запустилось, или его последний запуск завершился сбоем. |
2 | Простой. Воркер ждёт работу. |
3 | Активен. Воркер обрабатывает запрос. |
4 | Завершение. Воркер завершает свою работу и выходит. |
Слот сохраняет свои счётчики, когда мастер заменяет его воркер. recycles считает перезапуски приложения внутри воркера, например после max_requests или перезагрузки.
Вывод состояния использует уровень info в цели master. Уровень логирования по умолчанию - error. Задайте для этой цели info, чтобы показать вывод:
[log.targets]
master = "info"Та же цель содержит ошибки создания воркеров и предупреждения о тайм-ауте запроса. Подробнее - в разделе Логирование.
Использует ли Rapira прозрачные огромные страницы (transparent huge pages)?
Нет. В Linux мастер отключает transparent huge pages для своего процесса до запуска PHP. Воркеры и процессы, которые PHP запускает через proc_open() или exec(), наследуют эту настройку. Поэтому USE_ZEND_ALLOC_HUGE_PAGES=1 и opcache.huge_code_pages не получают transparent huge pages. Эти опции всё ещё могут использовать явные огромные страницы, которые хост резервирует через vm.nr_hugepages. Никакая настройка не меняет это поведение.
Может ли мастер работать как PID 1 в контейнере?
Да. Как PID 1, мастер обрабатывает сигналы остановки и убирает все завершившиеся дочерние процессы. Отдельный процесс init не нужен.