Wdrożenie produkcyjne
Wdrożenie produkcyjne musi utrzymać dostępność Rapiry po ponownym uruchomieniu i po zmianach kodu. Uruchamia Rapirę podczas inicjalizacji systemu i uruchamia ją ponownie po awarii. Przeładowuje też kod bez utraty żądań i zachowuje logi. Ta strona opisuje jednostkę systemd, reverse proxy, kontrole stanu, metryki i trwałe ustawienia workerów.
Rapira nie definiuje układu wdrożenia. Nie wymaga określonej ścieżki konfiguracji ani supervisora procesów. Ta strona definiuje konwencję używaną przez pozostałą dokumentację. Najpierw zainstaluj plik binarny zgodnie z Instalacją.
Rapira jest też dostępna jako obraz ghcr.io/rapira-rs/rapira. Skopiuj jego pliki do obrazu aplikacji przez COPY --from. Kontener używa polityki restartów środowiska uruchomieniowego zamiast systemd. Pozostałe ustawienia nie zmieniają się. Więcej informacji zawiera sekcja Docker.
Jednostka systemd
Rapira może zastąpić php-fpm. Proces nadrzędny tworzy, monitoruje i zastępuje workery. Każda pula uruchamia stałą liczbę workerów, którą ustawia processes. Systemd musi monitorować tylko proces nadrzędny. Oddzielny menedżer procesów nie jest potrzebny.
Pakiety .deb i .rpm instalują plik wykonywalny i osadzone PHP. Nie instalują jednostki usługi ani php.ini. Te pliki zawierają ustawienia określonej witryny. Aktualizacje pakietów nie mogą ich zastępować. Listę zainstalowanych plików zawiera Instalacja.
Utwórz /etc/systemd/system/rapira.service:
[Unit]
Description=Rapira PHP application server
After=network.target
[Service]
Type=exec
WorkingDirectory=/srv/app
ExecStart=/usr/bin/rapira serve /etc/rapira/rapira.toml
ExecReload=/bin/kill -USR2 $MAINPID
KillMode=mixed
Restart=on-failure
RuntimeDirectory=rapira
Environment=PHPRC=/etc/rapira
[Install]
WantedBy=multi-user.targetPrzeładuj konfigurację systemd:
sudo systemctl daemon-reloadWłącz Rapirę z opcją --now:
sudo systemctl enable --now rapiraJednostka używa następujących ustawień:
Type=exec: Rapira działa na pierwszym planie. Proces uruchomiony przez systemd jest procesem nadrzędnym, więc$MAINPIDgo identyfikuje.ExecReload: poleceniesystemctl reload rapirawysyłaSIGUSR2do procesu nadrzędnego. Ten sygnał rozpoczyna opisane niżej przeładowanie.KillMode=mixed: systemd wysyła sygnał zatrzymania tylko do procesu nadrzędnego. Następnie proces nadrzędny wysyłaSIGQUITdo workerów i czeka na nie. PoTimeoutStopSecsystemd wysyłaSIGKILLdo całej grupy. BezKillMode=mixedzatrzymanie może zakończyć bieżące żądania.Restart=on-failure: systemd uruchamia Rapirę ponownie po awarii. Nie uruchamia jej ponownie po normalnym zatrzymaniu.RuntimeDirectory=rapira: systemd tworzy/run/rapirapodczas uruchamiania i usuwa go podczas zatrzymywania. Poniższe przykłady umieszczają pidfile i gniazdo uniksowe w tym katalogu.Environment=PHPRC: PHP używa tego katalogu do znalezieniaphp.ini.
Uruchamianie na koncie innym niż root
Dodaj User= i Group= do bloku [Service]. Systemd przekaże temu kontu własność RuntimeDirectory. Konto może wtedy utworzyć pidfile i gniazdo uniksowe w /run/rapira/. Zwykle nie może tworzyć plików bezpośrednio w /run.
Dwie aplikacje na jednym hoście wymagają osobnych plików konfiguracyjnych, jednostek i adresów nasłuchu. Może je definiować szablon jednostki systemd, na przykład rapira@.service. Każda instancja inicjalizuje PHP i tworzy osobną pulę workerów.
Ścieżki konfiguracji
Ten przewodnik używa /etc/rapira/rapira.toml dla ustawień Rapiry. Przechowuje php.ini w tym samym katalogu i ustawia PHPRC=/etc/rapira. Rapira nie zawiera tych ścieżek w pliku binarnym. Argument CONFIG przyjmuje dowolną ścieżkę. PHP używa PHPRC do wyszukiwania konfiguracji. Użyj innych ścieżek, jeśli wymaga ich system.
Rapira może działać bez php.ini. Ustawienia domyślne zapisują diagnostykę PHP w logu, a nie w odpowiedziach HTTP. Utwórz /etc/rapira/php.ini, aby skonfigurować OPcache, limit pamięci lub strefę czasową. Więcej informacji zawierają Logi.
W PHP 8.4 OPcache jest osobnym plikiem opcache.so. Załaduj go wierszem zend_extension w php.ini, jak opisuje sekcja php.ini. PHP 8.5 zawiera OPcache w libphp.
Względny http.pool.entrypoint używa katalogu pliku konfiguracyjnego jako podstawy. Dlatego entrypoint = "index.php" w tym układzie oznacza /etc/rapira/index.php. W środowisku produkcyjnym użyj bezwzględnej ścieżki skryptu wejściowego. supervisor.pidfile używa tej samej reguły.
Za każdym razem, gdy worker uruchamia aplikację lub uruchamia ją ponownie, rozwiązuje dowiązania symboliczne w ścieżce skryptu wejściowego i przechodzi do katalogu skryptu wejściowego. Operacje PHP na plikach ze ścieżkami względnymi używają tego katalogu. PHP nie szuka php.ini w katalogu roboczym, dlatego ustaw PHPRC. Ustawienie WorkingDirectory= dotyczy tylko procesu nadrzędnego. Proces nadrzędny używa go jako podstawy dla względnej ścieżki CONFIG i względnej ścieżki nasłuchu unix:. Wszystkie klucze i wartości domyślne zawiera Konfiguracja.
Reverse proxy
Rapira przyjmuje nieszyfrowany HTTP i nie udostępnia ustawień TLS. Proxy kończące TLS przyjmuje HTTPS od klienta, odszyfrowuje połączenie i wysyła nieszyfrowany HTTP do Rapiry. Użyj do tego celu nginx, Caddy, HAProxy lub modułu równoważenia obciążenia w chmurze. Połącz proxy z Rapirą przez interfejs pętli zwrotnej lub gniazdo uniksowe. Publiczny adres Rapiry również używa nieszyfrowanego HTTP.
[http]
listen = "127.0.0.1:8000"
# listen = "unix:/run/rapira/rapira.sock"Rapira tworzy gniazdo uniksowe z trybem 0666. Każdy proces z dostępem do katalogu środowiska uruchomieniowego może połączyć się z gniazdem. Rapira nie konfiguruje trybu gniazda. Ogranicz dostęp za pomocą uprawnień katalogu. Dla tej jednostki ustaw RuntimeDirectoryMode=0750. W Group= podaj grupę, która zawiera konto proxy.
Przekazuj pola z łącznikami, na przykład X-Forwarded-For. Nie używaj nazw takich jak X_Forwarded_For. W trybach Classic i Worker nazwa z _ lub . może odpowiadać temu samemu kluczowi $_SERVER co nazwa z łącznikami. W tych trybach Rapira zawsze usuwa każdą nazwę ze znakiem innym niż litera ASCII, cyfra lub łącznik. Strona HTTP opisuje mapowanie.
Rapira może obsługiwać zasoby statyczne za pomocą middleware plików statycznych. Proxy nie potrzebuje drugiej kopii katalogu głównego dokumentów. Zamiast tego zasoby może obsługiwać proxy lub CDN.
Wdrożenia bez przestoju
Wdróż nowy kod. Następnie przeładuj Rapirę:
sudo systemctl reload rapiraPolecenie wysyła SIGUSR2 do procesu nadrzędnego. Proces nadrzędny przekazuje każdemu workerowi, że ma uruchomić aplikację ponownie. Każdy worker ponownie uruchamia skrypt wejściowy w tym samym procesie, a nowa aplikacja obsługuje kolejne żądania. Żadne połączenie się nie zamyka i żadne żądanie nie ginie. Więcej informacji zawiera Model procesów.
Wyślij sygnał bezpośrednio, gdy systemd nie zarządza procesem. Ustaw supervisor.pidfile, aby zapisać identyfikator procesu nadrzędnego. Utwórz katalog pidfile przed uruchomieniem Rapiry. Możesz też wybrać istniejący katalog. Proces nadrzędny nie uruchomi się, jeśli nie może zapisać pliku.
[supervisor]
pidfile = "/run/rapira/rapira.pid"
process_control_timeout_secs = 30kill -USR2 "$(cat /run/rapira/rapira.pid)"Tylko proces nadrzędny zapisuje pidfile. Usuwa go podczas kontrolowanego zakończenia. Pozostały plik może wskazywać na SIGKILL, awarię procesu lub awarię systemu.
process_control_timeout_secs ogranicza oczekiwanie podczas zatrzymywania. Po tym oczekiwaniu proces nadrzędny wysyła SIGTERM. Sekundę później wysyła SIGKILL. Ustaw TimeoutStopSec systemd powyżej tego pełnego czasu.
Połączenia mają krótszy czas na zakończenie: limit sterowania pomniejszony o mniejszą z wartości: pięć sekund lub połowę limitu. Domyślnie jest to 25 sekund. Odpowiedzi, które przekroczą ten czas, mogą zostać przerwane podczas zatrzymywania.
Wdrożenie może umieścić każdą wersję aplikacji w osobnym katalogu i przełączyć dowiązanie symboliczne w ścieżce skryptu wejściowego na nowy katalog. Przeładowanie po przełączeniu przenosi każdego workera każdej puli do nowej wersji: kod, katalog roboczy i domyślny katalog główny sendfile. Przeładuj Rapirę natychmiast po przełączeniu. Przed przeładowaniem aplikacja, która uruchamia się z innego powodu, na przykład po max_requests, uruchamia się w nowej wersji. Dlatego pula działa w dwóch wersjach aż do przeładowania.
Przeładowanie opróżnia OPcache, więc wczytuje nowy kod PHP także przy opcache.validate_timestamps = 0. Dopóki nie zakończy się najdłuższe żądanie, które było aktywne w chwili przeładowania, żądania działają bez OPcache i ponownie kompilują swoje pliki. W trybach Worker i Dispatcher większość workerów uruchamia aplikację dwa razy, więc kod przed pętlą workera działa dwa razy.
Czego przeładowanie nie zmienia
Przeładowanie uruchamia ponownie aplikacje, ale nie procesy. Proces nadrzędny zachowuje plik binarny Rapiry oraz ustawienia z rapira.toml i php.ini. Zachowuje też zbiór deskryptorów gRPC i plik tokenów [grpc.auth]. Uruchom Rapirę ponownie po zmianie jednego z tych plików. Uruchom ją ponownie także po zmianie pliku, który wczytuje opcache.preload. PHP wczytuje te pliki jeden raz, przy starcie procesu nadrzędnego.
Gdy ustawiono opcache.restrict_api, przeładowanie nie opróżnia OPcache. Przy tym ustawieniu i opcache.validate_timestamps = 0 uruchom Rapirę ponownie po każdym wdrożeniu. Przy tym ustawieniu aplikacja, która uruchamia się, gdy ponowne uruchomienie OPcache czeka na wykonanie, działa bez OPcache do swojego następnego startu.
Logi
Rapira zapisuje przefiltrowane wpisy do logu na stderr. Systemd przekazuje stderr do dziennika. Na produkcji używaj JSON-a dla stderr:
[log]
level = "info"
format = "json"Każda linia zawiera jeden obiekt z polami timestamp, level, target i fields. Obiekt fields zawiera message oraz pozostałe pola zdarzenia. Znacznik czasu używa UTC zgodnie z RFC 3339. Rapira zapisuje znaki nowego wiersza w komunikatach w formie ucieczki. Journald przekazuje obiekt do kolektorów logów bez zmian.
journalctl -u rapira -fSkonfiguruj kolektor logów do odczytu dziennika jednostki. Możesz też przekazać stderr Rapiry bezpośrednio do kolektora. Kolektor może analizować każdy wpis jako JSON bez wyrażeń regularnych. Logi opisują poziomy dla celów i zastąpienie filtra przez RUST_LOG.
Kontrole stanu i metryki
Dodaj tabelę [observability], aby udostępnić sondy stanu i metryki Prometheus. Rapira uruchamia wtedy jeden dodatkowy proces, który nie uruchamia PHP. GET /livez pokazuje, że proces nadrzędny działa. GET /readyz pokazuje, że każda pula PHP ma bezczynnego lub aktywnego workera. GET /metrics zwraca metryki w formacie tekstowym Prometheus.
[observability]
listen = "127.0.0.1:9180"
[observability.metrics]
[observability.probes]Punkty końcowe nie mają uwierzytelniania ani TLS. Użyj adresu pętli zwrotnej lub gniazda uniksowego. Kody statusu, przykłady sond i opis metryk zawiera strona Metryki i kontrole stanu.
Wymiana workerów i limity czasu żądania
W trybach Worker i Dispatcher worker zachowuje stan aplikacji między żądaniami. Dlatego wyciek pamięci może stopniowo zwiększać pamięć workera. Użyj tych ustawień, aby ograniczyć ten efekt:
[http.pool]
max_requests = 500
max_memory_mb = 256
request_terminate_timeout_secs = 30Tabela [grpc.pool] przyjmuje te same klucze.
max_requests uruchamia ponownie aplikację wewnątrz workera po określonej liczbie żądań. Proces workera pozostaje, więc żadne połączenie się nie zamyka i żadne żądanie nie ginie. Dla każdego workera Rapira zwiększa limit o losową liczbę żądań nie większą niż połowa limitu, aby aplikacje nie uruchamiały się ponownie jednocześnie. Ponowne uruchomienie zwalnia pamięć PHP aplikacji. Nie zwalnia pamięci, którą rozszerzenie lub biblioteka C traci poza PHP. To ustawienie ogranicza wpływ wycieku pamięci, ale go nie naprawia. Tryb Classic je ignoruje.
max_memory_mb zastępuje proces workera, gdy jego pamięć rezydentna (RSS) przekroczy limit w MiB. Proces nadrzędny sprawdza każdego workera raz na sekundę. Worker przestaje przyjmować nowe połączenia; istniejące połączenia mogą otrzymać odpowiedź na następne żądanie w czasie przeznaczonym na zakończenie obsługi. Odpowiedzi, które przekroczą ten czas, mogą zostać przerwane. Zakończenie workera zwalnia pamięć wewnątrz i poza PHP, po czym proces nadrzędny uruchamia zastępcę. To ustawienie działa we wszystkich trybach.
Używaj max_memory_mb, gdy kontener ma limit pamięci. Gdy kontener osiągnie limit, jądro może zakończyć proces, a wszystkie żądania tego procesu kończą się błędem. Utrzymuj sumę processes × max_memory_mb wszystkich pul poniżej limitu kontenera. Zostaw zapas dla procesu nadrzędnego, dla procesu obserwowalności i dla wzrostu pamięci między dwoma sprawdzeniami. RSS każdego workera obejmuje pamięć współdzieloną, na przykład OPcache, więc ta suma jest większa niż rzeczywiste użycie.
Ustaw limit powyżej RSS nowego workera. W przeciwnym razie każdy nowy worker może ponownie rozpocząć kończenie obsługi z powodu limitu pamięci przy następnym sprawdzeniu. Metryka rapira_worker_rss_bytes pokazuje RSS każdego workera.
request_terminate_timeout_secs ogranicza czas jednego żądania. Rapira kończy i zastępuje workera, który przekroczy limit. Domyślna wartość tych ustawień to zero, które je wyłącza. Włącz je w środowisku produkcyjnym.
Model procesów opisuje rozmiar puli, opóźnienia wymiany oraz obsługę awarii workerów.