
Creazione di un repository per prod e dev su Github
By
Per un progetto web con Laravel voglio creare un repository su Github con almeno 2 branch: MAIN e DEV. Il branch main sarà quello di produzione ovvero del sito online, mentre naturalmente il branch dev sarà quello di sviluppo. Quando eseguo un pull sul branch dev, si andrà a fare il merge delle modifiche validate sul branch main e quindi il pull sul progetto online.
Usiamo il terminale
Può non piacere molto l’uso del terminale, ma consentirà di capire ogni dettaglio di ciò che andiamo a fare. Quindi se siamo su Windows apriamo PowerShell mentre su Mac/Linux Terminale.
Ogni comando che andremo ad eseguire devono essere lanciati dalla cartella principale del progetto.
Inizializzazione del progetto
Adesso andiamo a inizializzare git nella cartella locale del progetto per poi associarlo ad un repository e quindi fare il trasferimento in remote dei file del progetto.
git init -b main
Questo mando crea la struttura git del progetto locale.
Attenzione: usare il file .gitignore per escludere i file contenenti dati sensibili o segreti (p.e. password, API keys, ecc.). In Laravel normalmente escludo: .env, le cartelle .vscode, vendor, storage ed i vari seeder dentro la cartella database se abbiamo dati che non devono essere messi in rete.
Viene anche creato il branch chiamato main.
Aggiungiamo quindi i file del progetto (locale) al repository per renderli pronti al commit
git add .
Aggiungiamo un commento ai file attualmente in stage (fase, stato dei file che devono essere gestiti. Non possono rimanere in questo limbo…)
git commit -m "First commit"
Adesso la guida ufficiale di Github ci dà 2 possibilità: usare l’applicazione per il terminale di github (gh) oppure il comando git sempre da terminale. Io seguo questa seconda opzione per motivi di praticità.
Eseguire il push
Fino a qui non siamo usciti dal nostro computer, tutti i comandi eseguiti hanno solo preparato il progetto ma non trasferito niente. Adesso per fare l’upload con tutte le informazioni corrette al fine di gestire le versioni, procediamo in questo modo.
Dò per scontato che si sia fatta l’autenticazione del nostro account sul computer locale (segui questa guida se non l’hai già fatto).
Creiamo il repository sul sito github.com e andiamo a copiare l’url del repository appena creato, ci serve per collegare il progetto locale al repository remoto con questo comando
git remote add origin https://github.com/nome-utente/nome-repository.git
Fai una veloce verifica con
git remote -v
Bene, adesso trasferiamo i file nel repository:
git push -u origin main
Questo ci ha permesso di creare il repository di produzione, quindi procediamo con la creazione del progetto di sviluppo e del relativo branch.
Creazione del progetto di sviluppo
La via più semplice è clonare il repository appena creato per poi fare le operazioni necessarie per creare il nuovo branch e associare questo nuovo progetto al ramo di sviluppo.
git clone url_repository
Questo crea una cartella con il nome del repository, ma noi abbiamo già la cartella del progetto di sviluppo, quindi sposta tutti i file contenuti nella cartella scaricata, in questa cartella. Naturalmente vanno spostate anche le cartelle e i file nascosti (in particolar modo la cartella .git).
Facciamo alcune verifiche
git branch -a
Ci mostra la situazione dei branch e ci indica a quale siamo agganciati.
git status
Ci dà indicazioni dettagliate sullo stato del progetto.
git switch -c dev
Con questo comando andiamo a creare il branch dev e ci spostiamo su questo.
Aggiungiamo i file locali sul branch appena creato
git add .
Bene a questo punto possiamo fare le modifiche al progetto di sviluppo che verranno registrate sul branch ad esso dedicato. Fatte queste modifiche committiamole e quindi eseguiamo il trasferimento sul repository
git commit -m "Primo commit su branch dev" git push
Se torni sul repository di github.com adesso vedrai il branch e le modifiche che hai apportato (nel branch dev).