Git è uno dei sistemi di controllo di versione più utilizzati per lo sviluppo del software. Creato da Linus Torvalds nel 2005, Git si concentra su velocità, integrità dei dati e supporto per flussi di lavoro distribuiti e non lineari. Con il suo uso diffuso anche per le grandi aziende, è importante imparare a configurare e utilizzare Git facilmente. Questa guida utilizzerà Git Bash per Windows e GitHub. Tuttavia, i comandi utilizzati qui funzioneranno su qualsiasi piattaforma. Questa non vuole essere la fine di tutte le guide, ma semplicemente per iniziare a usare Git. Ci sono molte più funzioni da esplorare in Git e un ambiente di lavoro potrebbe avere variabili molto diverse da quelle che devono essere usate con GitHub.
Passi
Parte 1 di 3: configurazione del tuo account
Passaggio 1. Configura un account Github
Visita GitHub e crea un account. Ai fini di questo tutorial, un account gratuito funzionerà perfettamente.
Passaggio 2. Installa Git Bash
Per iniziare devi prima scaricare e installare Git Bash per Windows. Vai avanti e fallo ora seguendo questo link: Git Bash.
Una volta installato, esegui Git Bash. Dovresti guardare una schermata del prompt dei comandi nera. Git Bash utilizza i comandi Unix per operare, quindi è importante avere una certa conoscenza di Unix
Passaggio 3. Crea una chiave SSH
Per stabilire una connessione crittografata sicura tra il tuo account GitHub e Git Bash sul tuo computer, devi generare e collegare una chiave SSH. In Git Bash, incolla questo codice ma sostituiscilo nell'e-mail che hai utilizzato con il tuo account GitHub: ssh-keygen -t rsa -b 4096 -C "[email protected]"
Ti verrà quindi chiesto dove vuoi salvare la chiave. La posizione predefinita sarà sufficiente, quindi premi Invio. Successivamente, Git Bash ti chiederà di inserire e confermare una passphrase. Sebbene non sia necessario includerne uno, è altamente raccomandato di farlo
Passaggio 4. Aggiungi la tua chiave SSH a ssh-agent
Questo autorizzerà il tuo computer a utilizzare quella chiave SSH. Immettere il seguente comando per avviare l'agente SSH: eval "$(ssh-agent -s)" Quindi immettere ssh-add ~/.ssh/id_rsa per aggiungere la chiave creata.
Se la tua chiave ha un nome diverso oltre a id_rsa o l'hai salvata in una posizione diversa, assicurati di utilizzare quello
Passaggio 5. Aggiungi la tua chiave SSH al tuo account
Ora dovrai configurare il tuo account per utilizzare la chiave appena creata. Copia la chiave ssh negli appunti: clip < ~/.ssh/id_rsa.pub. Quindi, nell'angolo in alto a destra di qualsiasi pagina GitHub, fai clic sulla foto del tuo profilo, quindi fai clic su Impostazioni. Nella barra laterale delle impostazioni utente, fai clic su Chiavi SSH e GPG. Quindi fare clic su Nuova chiave SSH. Ora puoi inserire un nome descrittivo per la tua chiave, quindi incollare la chiave nel campo chiave e premere "Aggiungi chiave SSH". Confermalo e sei a posto!
Parte 2 di 3: Impostazione di un progetto
Passaggio 1. Effettua il fork di un repository
Per apportare modifiche a un progetto in GitHub, è necessario eseguire un fork. Vai al repository su cui vuoi lavorare e fai un fork del repository premendo fork nella parte in alto a destra della pagina. Questo farà una copia di quel repository sul tuo account.
Passaggio 2. Creare una directory locale
Crea una cartella da qualche parte sul tuo computer in cui desideri ospitare il repository. Quindi usa Git Bash per navigare in quella cartella. Ricorda che Git Bash accetta i comandi UNIX, quindi per entrare nella tua directory, usa il comando CD in questo modo: $ cd /path/to/directory
Passaggio 3. Clonare la forcella
In GitHub, vai al tuo fork e sotto il nome del repository, fai clic su Clona o scarica e copia il collegamento che ti fornisce.
Successivamente, in Git Bash, inserisci il seguente comando utilizzando l'URL copiato: $ git clone https://github.com/YOUR-USERNAME/REPOSITORY_NAME. Premi Invio e il tuo clone locale verrà creato
Passaggio 4. Sincronizza la tua forcella con l'originale
Devi essere in grado di proporre modifiche al repository originale. Passa al repository originale che hai biforcato in GitHub, quindi premi Clona o scarica e copia l'URL.
- Ora vai nella cartella del repository effettiva in GitHub. Saprai di essere nel posto giusto quando vedrai un (master) a destra del prompt dei comandi.
- Ora esegui semplicemente $ git remote add upstream https://github.com/user/repositoryName utilizzando l'URL originale del repository.
Passaggio 5. Creare un utente
Successivamente dovresti creare un utente per tenere traccia di chi ha apportato le modifiche al repository. Eseguire i seguenti due comandi. $ git config utente.email "[email protected]" e $ git config nome utente. "Il tuo nome". Assicurati che l'e-mail che usi sia la stessa del tuo account git hub.
Passaggio 6. Creare un nuovo ramo
Quindi dovresti creare un nuovo ramo dal nostro ramo principale. Come un vero ramo di un albero. Questo ramo conterrà tutte le modifiche specifiche che apporterai. Dovresti creare una nuova diramazione dal master ogni volta che lavori su un nuovo problema. Che si tratti di una correzione di bug o dell'aggiunta di una nuova funzionalità, ogni attività deve avere il proprio ramo univoco.
- Per creare un ramo, esegui semplicemente: $ git branch feature_x. Sostituisci feature_x con un nome descrittivo della tua caratteristica.
- Una volta creato il tuo ramo, usa $ git checkout feature_x. Questo ti porterà nel ramo feature_x. Ora sei libero di apportare modifiche al tuo codice.
Parte 3 di 3: spingere i tuoi cambiamenti
Passaggio 1. Conferma le modifiche
Una volta che hai finito di apportare modifiche, o vuoi cambiare ramo e lavorare su qualcos'altro, le tue modifiche devono essere confermate. Esegui $ git commit --all. Questo effettuerà automaticamente il commit di tutte le modifiche apportate al repository.
Ti verrà chiesto di inserire un messaggio di commit usando vim. Questo messaggio dovrebbe essere breve e descrittivo. Usa i tasti freccia per navigare fino alla riga superiore, quindi premi i sulla tastiera. Ora puoi digitare il tuo messaggio. Una volta digitato, premi Esc e poi premi i due punti,:. Ora digita le lettere wq e premi Invio. Questo salverà il tuo messaggio di commit e uscirà dall'editor vim
Passaggio 2. Effettuare una richiesta push
Ora che le tue modifiche sono state confermate, dovresti inviarle! Inserisci $git push origin.
Passaggio 3. Unisciti al ramo principale
Torna su GitHub e presto dovresti vedere un messaggio pop-up con il tuo push. Premi "Confronta e estrai richiesta". In questa pagina avrai l'opportunità di rivedere le tue modifiche, così come cambiare il tuo messaggio di commit e aggiungere commenti. Una volta che tutto sembra in ordine e GitHub non rileva alcun conflitto, vai avanti e fai la richiesta. E questo è tutto!
Ora spetterà agli altri tuoi contributori e al proprietario del repository rivedere la tua modifica e quindi unirla con il repository principale
Passaggio 4. Ricorda sempre di recuperare e rebase
È estremamente importante lavorare sempre sull'ultima versione di un file. Prima di effettuare qualsiasi richiesta push, o hai appena avviato un nuovo ramo o sei passato a un ramo, esegui sempre il seguente comando git fetch upstream && git rebase upstream/master.
