Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Per portare online in modo affidabile una modifica scritta da un agente di coding, trattala come qualsiasi contributo non ancora approvato: rivedi il codice, pubblicalo in una Preview Vercel, verifica build e comportamento, poi rilasciala sul branch di produzione. Con Git collegato il ciclo può essere rapido e ripetibile, ma non esiste una durata garantita: dipende da build, configurazione, variabili d’ambiente e controlli.

Il flusso: modifica, Preview, verifica, produzione

  1. Fai lavorare l’agente su una modifica tracciabile. Tieni il progetto in Git e controlla la diff prima di approvare il codice: il fatto che una modifica sia stata generata non significa che sia già pronta per la produzione.
  2. Collega il repository a Vercel. Con l’integrazione Git, i push ai branch e le pull request supportate possono generare deployment. I branch diversi da quello di produzione sono normalmente trattati come Preview; il nome del branch di produzione si configura nel progetto e non è necessariamente main. Vercel documenta l’integrazione con GitHub, GitLab, Bitbucket e Azure DevOps. Documentazione Vercel sull’integrazione Git.
  3. Rivedi la Preview. Apri l’URL del deployment e prova le pagine e le funzioni toccate dalla modifica. Preview è un ambiente separato: consente di testare e condividere il lavoro senza modificare il sito live. Vercel descrive gli ambienti come Local, Preview e Production. Documentazione Vercel sugli ambienti.
  4. Controlla build, log e verifiche del progetto. Assicurati che la build termini e che le route interessate rispondano come previsto. Se usi Deployment Checks, puoi configurare stati di commit e risultati selezionati di GitHub Actions come requisiti per la promozione; non dare per scontato che questi gate siano attivi automaticamente in ogni progetto. Documentazione Vercel sui Deployment Checks.
  5. Rilascia sul branch di produzione configurato. Con Git, il merge a quel branch avvia il deployment di produzione. Se il team richiede un’approvazione esplicita prima del rilascio, configura il flusso perché il merge o la promozione avvengano soltanto dopo i controlli desiderati.
  6. Verifica il sito live. Dopo il deployment, prova il dominio di produzione e controlla i log. Predisponi anche un percorso di rollback, così da poter recuperare se la nuova versione causa un problema. Documentazione Vercel sul rollback.

Git, CLI o GitHub Actions: quale percorso scegliere?

La scelta dipende da quanto vuoi automatizzare e da quanto controllo ti serve sulla build. Le fonti Vercel non stabiliscono tempi o costi comparabili per queste opzioni.

Percorso Adatto quando Flusso e compromesso
Integrazione Git Il repository è ospitato su un provider supportato e vuoi un flusso standard. Push o pull request genera una Preview; il merge al branch di produzione configurato avvia il deployment live. Meno passaggi manuali, ma la configurazione del progetto e delle verifiche resta importante.
Vercel CLI Vuoi eseguire i passaggi manualmente, verificare in modo esplicito o lavorare senza il normale flusso di repository collegato. Collega il progetto, recupera le variabili, pubblica una Preview, controlla URL e log, quindi esegui il deploy di produzione. Il rilascio è visibile nei comandi e resta sotto il tuo controllo.
GitHub Actions con CLI Hai una pipeline CI personalizzata, controlli propri o un caso come GitHub Enterprise Server. vercel build crea gli artefatti in CI e vercel deploy --prebuilt li carica. Offre controllo sulla build, ma richiede configurazione della pipeline e gestione dei segreti.

Procedura manuale con Vercel CLI

La CLI consente di separare chiaramente la prova del deployment dal rilascio live. I comandi e le opzioni possono cambiare: consulta la documentazione CLI Vercel per i dettagli aggiornati.

  1. Collega la directory locale al progetto: esegui vercel link e completa la selezione guidata del progetto.
  2. Recupera le variabili del progetto: usa il comando documentato vercel env pull per sincronizzare nell’ambiente locale le variabili pertinenti. Verifica di usare i valori dell’ambiente previsto.
  3. Crea una Preview: esegui vercel deploy. Al termine, annota l’URL restituito.
  4. Verifica Preview e log: prova l’URL e usa vercel curl per interrogare il deployment; controlla inoltre i log per errori di build o runtime.
  5. Rilascia in produzione: quando la verifica è soddisfacente, esegui vercel deploy --prod.
  6. Controlla il deployment live: ripeti le verifiche sul dominio di produzione e consulta i log di produzione. Se il risultato non è corretto, valuta il rollback secondo la procedura Vercel.

Preview e produzione non sono intercambiabili

Una Preview è utile per verificare il codice in un deployment accessibile, ma non dimostra che il rilascio live avrà configurazione identica. Le variabili d’ambiente possono essere impostate separatamente per Local, Preview e Production; controlla quindi i valori effettivi usati in produzione prima di promuovere o ricostruire il deployment. Anche la promozione di una Preview può comportare una build di produzione e l’uso delle variabili di Production. La guida Vercel agli ambienti illustra la distinzione.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Quando usare GitHub Actions e gli artefatti precompilati

Se la pipeline deve eseguire controlli o preparare la build in un ambiente CI specifico, puoi usare la CLI dentro GitHub Actions. Il flusso documentato crea prima gli artefatti con vercel build, quindi li carica con vercel deploy --prebuilt. Questo approccio sposta sulla pipeline parte del controllo e dell’onere operativo: configura i segreti necessari con attenzione e fai fallire il workflow quando i controlli obbligatori non passano. Documentazione Vercel sui deployment prebuilt.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Aggiungere un dominio personalizzato

Il dominio non è necessario per provare una Preview, ma può servire per il sito pubblico. Aggiungilo al progetto con la CLI o con le impostazioni Vercel, poi configura i record DNS richiesti affinché puntino a Vercel. Verifica la configurazione mostrata per il tuo progetto e provider DNS: i valori dipendono dal caso specifico. Documentazione Vercel sui domini.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.