Crunu i Vercel: hosting serwera i zmienne środowiskowe

Dwa sposoby współpracy Crunu z Vercel

• Hosting serwera Crunu na Vercel. Jeśli twój zespół już tam wdraża, serwer Crunu ma wersję dla Vercel, która korzysta z Postgresa na Neon. Ta część jest wbudowana: wdraża ją jeden skrypt.
• Przesyłanie wartości do twoich projektów Vercel. Crunu nie ma wbudowanej synchronizacji ze zmiennymi środowiskowymi Vercel. Potok może je przesłać krótkim przepisem, pokazanym niżej.

Samo Crunu działa w chmurze na app.crunu.com, więc pierwsza część jest potrzebna tylko wtedy, gdy chcesz mieć własny serwer.

Hosting serwera na Vercel

Potrzebujesz Node.js 24, CLI vercel po wykonaniu vercel login, bazy danych Neon z adresem puli połączeń w DATABASE_URL i pliku .env utworzonego przez server-init. Polecenia uruchamia się z katalogu serwera Crunu, w którym są skrypty wdrożeniowe.

node scripts/server-init.mjs --origin https://vault.company.example --database-url env:DATABASE_URL
sh deploy/vercel/deploy.sh --project vault-company --prod

Skrypt sprawdza .env, buduje serwer z wbudowanym klientem webowym, w razie potrzeby tworzy projekt, zapisuje zmienne środowiskowe z wartościami przekazanymi przez stdin i wdraża gotowy wynik kompilacji. Migracje schematu serwer stosuje do swojej bazy danych sam.

Bez --prod skrypt wdraża wersję podglądową z własną bazą danych i własnym kluczem serwera, ustawionymi jako PREVIEW_DATABASE_URL i PREVIEW_SERVER_KEY. Kompilacja podglądowa uruchomiłaby migracje na każdej bazie, do której jest podłączona, więc skrypt odmawia skierowania podglądu na dane production, chyba że przekażesz --preview-with-production-db.

Harmonogram czyszczenia

Czyszczenie wygasłych rekordów uruchamia zadanie cron Vercel, tylko dla wdrożeń production z ustawionym CRON_SECRET. Domyślnie raz dziennie, bo plan Hobby nie pozwala na częstszy harmonogram; sprawdź aktualne limity planów Vercel. Wygasanie sesji, linków i dostępu awaryjnego od tego nie zależy, bo sprawdza je każde żądanie. Niektóre alerty owszem. Jeśli używasz ograniczeń sieciowych z przepustkami maszyn, uruchamiaj czyszczenie co minutę lub przynajmniej co 5 minut, co wymaga Vercel Pro, i przekazuj harmonogram przy każdym wdrożeniu:

sh deploy/vercel/deploy.sh --project vault-company --prod --cron "* * * * *"

Przesyłanie wartości do Vercel z CI

Jeśli twój projekt Vercel trzyma zmienne w Vercel, potok może je skopiować z Crunu. Użyj osobnego tokenu production z powiązaniem CI (OIDC) z gałęzią main i środowiskiem wdrożenia production, żeby token działał tylko w tym jednym zadaniu. Dostęp do production zatwierdza dla niego właściciel.

crunu run --env web-app/production -- sh -c 'printf "%s" "$DATABASE_URL" | vercel env add DATABASE_URL production --force'

crunu run odszyfrowuje środowisko w pamięci i przekazuje DATABASE_URL poleceniu, które podaje je vercel env add przez stdin, nigdy jako argument. Każde uruchomienie jest zapisywane w dzienniku audytu Crunu: kto, kiedy, z jakiego adresu i która wersja.

Zobacz także

• Własny hosting
• Vercel w dokumentacji
• CI/CD w Crunu
• GitHub Actions