Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

La configurazione dichiarativa (blueprint) è la nuova generazione della configurazione degli ambienti: soggetta a controllo di versione, componibile e con aggiornamenti automatici. Questa guida ti accompagna nella migrazione dalla classica procedura guidata interattiva.
La configurazione classica dell’ambiente è in fase di deprecazione. Ci sono due date da tenere presenti:
  • 30 giugno 2026: Tutte le organizzazioni passano alla configurazione dichiarativa (blueprint). Da questa data non potrai avviare sessioni dalla tua Machine Configuration classica né modificarla. La tua configurazione classica non verrà eliminata.
  • 31 luglio 2026: La tua Machine Configuration classica resterà disponibile come riferimento in sola lettura fino a questa data, così potrai consultarla mentre completi la migrazione. Dopo il 31 luglio verrà rimossa.
Esegui la migrazione prima del 30 giugno 2026 per evitare interruzioni. I clienti Enterprise che hanno bisogno di più tempo devono contattare il proprio team dell’account.

​
Perché migrare?

Con la procedura guidata di configurazione classica, l’ambiente di Devin è uno snapshot configurato manualmente che può cambiare nel tempo. Le dipendenze diventano obsolete, le modifiche alla configurazione richiedono di eseguire di nuovo la procedura guidata e non c’è una cronologia delle versioni. La configurazione dichiarativa risolve questo problema:
  • Aggiornamenti automatici: i blueprint vengono ricostruiti quando la tua repo cambia, così le dipendenze restano aggiornate
  • Versionato: la configurazione del tuo ambiente si trova accanto al tuo codice, con cronologia completa
  • Modulare: i blueprint Enterprise, org e repo si integrano tra loro in modo pulito
  • Riproducibile: ogni build produce lo stesso risultato a partire dallo stesso blueprint
  • Sessioni più rapide: gli snapshot sono predefiniti con le repo clonate e le dipendenze installate, quindi le sessioni si avviano già pronte per lavorare
La tua configurazione classica continua a funzionare fino al 30 giugno 2026, poi resta disponibile come riferimento in sola lettura per la migrazione fino al 31 luglio 2026. Effettua la migrazione prima del 30 giugno 2026 per evitare interruzioni.

​
Prima di iniziare

Cerca un banner nella pagina Machine Configuration (la pagina di configurazione classica) con la dicitura “Passa alla configurazione dichiarativa dell’ambiente”. Se lo vedi, la tua organizzazione è idonea.Se non vedi il banner, la configurazione dichiarativa non è ancora stata abilitata per la tua organizzazione. Il rilascio è graduale. Contatta l’amministratore Enterprise o il supporto.
La migrazione richiede le autorizzazioni di amministratore dell’org (ManageOrgSettings). Se non sei un amministratore dell’org, nella pagina di migrazione vedrai il messaggio “Accesso amministratore richiesto”.
Sì, fino al 30 giugno 2026. Lo snapshot esistente viene conservato, quindi puoi ripristinarlo prima di allora per riportare la tua organizzazione a tale snapshot. Dopo il 30 giugno, tutte le organizzazioni passeranno alla configurazione dichiarativa e non potrai avviare sessioni dalla Machine Configuration classica, anche se resterà visibile come riferimento in sola lettura fino al 31 luglio 2026.

​
Passaggi per la migrazione

​
1. Vai alla pagina di migrazione

Vai a Settings > Migrazione dell’ambiente oppure fai clic su Inizia nel banner mostrato nella pagina Machine Configuration.

​
2. Abilita la configurazione dichiarativa

Fai clic su Abilita per l’organizzazione. In questo modo, il tuo org userà snapshot basati su blueprint per le nuove sessioni.
Questo non influisce sullo snapshot esistente. Viene conservato nel caso in cui tu debba ripristinarlo.

​
3. Lascia che Devin generi i tuoi blueprint

Devin fa il lavoro al posto tuo. Fai clic su Start migration e seleziona i repository che vuoi migrare per primi. Non devi migrare tutto in una volta. Inizia dalle repo che usi di più. Quando avvii la migrazione, Devin crea due sessioni:
  • Una sessione principale in esecuzione nel nuovo ambiente dichiarativo, che genera i blueprint
  • Una sessione di supporto in esecuzione sullo snapshot esistente, che Devin usa per verificare ciò che è installato al momento (versioni dei linguaggi, pacchetti di sistema, servizi in esecuzione, ecc.)
Devin esamina lo snapshot esistente, identifica quali strumenti e dipendenze sono installati e genera la configurazione del blueprint equivalente. I risultati vengono visualizzati nella pagina Settings > Environment > Blueprints.
Lo snapshot esistente è una “scatola nera” di tutto ciò che hai configurato nel tempo. Devin ispeziona quello snapshot, cataloga ciò che è installato e lo trascrive automaticamente come blueprint riproducibile.

​
4. Rivedi e modifica

Dopo che Devin ha generato i blueprint:
  1. Vai a Settings > Environment > Blueprints per controllare ciò che è stato generato
  2. Verifica lo stato della build. Assicurati che sia Success.
  3. Avvia una sessione di test per verificare che tutto funzioni:
    • Conferma che le repo siano clonate e che le dipendenze siano installate
    • Prova a eseguire i comandi di lint, test e build
    • Verifica che eventuali strumenti o runtime personalizzati siano disponibili
Se manca qualcosa, modifica direttamente il blueprint. Puoi aggiungere passaggi initialize, comandi maintenance o voci knowledge.

​
Ripristino

Se qualcosa non funziona, puoi tornare indietro fino al 30 giugno 2026:
  1. Vai a Settings > Migrazione dell’ambiente
  2. Fai clic su Revert to classic
  3. La tua organizzazione torna immediatamente a utilizzare lo snapshot precedente
Lo snapshot esistente viene conservato integralmente. Non si perde nulla. Puoi riprovare la migrazione in qualsiasi momento.
Dopo il 30 giugno 2026, il ripristino non sarà più disponibile. Tutte le organizzazioni useranno la configurazione dichiarativa e la Machine Configuration classica diventerà un riferimento in sola lettura fino al 31 luglio 2026: non potrai avviare sessioni da lì né ripristinarla. I clienti Enterprise che hanno bisogno di più tempo devono contattare il proprio account team.

​
Mappatura dei passaggi della configurazione classica nei blueprint

Se preferisci scrivere il blueprint manualmente (o vuoi capire la mappatura), ecco a cosa corrispondono i passaggi della procedura guidata classica:
Passaggio della configurazione classicaEquivalente nel blueprintNote
Git pullAutomaticoI blueprint gestiscono automaticamente git clone e pull
SecretsScheda Secrets nell’editor del blueprintConfigura nella scheda Secrets all’interno di ciascun editor di blueprint
Installazione delle dipendenzeinitializeConfigurazione una tantum: runtime del linguaggio, pacchetti di sistema, strumenti globali
Gestione delle dipendenzemaintenanceComandi per le dipendenze esposti all’agente all’inizio della sessione: npm install, pip install, ecc.
Lintknowledge (name: lint)Solo come riferimento, non eseguito durante le build
Testknowledge (name: test)Solo come riferimento, non eseguito durante le build
Avvio dell’appknowledge (name: dev-server)Solo come riferimento, non eseguito durante le build
Note aggiuntiveknowledgeVoci in formato libero per Devin

​
Esempio

Configurazione classica:
  • Installa le dipendenze: nvm use 20 && npm install
  • Aggiorna le dipendenze: npm install
  • Lint: npm run lint
  • Test: npm test
  • Avvia l’app: npm run dev
Blueprint equivalente: 
initialize: |
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  source ~/.bashrc
  nvm install 20

maintenance: |
  npm install

knowledge:
  - name: lint
    contents: npm run lint
  - name: test
    contents: npm test
  - name: dev-server
    contents: npm run dev

​
Risoluzione dei problemi

Controlla i log di build per individuare l’errore specifico. Cause comuni:
  • Un comando che funzionava nel terminale della configurazione classica non funziona nel contesto di build (ad es. prompt interattivi che richiedono il flag -y)
  • secrets mancanti (assicurati che i secrets siano configurati nella scheda Secrets dell’editor del blueprint)
  • Confronta i comandi del blueprint con quelli originali per individuare eventuali differenze
Assicurati che la sezione maintenance includa gli stessi comandi di installazione delle dipendenze del passaggio classico Maintain Dependencies. Comandi come npm install o pip install -r requirements.txt devono trovarsi in maintenance, non in initialize.
Verifica che la sezione knowledge contenga voci denominate lint e test con i comandi corretti. Devin cerca questi nomi quando verifica il proprio lavoro.
Se la configurazione classica modificava ~/.bashrc, ~/.profile o altri file di configurazione della shell, sposta queste modifiche in initialize:
initialize: |
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  echo 'export NODE_ENV=development' >> ~/.bashrc
I blueprint gestiscono automaticamente git clone durante le build. Se le repo non vengono clonate, verifica che siano state aggiunte nella pagina Settings > Environment > Blueprints e che Devin abbia accesso tramite la tua integrazione Git.