Migracja z InstantDB i Inngest na Convex: jak przeniosłem produkcję w 16 dni
19 listopada przełączyłem produkcję analizakolorystyczna.net z InstantDB i self-hosted Inngest na Convex. Od researchu do ostatniego testu minęło 16 dni, a główny PR miał 342 pliki, +32 447 i −6 308 linii.
W tym wpisie opisuję, dlaczego to zrobiłem, jakie decyzje podjąłem po drodze i co wyszło dopiero w dniu przełączenia.

Skąd pomysł
analizakolorystyczna.net robi analizę kolorystyczną ze zdjęć. Klientka wypełnia ankietę, wgrywa zdjęcia, płaci przez Stripe, a w tle pipeline z kilkoma wywołaniami modeli AI składa raport, stylizacje i PDF. Dane trzymałem w InstantDB, a pipeline i 10 cronów chodziło na Inngest postawionym samodzielnie na VPS przez Coolify.
Problemem był Inngest. Sam serwer, do tego Postgres, cron czyszczący dysk (raz zapchał go do 91%) i osobne reguły w sieci, bo długie kroki AI nie mieściły się w limicie proxy. Dwa incydenty przelały czarę:
- Raz Inngest restartował się w kółko przez 38 minut. Nowa wersja obrazu Dockera nie miała już
curl, więc test „czy serwer żyje” nie mógł się wykonać. Kontener, który pilnuje innych kontenerów, uznawał przez to zdrowy serwer za martwy i restartował go mniej więcej co minutę. - Innym razem preview z PR-a zarejestrował się w Inngest pod tym samym ID co produkcja. Self-hosted Inngest ma jeden rejestr aplikacji, więc wygrała ostatnia synchronizacja. Przez kilkanaście godzin produkcyjne zadania chodziły na kontenerze preview podpiętym do bazy stagingowej, a gdy preview zniknął, wszystkie funkcje przez prawie 8 godzin zwracały 503.
Oba wykrył heartbeat w Healthchecks.io, nie klientka. Ale za każdym razem traciłem pół dnia na infrastrukturę zamiast na produkt.
Drugi powód przyszedł z zewnątrz. 22 sierpnia 2026 zespół InstantDB ogłosił przejście do OpenAI. Instant Cloud nie przyjmuje nowych kont, a 31 sierpnia 2027 wszystkie aplikacje w chmurze zostaną wyłączone. Zostaje tylko self-hosting, według ich własnego poradnika od około 30 USD miesięcznie na VPS. Czyli zamiast mniej infrastruktury miałbym jej więcej.
Trzeci powód to modele AI. Tekst szedł przez OpenRouter, a obrazy przez fal.ai, czyli dwa kolejne konta, klucze i panele z rozliczeniami. Convex ma własną bramkę AI, więc chciałem mieć bazę, kolejkę i modele w jednym miejscu i w jednym panelu.
Dlaczego Convex, a nie coś innego
Chciałem mniej infrastruktury i gotowe komponenty zamiast własnego kodu do kolejek. Convex daje bazę, storage, crony, scheduler i komponent @convex-dev/workflow do długich procesów w jednym miejscu. Wybrałem plan Starter w regionie EU: ma te same darmowe limity co Free, ale po ich przekroczeniu dalej działa i dolicza grosze, zamiast zwracać błędy.

Uczciwie: dziś sama zmiana bazy nie usunęła żadnego serwera, bo InstantDB był jeszcze SaaS-em. Zysk na dziś to wyłączenie Inngesta, a zysk od sierpnia 2027 to brak własnej instancji InstantDB. Nie sprawdziłem Inngest Cloud, które usunęłoby self-hosting kolejki bez przepisywania bazy. Bazę i tak musiałem przenieść, więc wolałem mieć wszystko u jednego dostawcy. Czy to była dobra decyzja, pokaże kilka miesięcy na produkcji.
Największe ryzyko w limitach to nie miejsce na pliki, tylko odczyty z bazy: 1 GB miesięcznie. Cron, który co 5 minut skanuje całą tabelę analiz, zjadłby około 17 GB. Dlatego każdy cron czyta przez indeks i tylko okno czasowe.
Decyzje, które podjąłem po drodze
- Zdjęcia w storage Convexa. Linki do zdjęć nie trafiają do logów, maili ani analityki.
- Pipeline na Workflow, ale maile z porzuconego koszyka na schedulerze. Workflow wymaga deterministycznego kodu: zmiana kodu wywraca przebiegi, które właśnie trwają. Raport generuje się w kilka minut, więc to akceptowalne. Przypomnienie, które czeka 16 godzin, wywaliłby pierwszy deploy, więc tu jest zwykły łańcuch
ctx.scheduler.runAfter. - Webhook Stripe zostaje w Next.js. Komponent
@convex-dev/stripebył w wersji 0.1.x i nie obsługiwał wszystkiego, czego potrzebuję. Walidacja płatności to ścieżka, na której tracę pieniądze, więc nie przepisuję jej na młodą bibliotekę. Route w Next.js woła mutację w Convexie. - Własne logowanie do panelu admina. Convex Auth jest w becie, a dla jednego admina nie potrzebuję produktu do autoryzacji. Ciasteczko podpisuje Next.js, a unieważnione sesje trzymam w tabeli.
- Modele AI przez AI Gateway Convexa. Zanim przełączyłem, sprawdziłem testowym wywołaniem, że gateway przyjmuje zdjęcia. Model do flat-layów, którego używałem na fal.ai, nie był na liście. Zmiana modelu u mnie to zmiana kolorów w raporcie, więc nowy model musiał przejść pomiar palety na wygenerowanych obrazach. Wygenerowałem po 8 obrazów dla 3 typów urody: seedream-4.5 z gatewaya miał 1 obraz na 24 z kolorem spoza palety, stary seedream v4 z fal.ai miał takich 5.
- Własny backup. Starter nie ma automatycznych kopii. Co noc GitHub Actions robi
convex exporti wysyła plik do S3.
Jedna rzecz zaskoczyła mnie najbardziej: każda funkcja Convexa, która nie jest oznaczona jako internal, jest dostępna z internetu. Jedno przeoczenie i dane klientek wiszą publicznie. Każdą publiczną funkcję zabezpieczyłem.
Jak przełączać bez wielkiego wybuchu
Najważniejsza decyzja techniczna: cały kod aplikacji czyta i zapisuje dane przez jeden moduł @/lib/data. Flaga DATA_BACKEND wybiera bazę przy każdym wywołaniu, a TypeScript pilnuje, żeby obie implementacje miały te same funkcje:
function isConvex(): boolean {
const backend = process.env.DATA_BACKEND;
if (backend === undefined || backend === "" || backend === "instant") {
return false;
}
if (backend === "convex") return true;
throw new Error(`Unknown DATA_BACKEND "${backend}"`);
}
// tsc fails when the Convex side drifts from the InstantDB side
const convex = { ...convexAnalyses, ...convexFiles } satisfies Partial<typeof instant>;
function route<K extends keyof typeof convex>(name: K) {
return (...args: unknown[]) => (isConvex() ? convex : instant)[name](...args);
}
export const loadAnalysis = route("loadAnalysis");
Do tego dwie kolejne flagi: PIPELINE_BACKEND dla generowania raportu i CRONS_BACKEND dla cronów. Każdą część przełączam osobno i każdą mogę cofnąć bez zmiany kodu: zmieniam zmienną w Coolify i robię redeploy. Bazy już nie cofam: po pierwszym zapisie w Convexie poprawiam do przodu, a nocny eksport jest kopią na czarną godzinę.

Ten wybór przydał się już w dniu przełączenia. Przypomnienia o porzuconej płatności nadal czekały w starym Inngest, ale czytały analizę przez @/lib/data, więc po przebudzeniu trafiały do Convexa, widziały opłacone zamówienie i nic nie wysyłały.
Review przed przełączeniem
Kod pisały agenty w Claude Code, a ja zatwierdzałem plany i merge. Przed przełączeniem zleciłem dwa niezależne review całej migracji dwóm różnym modelom: Claude Fable 5.2 i Gemini 4 Carbon. Żaden nie widział notatek drugiego. W drugiej rundzie każdy sprawdzał tylko to, co znalazł ten drugi, a każde znalezisko jeszcze raz weryfikowałem w kodzie.
Wyszło 7 blokerów. Trzy przykłady:
- Merge PR-a zablokowałby mi dostęp do panelu admina, bo nowe logowanie potrzebowało zmiennej, której nie było jeszcze w Coolify.
- Testy E2E i płatny test na PR-ze sprawdzały stary stos, bo preview nie miał flag Convexa. Zielone checki niczego by nie dowiodły.
- Opcjonalne zmienne, których zabrakłoby w Convexie, wyłączyłyby po cichu flat-laye, analitykę i kod polecający. Skrypt deployu odmawia teraz wdrożenia na produkcję, jeśli którejś brakuje.
Próba migracji na sucho na danych produkcyjnych znalazła 181 linków do zdjęć bez pliku w 28 analizach. Wszystkie były zakończone, a zdjęcia skasowane wcześniej zgodnie z retencją. Migracja dostała flagę, która przepuszcza taki brak tylko dla zakończonych analiz. Dla każdej innej się zatrzymuje.
Bez blokady zapisów
Oba review zalecały blokadę zamówień na czas migracji. Zrezygnowałem z niej. Jakiś czas temu wyłączyłem reklamy, które były głównym źródłem ruchu i zamówień, więc mogłem być spokojny, że podczas migracji raczej nic się nie wydarzy. Zamiast flagi w kodzie przed przełączeniem sprawdziłem w Stripe, czy nie ma otwartych sesji płatności, a w bazie, czy żadna analiza nie jest w trakcie generowania. Obie liczby wynosiły zero. Przy normalnym ruchu nie poszedłbym na to.
Dzień przełączenia
Całość zajęła jeden dzień, w kolejności:
- Merge PR-a i deploy. Smoke test na produkcji, logowanie do panelu admina, nocny backup ręcznie.
- Migracja danych: 864 wiersze. Skrypt weryfikacji porównał obie bazy: 790 analiz, 2997 zdjęć, 88 blokad płatności, 74 etykiety ekspertki. Wynik
PARITY OK. - Flagi danych i pipeline’u na
convex. Druga migracja po przełączeniu pokazałainserted 0 skipped 864, czyli nic nie wpadło do starej bazy w międzyczasie. - Dwa prawdziwe zamówienia przez formularz, z kuponem 100%. Oba przeszły przez Workflow w Convexie bez błędu. Mail, raport, stylizacje i PDF działały.
- Crony na Convex. Najpierw sprawdziłem, że w Inngest nic nie działa ani nie czeka, potem flaga po obu stronach. Inngest zdjął 4 crony z listy, a heartbeat z Convexa doszedł do Healthchecks.
- Test odtworzenia kopii. Nocny eksport zaimportowałem do jednorazowego deploymentu i porównałem liczby wierszy w 8 tabelach. Wszystkie równe.
Najbardziej nerwowy moment był po flagach cronów. Od tej nocy Convex sam kasuje zdjęcia klientek po upływie okresu przechowywania, a takie kasowanie jest nieodwracalne. Cron porównuje daty jako tekst, więc jedna data w złym formacie mogłaby uznać świeże zdjęcia za stare. Przed pierwszym przebiegiem puściłem próbę na sucho: 787 analiz, wszystkie daty w ISO, 0 wierszy do skasowania. Dopiero wtedy zostawiłem to na noc 🤷♂️
Co wyszło dopiero na produkcji
- Adres deploymentu musi mieć region w nazwie hosta. Krótki adres bez regionu zwraca 404.
- Na Starterze panel nie pozwala utworzyć dodatkowego deploymentu. Do testu kopii użyłem CLI:
convex deployment createz--expiration "in 1 day", więc deployment sam się usuwa. convex dataz--limit 100000zwraca błąd „Requested too many items”, a ja przez2>/dev/nullzobaczyłem same zera i przez chwilę myślałem, że import nie zadziałał 🤣- W planie miałem sprawdzić w logach Convexa powód zakończenia odpowiedzi modelu. Convex go nie loguje, bo przekazuje go aplikacji. Sprawdziłem więc, czy aplikacja nie zgłosiła żadnego błędu modelu od przełączenia.
Co dalej
Przez tydzień stary stos stoi obok jako awaryjny powrót dla pipeline’u i cronów. Potem wchodzi ostatni etap: usunięcie InstantDB i Inngesta z kodu, CI, Coolify i dokumentacji. Warunek końca jest prosty: grep po nazwach starych usług zwraca tylko historię.
Masz pytania o Convex albo sam planujesz ucieczkę z self-hosted kolejki? Zostaw komentarz, chętnie porównam doświadczenia 👋