Ingegneria
Come definire un contratto di distribuzione per app generate dall'AI
Anche il codice generato dall'AI richiede un contratto: compilalo, avvialo, configuralo, verificalo e instrada il traffico verso l'esatta versione che hai esaminato.
Il modello può scrivere codice rapidamente. Un contratto di distribuzione spiega come trasformare quel codice in un ambiente di esecuzione riproducibile.
Un contratto di distribuzione risponde a cinque domande
Un progetto generato può contenere una buona logica applicativa ed essere comunque impossibile da eseguire in modo coerente. Il contratto di distribuzione colma questa lacuna specificando comandi, ambiente di esecuzione, dipendenze, comportamento dei controlli di stato e route.
Tieni queste risposte vicine al sorgente. Se l'app richiede un database, una coda, una cache o una chiave privata di un provider, questa dipendenza deve essere visibile prima della distribuzione.
- —Come viene compilata l'app da un checkout pulito?
- —Come si avvia il processo di produzione?
- —Quale porta e quale percorso di verifica dello stato dimostrano che l'app è pronta?
- —Quali segreti e servizi gestiti sono richiesti?
- —Quale versione riceve il traffico pubblico?
Il codice generato non deve nascondere la gestione operativa
Gli strumenti AI scelgono spesso impostazioni predefinite comode. È utile durante l'esplorazione, ma gli sviluppatori devono comunque verificare che il server ascolti sull'host corretto, che le migrazioni siano sicure e che le credenziali siano richiamate tramite riferimenti anziché salvate nei commit.
Il contratto permette anche a chi esamina le modifiche di individuare rischi. Un nuovo comando di avvio, percorso di verifica dello stato, dipendenza da una risorsa o route pubblica può cambiare la disponibilità anche se il diff dell'applicazione sembra piccolo.
name: worker-api
build_cmd: go build -o /app/server ./cmd/server
start_cmd: /app/server
runtime:
name: go@1.25
port: 8080
health_path: /healthz
requires:
- db
- queueUsa le anteprime per verificare il contratto
Un'anteprima deve verificare le stesse condizioni di compilazione e avvio che userà la distribuzione. Se l'app non riesce ad ascoltare sulla porta configurata, non può leggere un segreto necessario o si dichiara sana mentre il database è irraggiungibile, correggi il problema prima della promozione.
Questo è il senso del collegamento tra spazi di lavoro basati sul sorgente e distribuzione. Lo sviluppatore può chiedere all'agente di apportare una modifica, eseguire l'anteprima, esaminare i log, aggiornare il manifest e distribuire la versione che ha superato le verifiche.
Simula un guasto a ogni confine
Esegui la compilazione da un checkout pulito, avvia il processo con la porta pubblica occupata, rimuovi un segreto necessario e rendi indisponibile una dipendenza verificata dal controllo di stato. Ogni errore deve avere limiti definiti, essere visibile nei log e consentire un nuovo tentativo sicuro.
Infine, ripristina la dipendenza e promuovi solo la revisione che ha superato le verifiche. Un contratto di distribuzione è utile quando descrive sia il percorso di funzionamento corretto sia il modo in cui un rilascio incompleto rimane escluso dal traffico.