Primi passi¶
Componenti principali¶
Quando si lavora con Odoo.sh, è importante comprendere i principali componenti coinvolti:
Sebbene siano tutti interconnessi, ognuno svolge un ruolo distinto nello sviluppo e nella distribuzione delle applicazioni Odoo. Insieme, formano una pipeline coesa che va dallo sviluppo del codice all’utilizzo aziendale in produzione.
Repository GitHub¶
Una repository GitHub è come una cartella sul computer che contiene tutti i file e le cartelle di un progetto specifico. La differenza è che viene archiviata su GitHub e può essere consultata e modificata da più persone su computer diversi.
In altre parole, una repository GitHub è un luogo dove puoi archiviare i file del tuo progetto e condividerli con altri, in modo che possano collaborare con te, apportare modifiche e contribuire al progetto. Inoltre, tiene traccia di tutte le modifiche apportate al progetto nel tempo, così puoi facilmente tornare a una versione precedente se necessario.
Inoltre, GitHub offre numerose funzionalità per aiutarti a gestire il progetto, come il tracciamento dei problemi, l’invio di richieste e le revisioni del codice. È uno strumento potente per gestire progetti software e collaborare su di essi, ed è ampiamente utilizzato dagli sviluppatori di tutto il mondo. Uno spazio con controllo di versione in cui viene archiviato il codice sorgente delle applicazioni Odoo. Tiene traccia di ogni modifica, supporta la collaborazione e può essere pubblico o privato.
Progetto Odoo.sh¶
Un progetto Odoo.sh è una piattaforma come servizio (PaaS) che si integra con GitHub e consente lo sviluppo, il collaudo e l’implementazione semplificati delle applicazioni Odoo. Include strumenti quali backup automatici, ambienti di staging e pipeline di integrazione continua.
Database Odoo¶
Un database Odoo memorizza tutti i dati operativi utilizzati e generati dalle applicazioni Odoo come i registri aziendali, le configurazioni e i dati degli utenti.
Tipologie utente¶
Odoo.sh coinvolge diversi tipi di utenti, ciascuno con un ruolo specifico nel ciclo di vita del progetto:
Utenti GitHub: sviluppatori con accesso alla repository GitHub collegato al progetto Odoo.sh. L’accesso alla repository non rende automaticamente qualcuno un collaboratore del progetto Odoo.sh;
collaboratori Odoo.sh: persone che gestiscono il progetto Odoo.sh. Ogni collaboratore deve essere collegato a un utente GitHub. Tuttavia, i collaboratori non sono gli stessi degli utenti del database;
utenti del database: utenti finali del database Odoo implementato. Interagiscono con il sistema live ma non sono coinvolti nello sviluppo o nella gestione del progetto.
Concetti tecnici¶
Quando utilizzi Odoo.sh è importante comprendere anche alcuni concetti tecnici:
Creare un fork di una repository¶
Creare un fork di una repository su GitHub significa creare una copia della repository di un’altra persona sul proprio account. Questo permette di apportare modifiche alla repository senza influire sulla versione originale.
Al momento della creazione di un fork di una repository ottieni una copia personale completa di tutti i file e le cartelle presenti nella repository originale. È quindi possibile modificare i file nella propria copia e registrarli con un commit, proprio come in qualsiasi altra repository.
Il vantaggio di creare un fork di una repository è che si possono apportare modifiche al codice senza influire sulla versione originale, il che è utile quando si desidera sperimentare nuove funzionalità o correggere bug nel codice di qualcun altro. La repository che ha subito l’operazione di forking può anche essere usata come punto di partenza per il proprio progetto dopo aver apportato le modifiche necessarie.
Una volta apportate le modifiche alla repository duplicata, è possibile inviare una pull request al proprietario della repository originale, chiedendogli di unire le modifiche alla sua repository. Si tratta di un approccio comune nei progetti open source per accettare i contributi di altri sviluppatori: partecipare in questo modo alla community può rappresentare un’ottima occasione per migliorare le proprie competenze di programmazione.
Eseguire il push di un commit¶
Quando si apportano modifiche a uno o più file all’interno di una repository Git sul computer locale, tali modifiche sono considerate non registrate. In altre parole, Git rileva che sono state apportate delle modifiche, ma queste non sono ancora state ufficialmente salvate o registrate.
Per salvare tali modifiche e aggiungerle alla repository Git, è necessario creare un commit. Un commit rappresenta un’istantanea delle modifiche apportate ai file in un momento specifico. Registra quali modifiche sono state fatte, chi le ha apportate e quando.
Una volta creato un commit, è possibile eseguirne il push su una repository remota, ad esempio una ospitata su GitHub. Eseguire il push di un commit significa inviare le modifiche apportate nel commit dalla repository locale a quella remota, in modo che altri possano visualizzarle e utilizzarle.
In sintesi, eseguire il push di un commit significa inviare le modifiche apportate ai file della repository Git dal proprio computer locale a una repository remota. È un modo per condividere le modifiche con altri e collaborare a un progetto.
Unire un ramo¶
Unire un ramo con un altro significa combinare le modifiche apportate in un ramo nell’altro. Ad esempio, hai creato un nuovo ramo chiamato feature-branch per lavorare a una nuova funzionalità del tuo progetto. Dopo aver apportato tutte le modifiche al ramo, puoi unire le modifiche al ramo principale (spesso chiamato master o main).
Quando unisci un ramo, Git esamina le modifiche apportate a entrambi i rami e cerca di combinarle. Se ci sono conflitti tra le modifiche apportate ai due rami, Git ti chiederà di risolverli prima di completare l’unione (a livello di codice).