Nowość w Endora Commerce: wbudowany CRM z szansami sprzedażowymi Zobacz →
Endora Commerce

Integracja z Redis

Redis jest jedną z trzech usług, bez których Endora Commerce nie wystartuje. Trzyma cache, przyspiesza odczyt sesji i jest podłożem kolejek, przez które idzie praca w tle: webhooki, e-maile transakcyjne, feedy, newsletter, operacje masowe.

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.

KolejkaCo robiCo widać w panelu
Dostarczanie webhookówPodpisuje zdarzenie (HMAC-SHA-256) i wysyła je pod adres odbiorcy; do 8 prób z wykładniczo rosnącym odstępemLista dostarczeń przy webhookach; ostatecznie nieudane dostarczenie można ponowić ręcznie
E-maile transakcyjneWysyłka wiadomości wywołanych zdarzeniami w sklepie, takich jak potwierdzenie zamówienia czy powiadomienie o wysyłce-
Operacje masowe kataloguEdycja masowa powyżej 50 produktów oraz pełna reindeksacja Meilisearch po zmianie flagi wyszukiwalności atrybutuStrona „Akcje masowe” ze statusem i licznikami; po zakończeniu powiadomienie w panelu i e-mail
Feedy produktoweGenerowanie i dostarczanie plików, m.in. dla Google Merchant Center-
NewsletterPlanowanie kampanii i wysyłka po jednym zadaniu na odbiorcę, kroki automatyzacji-
Zdarzenia analityczne z serweraDostarczanie 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 rodzaju allkeys-lru są 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.

Sprawdźmy, co da się podłączyć u Ciebie

Umów bezpłatną konsultację. Przejdziemy przez Twój ERP, magazyn i procesy sprzedaży, i pokażemy, jak wygląda ścieżka integracji krok po kroku.

Michał Zabielski, założyciel i CEO Endory

Michał Zabielski

Założyciel i CEO Endory

Odpowiadamy w ciągu jednego dnia roboczego.