Build¶
In Odoo.sh, una build è un database caricato da un server Odoo (odoo/odoo e odoo/enterprise) e che viene eseguito su una revisione specifica del repository del tuo progetto in un ambiente con contenitori. Il suo scopo è di testare il comportamento corretto del server e le funzionalità associate alla revisione.
Panoramica¶
Nella vista Build, ogni riga rappresenta un ramo e ogni cella nella riga rappresenta una build di quel ramo.
La maggior parte delle build vengono create dopo aver modificato i rami del repository di GitHub. È possibile crearli anche attraverso altre operazioni, come l’importazione di un database su Odoo.sh oppure tramite la richiesta di un rebuild per un ramo nel tuo progetto.
Le build possono avere tre stati:
una build viene considerata di successo se non appaiono errori o avvisi durante la creazione. Le build di successo vengono evidenziate in verde
una build viene considerata quasi di successo se appaiono avvisi ma non ci sono errori. Le build quasi di successo vengono evidenziate in giallo
una build viene considerata non riuscita se si verificano errori durante la creazione. Le build non riuscite vengono evidenziate in rosso.
Nota
Le build non sempre creano un database da zero. Ad esempio, quando si applica una modifica al ramo di produzione, la build creata avvia il server con la nuova revisione e prova a caricare il database di produzione attuale.
Fasi¶
Produzione¶
La prima build di un ramo di produzione crea un database da zero. Se la build è di successo, il database diventerà il database di produzione del tuo progetto.
Da questo momento in poi, gli invii al ramo di produzione creeranno nuove build che cercheranno di caricare il database usando un server che esegue la nuova revisione.
Se la build è di successo o quasi di successo, il database di produzione funzionerà con la build e la revisione associata.
Se la build non viene caricata o non aggiorna il database, la build di successo precedente viene riutilizzata per caricare il database. In questo caso, il database continua a funzionare usando la revisione di successo precedente.
Nota
La build utilizzata per eseguire il database di produzione è sempre la prima dell’elenco. Se una build fallisce, viene posizionata dopo la build che esegue il database di produzione.
Staging¶
Le build di staging duplicano il database di produzione e provano a caricare questa copia usando le revisioni dei rami di staging.
Ogni volta che invii una nuova revisione a un ramo di staging, la build risultante usa una copia nuova del database di produzione. I database non vengono riutilizzati tra build dello stesso ramo. Questo garantisce che:
Le build di staging usano database che riflettono lo stato attuale della produzione, quindi i tuoi test non vengono eseguiti con dati non aggiornati.
Puoi sperimentare liberamente in un database di staging. Quando vuoi iniziare con una nuova copia del database di produzione, puoi richiedere una nuova build.
Tuttavia, questo significa anche che se modifichi le impostazioni in un database di staging e non le applichi in produzione, le modifiche non saranno presenti nella prossima build dello stesso ramo di staging.
Sviluppo¶
Le build di sviluppo creano nuovi database, caricano dati demo ed eseguono i test unitari.
Una build verrà considerata non riuscita se i test falliscono durante l’installazione, in quanto sono progettati per generare errori quando qualcosa va storto.
La build viene considerata di successo quando tutti i test hanno esito positivo e non si verifica nessun errore.
Nota
In base all’elenco di moduli da installare e testare, una build di sviluppo può impiegare fino a un’ora per essere pronta. Questo si verifica a causa della grande quantità di prove incluse nella suite predefinita di moduli di Odoo.
Funzionalità¶
Il ramo di produzione appare sempre per primo. Altri rami vengono ordinati in base all’orario dell’ultima build creata. La fase evidenziata in viola corrisponde alla fase selezionata nel menu Rami.
Suggerimento
È possibile filtrare i rami usando la barra di ricerca.
Per ogni ramo, è possibile:
accedere all’ultimo database della build facendo clic su Collegati
accedere al codice del ramo facendo clic su Github
creare una nuova build facendo clic su Rebuild. Il sistema utilizza l’ultima revisione del ramo (non è disponibile se una build è già in corso per quel ramo).
Per ogni build, puoi:
visualizzare le modifiche alla revisione facendo clic sull’icona (GitHub)
accedere al database della build come amministratore facendo clic su Collegati oppure come un altro utente facendo clic sul pulsante (Più azioni) accanto a Collegati per poi selezionare Collegati come
accedere agli stessi strumenti della vista rami facendo clic sul pulsante Più azioni) accanto a Collegati per poi selezionare Log, Web Shell, Editor, E-mail in uscita (per le fasi di staging e sviluppo), Monitoraggio e Scarica dump database (per le fasi di produzione e staging).
