Crunu e Vercel: ospita il server, invia le variabili
Esegui un tuo server Crunu su Vercel con Postgres su Neon, oppure invia da una pipeline CI i valori di un ambiente Crunu nelle variabili d’ambiente di Vercel.
- Supporto
- Funziona con Crunu oggi: il supporto per Vercel fa parte del prodotto.
- Funzionalità di Crunu
- Self-hosting e CI/CD
- Verificato
- Con Crunu 6.0.0 il 28 ottobre 2026
Funzionalità di Crunu che funzionano con Vercel
Ogni funzionalità qui sotto funziona allo stesso modo in ogni integrazione: il server conserva testo cifrato, e solo le persone, le macchine e i token a cui concedi l’accesso possono decifrare.
Self-hosting
Esegui lo stesso server Crunu sul tuo host Docker, su Cloudflare Workers, Vercel o Google Cloud Run, e spostati dall’uno all’altro con un solo archivio.
Scopri di più
CI/CD
Dai a ogni pipeline un token di servizio limitato ai suoi ambienti e legalo al tuo provider CI con OIDC, così un token trapelato non può accedere da solo.
Scopri di più
Come funziona con Vercel
In questa pagina
Due modi in cui Crunu lavora con Vercel
- Ospitare il server Crunu su Vercel. Se il tuo team pubblica già lì, il server Crunu ha una build per Vercel che usa Postgres su Neon. Questa parte è integrata: un solo script esegue il deploy.
- Inviare valori ai tuoi progetti Vercel. Crunu non ha una sincronizzazione integrata verso le variabili d’ambiente di Vercel. Una pipeline può inviarle con una breve ricetta, mostrata più sotto.
Crunu stesso funziona nel cloud su app.crunu.com, quindi la prima parte ti serve solo se vuoi un tuo server.
Ospitare il server su Vercel
Ti servono Node.js 24, la CLI vercel con vercel login già eseguito, un database Neon con il suo indirizzo con pooling in DATABASE_URL e un file .env creato da server-init. I comandi si eseguono dalla directory del server Crunu, dove si trovano gli script di deploy.
node scripts/server-init.mjs --origin https://vault.company.example --database-url env:DATABASE_URL
sh deploy/vercel/deploy.sh --project vault-company --prodLo script controlla .env, compila il server con il client web al suo interno, crea il progetto se serve, scrive le variabili d’ambiente con i valori passati tramite stdin ed esegue il deploy dell’output già compilato. Il server applica da solo le migrazioni dello schema al proprio database.
Senza --prod, lo script pubblica un’anteprima con un proprio database e una propria chiave del server, impostati come PREVIEW_DATABASE_URL e PREVIEW_SERVER_KEY. Una build di anteprima eseguirebbe le sue migrazioni su qualsiasi database a cui è collegata, quindi lo script rifiuta di puntare un’anteprima ai dati di produzione a meno che tu non passi --preview-with-production-db.
Pianificazione della pulizia
La pulizia dei record scaduti gira su un cron job di Vercel, solo per i deployment di produzione con CRON_SECRET impostato. Il valore predefinito è una volta al giorno, perché il piano Hobby non consente una pianificazione più frequente; controlla i limiti attuali dei piani di Vercel. La scadenza di sessioni, link e accessi break-glass non dipende dalla pulizia, perché ogni richiesta li controlla. Alcuni avvisi invece sì. Se usi restrizioni di rete con pass delle macchine, esegui la pulizia ogni minuto o almeno ogni 5 minuti, il che richiede Vercel Pro, e passa la pianificazione a ogni deploy:
sh deploy/vercel/deploy.sh --project vault-company --prod --cron "* * * * *"Inviare valori a Vercel dalla CI
Se un tuo progetto Vercel conserva le sue variabili in Vercel, una pipeline può copiarle da Crunu. Usa un token di produzione separato con un vincolo CI (OIDC) al branch main e all’ambiente di deployment production, così il token funziona solo in quel job. Un proprietario approva per il token l’accesso a production.
crunu run --env web-app/production -- sh -c 'printf "%s" "$DATABASE_URL" | vercel env add DATABASE_URL production --force'crunu run decifra l’ambiente in memoria e passa DATABASE_URL al comando, che lo consegna a vercel env add tramite stdin, mai come argomento. Ogni esecuzione viene registrata nel registro di audit di Crunu: chi, quando, da quale indirizzo e quale versione.
Correlati
Dubbi frequenti
Non trovi la risposta? Scrivi a support@crunu.com e ti risponderà una persona.
Un deployment di anteprima può toccare i dati di produzione?
Non per impostazione predefinita. Un’anteprima ha un proprio database e una propria chiave del server, e lo script rifiuta il database di produzione a meno che tu non passi --preview-with-production-db.
Ogni quanto viene eseguita la pulizia?
Una volta al giorno per impostazione predefinita. Con restrizioni di rete e pass delle macchine, eseguila ogni minuto o ogni 5 minuti, il che richiede Vercel Pro.
Crunu sincronizza i valori nelle variabili d’ambiente di Vercel?
Non da solo. Una pipeline con un token di produzione legato tramite OIDC può inviare i valori con vercel env add eseguito sotto crunu run.