Rola Redisa w stosie
Redis to magazyn danych trzymanych w pamięci operacyjnej, używany najczęściej jako cache i broker kolejek. W Endora Commerce nie jest opcjonalnym dodatkiem: obok PostgreSQL i Meilisearch należy do trzech usług, których dostępność sprawdza endpoint zdrowia platformy. Jeśli któraś nie odpowiada, endpoint zwraca 503.
Podział odpowiedzialności jest prosty. Katalog, zamówienia, ceny i sesje mają swój rekord źródłowy w PostgreSQL. Redis trzyma to, co da się odtworzyć albo co z natury jest krótkotrwałe.
Co platforma w nim trzyma
- Kolejki zadań oparte na BullMQ - o nich niżej.
- Cache odczytów: ustawienia, kanały sprzedaży, strony CMS, blog, megamenu, słowniki i przeliczenia koszyka.
- Sesje: wiersz sesji jest zapisany w PostgreSQL, a Redis służy jako warstwa szybkiego odczytu, żeby nie pytać bazy przy każdym żądaniu.
- Krótkotrwały stan logowania: wyzwania drugiego składnika (MFA) i transakcje OAuth, z czasem życia ustawionym tak, żeby porzucone logowanie samo wygasło.
- Blokady: między innymi blokada serializująca instalację, włączanie i wyłączanie modułów oraz blokada przy przyjmowaniu zamówień przez API.
Administrator widzi z tego jedną rzecz bezpośrednio: stronę „Czyszczenie cache” w panelu, na której można wyczyścić wybrane obszary albo całość, żeby świeżo opublikowane treści i zmienione ustawienia pojawiły się od razu.
Kolejki: co idzie w tle
Zasada jest jedna: kod obsługujący żądanie tylko wrzuca zadanie do kolejki i odpowiada, a wykonuje je osobny konsument. Każde zadanie jest pobierane atomowo, więc dwa równoległe procesy robocze nie przetworzą go dwa razy.
| Kolejka | Co robi | Co widać w panelu |
|---|---|---|
| Dostarczanie webhooków | Podpisuje zdarzenie (HMAC-SHA-256) i wysyła je pod adres odbiorcy; do 8 prób z wykładniczo rosnącym odstępem | Lista dostarczeń przy webhookach; ostatecznie nieudane dostarczenie można ponowić ręcznie |
| E-maile transakcyjne | Wysyłka wiadomości wywołanych zdarzeniami w sklepie, takich jak potwierdzenie zamówienia czy powiadomienie o wysyłce | - |
| Operacje masowe katalogu | Edycja masowa powyżej 50 produktów oraz pełna reindeksacja Meilisearch po zmianie flagi wyszukiwalności atrybutu | Strona „Akcje masowe” ze statusem i licznikami; po zakończeniu powiadomienie w panelu i e-mail |
| Feedy produktowe | Generowanie i dostarczanie plików, m.in. dla Google Merchant Center | - |
| Newsletter | Planowanie kampanii i wysyłka po jednym zadaniu na odbiorcę, kroki automatyzacji | - |
| Zdarzenia analityczne z serwera | Dostarczanie zdarzeń po stronie serwera do Google Analytics 4 i GTM | - |
Tą samą drogą, czyli trwałą kolejką z ponawianiem, idzie wysyłka faktur do KSeF. Praktyczny skutek jest taki, że awaria KSeF albo wolny odbiorca webhooka po stronie integratora nie zatrzymuje przyjmowania zamówień: zadanie czeka w kolejce i ponawia próby z rosnącym opóźnieniem, aż się uda albo zajmie się nim człowiek.
Wymagania i konfiguracja
- Wersja Redis 7.x. Platforma łączy się przez jeden adres w zmiennej
REDIS_URL, więc może to być Redis z kontenera, z pakietów dystrybucji albo osobny serwer. - W referencyjnym pliku Compose dla produkcji Redis działa na tym samym VPS co reszta, w sieci prywatnej stosu, bez wystawionego portu.
- Ten sam plik uruchamia go z włączonym plikiem AOF (
appendonly yes), żeby zadania czekające w kolejce przetrwały restart. Według dokumentacji Redisa o trwałości danych przy domyślnym zapisie na dysk co sekundę w razie awarii można stracić około sekundy zapisów. - Jeśli ustawiasz limit pamięci (
maxmemory), zostaw politykęnoeviction. BullMQ wymaga jej do poprawnego działania, bo usunięcie przypadkowego klucza kolejki psuje jej stan. Polityki usuwania kluczy w rodzajuallkeys-lrusą sensowne dla samego cache, nie dla instancji, na której żyją kolejki.
Skalowanie procesów roboczych
Domyślnie konsumenci kolejek działają w tym samym procesie co API, co wystarcza na jednym VPS. Gdy edycje masowe, importy albo reindeksacja zaczynają konkurować z czasem odpowiedzi, rolę procesu rozdziela zmienna BACKEND_ROLE: api obsługuje tylko HTTP, worker tylko kolejki. Procesów roboczych można uruchomić kilka bez zmiany konfiguracji, pod warunkiem że wszystkie wskazują ten sam Redis i tę samą bazę.
Co się dzieje, gdy Redis zniknie
Utrata zawartości Redisa nie kasuje żadnego rekordu biznesowego. Cache odbuduje się przy kolejnych odczytach, a sesje zostaną odczytane z PostgreSQL. Ucierpieć mogą zadania, które akurat czekały w kolejce, i dlatego warto zostawić włączony AOF. Operacje masowe mają dodatkowe zabezpieczenie: ich stan jest zapisany w bazie, a proces roboczy przy starcie ponownie wrzuca do kolejki te, które zostały w stanie oczekiwania.
Przy diagnozie dwa objawy powtarzają się najczęściej. Operacja, która nie wychodzi ze stanu oczekiwania, zwykle oznacza brak działającego procesu roboczego albo inny REDIS_URL niż w API. Zadania, które się piętrzą przy bezczynnych konsumentach, to zazwyczaj wyłączony moduł: jego konsumenci są wtedy wstrzymani do ponownego włączenia.