L’implementazione del controllo di versione sarebbe un’impresa semplice se si lavorasse solo come sviluppatori privati con un repo locale. Tuttavia, questo non è il caso di molti progetti professionali. Al contrario, un team di solito riunisce le risorse in un repo remoto utilizzando host come GitHub. Per questo motivo, è importante imparare a fare il push su GitHub, giacché si tratta di un’operazione che entrerà necessariamente a far parte del vostro flusso di lavoro.
In questo articolo vi mostreremo come eseguire il push su GitHub utilizzando la riga di comando. Inoltre, esamineremo le applicazioni dedicate che vi aiuteranno a rendere più fluido il processo. Alla fine dell’articolo, parleremo del perché le richieste di pull dovrebbero essere un’attività da imparare e del loro rapporto con il push del codice. Per prima cosa, però, vediamo come utilizzare GitHub per i vostri progetti.
Come uno sviluppatore o un programmatore usa GitHub
GitHub è uno strumento essenziale per gli sviluppatori e i programmatori di tutto il mondo per una serie di motivi. Permette di archiviare il codice in una posizione centralizzata, che lo rende facilmente accessibile e offre una maggiore collaborazione con altri sviluppatori.
Rende anche possibile tenere traccia delle modifiche apportate al proprio codice e, se necessario, tornare alle versioni precedenti. Inoltre, GitHub fornisce strumenti per la gestione di problemi e bug, rendendo più semplice la manutenzione della base di codice.
La funzionalità di collaborazione è uno dei motivi principali per cui potreste utilizzare GitHub come sistema di controllo di versione (VCS) remoto. Permette di condividere il codice, tracciare le modifiche e collaborare ai problemi senza troppe complicazioni. Questo può aiutare l’efficienza e può anche portare a una migliore qualità del codice.
GitHub offre anche un modo semplice per gestire più versioni di una base di codice, tracciare le modifiche e ripristinarle se necessario. I grandi progetti e le collaborazioni open-source sono solo due dei modi in cui GitHub dimostrerà il suo valore.
Anche nei casi d’uso più semplici può essere la scelta ideale. Ad esempio, potete archiviare il codice del vostro progetto di sviluppo web e inviare aggiornamenti remoti quando apportate modifiche. Inoltre, i progetti di integrazione continua/distribuzione continua (CI/CD) beneficeranno dell’automazione sotto forma di Azioni GitHub durante le fasi di creazione.
Nel complesso, GitHub – insieme ad altri host VCS remoti come GitLab – fornisce una piattaforma per la collaborazione, il controllo delle versioni e altri flussi di lavoro di sviluppo. Può aiutare a snellire il processo di sviluppo e a migliorare la qualità del codice. Per questo motivo, è bene imparare a fare il push su GitHub, perché questa conoscenza vi sarà utile quasi ogni giorno.
Come eseguire il push su GitHub dal terminale (riga di comando)
Il resto di questo articolo mostrerà come effettuare il push su GitHub. Si tratta di un processo semplice da capire e da eseguire.
Tuttavia, assicuratevi di aver ben impostato il progetto in anticipo, altrimenti incontrerete degli errori. Nella prima sezione vedremo quali sono gli strumenti e le competenze di cui avrete bisogno, per poi analizzare nel dettaglio il processo.
Cosa serve per fare il push su GitHub
È importante assicurarsi di aver impostato il proprio progetto in modo da supportare l’utilizzo di un repo remoto e integrare il push nel flusso di lavoro. Per questo motivo, prima di tutto, avete bisogno di un repository Git – un “repo” in cui salvare il codice. Si tratta di una cartella che contiene i file associati al progetto.
L’intero processo di controllo delle versioni inizia in un ambiente locale sul proprio computer. In seguito vi illustreremo i passaggi esatti per farlo, ma forse avete già queste conoscenze (o sapete come accedervi).
Avrete anche bisogno di un account GitHub. In realtà, potete anche utilizzare un altro host VCS online, come GitLab, BitBucket, Buddy e altri ancora. Le istruzioni che forniamo qui saranno trasferibili, per la maggior parte, ad altre piattaforme. Il confronto tra questi host va però oltre lo scopo dell’articolo.
Per inviare il codice a GitHub, potete utilizzare la riga di comando o un’interfaccia grafica (GUI). La maggior parte del nostro post riguarderà il flusso di lavoro da riga di comando, ma ci sarà anche una sezione dedicata all’utilizzo di una GUI, dato che alcune sono molto diffuse. Tuttavia, tenete presente che ogni GUI può avere un processo diverso per l’invio a GitHub, il che significa che dovrete attenervi a un’applicazione in particolare per sfruttarla al meglio.
Infine, assicuratevi di avere il giusto accesso al repo. La documentazione di GitHub è molto esaustiva e dovete cercare di ottenere i token di accesso HTTPS o l’accesso Secure Shell (SSH). Senza questo, non potrete fare nulla!
1. Creare un repository GitHub
Il primo punto consiste nel creare un nuovo repo online su GitHub. Sebbene sia possibile farlo dalla riga di comando, è altrettanto semplice farlo utilizzando un browser web.
Una volta effettuato il login o l’iscrizione a GitHub, andate nell’angolo in alto a destra dello schermo e cercate un menu a tendina Plus accanto all’avatar del profilo. Se lo aprite, vi verranno mostrate alcune opzioni tra cui New repository:
Una volta cliccato su questa opzione, si aprirà la pagina Create a New Repository. Questa pagina vi mostrerà una serie di impostazioni che vi aiuteranno a configurare il vostro repository remoto:
Le opzioni che imposterete qui saranno specifiche per le esigenze del progetto. Se avete già un repository locale da inviare a GitHub, spuntate meno caselle possibili per mantenere la parità tra locale e remoto.
Cliccate quindi sul pulsante Create repository e GitHub si occuperà di configurare il tutto. A questo punto, si arriva alla pagina iniziale del repository con le istruzioni su come impostare un nuovo repository locale che si colleghi a quello remoto tramite la riga di comando. Il percorso da seguire dipende dal fatto che non abbiate ancora un repo o che vogliate clonare il contenuto di un progetto esistente.
Se avete già inizializzato Git e popolato il repo locale, non dovrete fare nulla al punto 2. Potrete invece passare direttamente al terzo punto, in cui vedremo come effettuare il push del codice su GitHub dal repo locale.
2a. Clonare il repo Git remoto
Se non avete ancora un repo locale, la versione di GitHub sarà l’unica. Il modo migliore per sincronizzare entrambe le posizioni è utilizzare il comando git clone sul vostro computer. Tuttavia, avete bisogno dell’URL del repo.
Per ottenerlo, andate al repo su GitHub e cercate l’opzione verde Code sopra l’elenco dei file:
Se non la vedete, è probabile che non abbiate ancora un repo popolato. Potete copiare l’URL del repo dal riquadro blu di configurazione rapida nella parte superiore dello schermo. Basta passare all’HTTPS utilizzando i pulsanti e copiare l’URL.
Vi consigliamo di generare un file .gitignore, in quanto sarà comunque necessario. Potete utilizzare gitignore.io per cercare gli strumenti che utilizzate e, da lì, generare un file .gitignore completo da caricare sul repo:
In ogni caso, una volta aperto il menu a tendina del Code, verranno mostrati gli URL per il repo. Ci saranno opzioni per HTTPS, Secure Shell (SSH) e altre. L’approccio più semplice è quello di utilizzare l’URL HTTPS. Potete cliccare sull’icona Copy accanto all’URL in questione per copiarlo negli appunti.
Successivamente, tornate al terminale o all’applicazione a riga di comando ed eseguite il comando:
git clone <full-github-url>Una volta eseguito il comando, Git copierà il repo remoto nel vostro ambiente locale.
2b. Inizializzare Git nella cartella del progetto locale
Nelle situazioni in cui non avete ancora una versione locale del repo remoto, dovrete inizializzarne una. La maggior parte del lavoro che farete sarà locale, con il push delle modifiche al server remoto a intervalli regolari. Ecco i passaggi da seguire:
- Per prima cosa,
cda una cartella che desiderate utilizzare per il vostro progetto. - Quindi, eseguite il comando
git init. Questo inizializzerà Git nella cartella locale del progetto e creerà una directory .git nascosta. - Aggiungete il file .gitignore alla root della cartella locale del progetto, poiché non vorrete rendere visibili alcune modifiche relative ai file di sistema.
A questo punto, dovete indicizzare i vostri file attuali. Fatelo nel modo tipico utilizzando git add, quindi eseguite il commit delle modifiche:
git add .
git commit -m “Initial Commit”
git branch -M trunk
L’ultima riga cambia il vostro branch principale in un altro a vostra scelta se non avete fatto ancora il cambio da master. Quest’ultimo è un termine problematico, perché ha una connotazione negativa legata alla schiavitù, quindi è consigliabile cambiarlo. In questo caso abbiamo utilizzato trunk, ma anche main è accettabile. Se pensate che questa riga non sia necessaria, potete ometterla.
A questo punto siete pronti per imparare a fare il push su GitHub!
3. Aggiungere una nuova origine remota e inviare il codice a GitHub
Una volta creato un nuovo repository remoto su GitHub, dovrete aggiungere una nuova “remote origin” (origine remota) al vostro repository locale. Questo è essenzialmente il link al vostro repository remoto, grazie al quale quello locale saprà dove inviare le modifiche upstream.
Per farlo, inserite il seguente comando nel terminale:
git remote add origin <github-url>
In senso tecnico, il repo aggiunto può avere qualsiasi nome. Tuttavia, la maggior parte di noi lo chiama “origin”, in quanto si utilizza un solo nome per l’aggiunta del remoto e questo offre una chiarezza assoluta. A questo punto, potete effettuare il push su GitHub utilizzando il seguente comando:
git push -u origin trunk
Questo comando invia il codice alla nuova origine remota, denominata “origin”, e imposta il branch upstream su “trunk”. Potete anche effetuare il push di qualsiasi branch al repo remoto se ne avete bisogno.
Una volta completato il processo, dovrete verificare che il push sia andato a buon fine. Ci sono un paio di modi per farlo. Ad esempio, potete visitare il repo su GitHub e verificare che le modifiche siano attive:
Potete anche eseguire git log dalla riga di comando:
Questo comando visualizza tutti i commit del repo, compreso quello di cui avete appena eseguito il push. Se il commit è presente nel log, il push ha avuto successo.
Come effettuare il push su GitHub senza errori
In alcuni casi, potreste riscontrare un errore quando tentate di eseguire il push del codice su GitHub:
Questo accade quando si dispone già di una connessione sicura a GitHub attraverso un vecchio progetto che utilizza una vecchia chiave RSA. Abbiamo una guida su come risolvere questo problema in generale. Per risolvere il problema in modo specifico per GitHub, potete seguire questa procedura:
ssh-keygen -R github.com
Questo aggiornerà il file “host conosciuti” e visualizzerà un messaggio di conferma:
Da qui, eseguite quanto segue per aggiungere la nuova chiave RSA al vostro file di host conosciuti:
curl -L https://api.github.com/meta | jq -r '.ssh_keys | .[]' | sed -e 's/^/github.com /' >> ~/.ssh/known_hosts
In effetti, anche in questo caso potreste vedere un errore relativo al pacchetto jq. In questo caso, potete eseguire una delle operazioni qui sotto, a seconda del sistema operativo:
- Windows:
curl -L -o /usr/bin/jq.exe https://github.com/stedolan/jq/releases/latest/download/jq-win64.exe - Mac:
brew install jq - Linux:
apt-get update | apt-get -y install jq
Una volta installato, eseguite nuovamente il comando e attendete che venga completato:
Infine, eseguite nuovamente il comando git push e questa volta dovreste vedere il processo completato. In caso contrario, è probabile che il problema sia dovuto a chiavi SSH errate o che sia necessario impostare connessioni sicure utilizzando chiavi dedicate. Abbiamo una guida completa su come generare nuove chiavi SSH per GitHub e la documentazione di GitHub è completa anche qui.
Utilizzare un’interfaccia grafica per inviare il codice a GitHub
Sebbene il processo di invio del codice a GitHub sia semplice una volta impostato, ci sono molti passaggi, avvertenze e sottoprocessi da considerare. Una GUI può semplificare questo processo.
Ad esempio, avrete a disposizione tutte le funzionalità della riga di comando ma con un’interfaccia più gradevole (in alcuni casi con il drag-and-drop). Inoltre, spesso è più facile visualizzare e gestire le modifiche attraverso una GUI, soprattutto se non avete familiarità con gli strumenti della riga di comando.
Se sapete già che non avrete mai bisogno di usare un’app GUI per accedere a un altro host VCS remoto, GitHub Desktop potrebbe fare al caso vostro.
L’applicazione permette di creare e gestire i repository, fare il commit delle modifiche e inviarle a GitHub con pochi clic. Dispone della funzionalità drag-and-drop e anche di uno strumento “visual diff” che semplifica l’identificazione delle modifiche al codice tra le varie versioni:
Sourcetree è un’altra popolare interfaccia grafica di Git che abbiamo analizzato nella nostra carrellata di strumenti per lo sviluppo web. Anche se il VCS preferito è BitBucket (perché è un prodotto Atlassian), potete comunque utilizzare questo strumento con GitHub. Lo strumento per la risoluzione dei conflitti di fusione è molto utile ed è una delle sue caratteristiche principali.
GitKraken è probabilmente l’applicazione con la migliore interfaccia grafica disponibile e offre una versione gratuita per i repository locali e pubblici. Supporta tutti i principali host VCS: GitHub, ovviamente, ma anche GitLab e BitBucket, tra gli altri. Ci piace molto la sua rappresentazione visiva dei repo e la soluzione offre anche funzionalità utili per i team.
Usare GitHub Desktop per fare push su GitHub
Anche se la procedura per ogni applicazione sarà leggermente diversa, GitHub Desktop è semplice da usare. Si lavora in un’unica schermata che utilizza varie finestre e pannelli. Una volta apportata una modifica a un file (che potete aprire all’interno dell’editor che preferite grazie al menu contestuale del tasto destro del mouse), eseguite il commit utilizzando un piccolo widget sullo schermo:
Questo commit diventerà parte della sezione Push Origin nella barra degli strumenti superiore. Se non avete modifiche da eseguire, verrà visualizzata una notifica per effettuare il push all’origine remota:
Si tratta di una soluzione che consente di apportare modifiche al vostro repo GitHub con un solo clic. L’intero flusso di lavoro è rapido, indolore e semplice da eseguire.
Usare l’Hosting di Applicazioni di Kinsta e GitHub
Se siete clienti Kinsta, potete portare tutte le vostre applicazioni da noi. Il nostro Hosting di Applicazioni e Database permette di distribuire quasi tutte le applicazioni utilizzando diversi linguaggi, come PHP, Node, Python e altri ancora. Potrete connettervi a GitHub senza dover utilizzare una serie di comandi Git.
Per iniziare, accedete alla dashboard di Kinsta e andate alla schermata Applicazioni. Al primo accesso avrà un aspetto scarno:
Tuttavia, se cliccate sul pulsante Aggiungi servizio, avrete la possibilità di distribuire un’applicazione o un database. Per questo esempio, sceglieremo l’applicazione:
Kinsta vi chiederà di connettervi a GitHub per importare i repository dalla piattaforma:
La procedura guidata che segue vi aiuterà a configurare la vostra applicazione. Per prima cosa dovete scegliere un repository da GitHub, quindi selezionare il branch predefinito:
Dovete anche dare un nome all’applicazione all’interno di MyKinsta e selezionare un data center. Una volta cliccato su Continua, dovrete modificare le impostazioni dell’ambiente di build:
Qui avete a disposizione un paio di opzioni:
- Scegliere una build machine dall’elenco.
- Impostare l’immagine di un container, utilizzando l’automazione o un percorso specifico.
A questo punto, dovete impostare le risorse e i processi. I nostri esempi di avvio rapido includono i processi web di cui avrete bisogno, ma potete anche crearne di vostri. Tenete presente che potete avere tutti i processi che il vostro budget consente:
Una volta visualizzati i costi di utilizzo mensili, potete effettuare il pagamento. A questo punto, siete pronti per utilizzare l’Hosting di Applicazioni completo di integrazione con GitHub. C’è molto altro da scoprire sull’Hosting di Applicazioni e Database e la nostra documentazione è completa e approfondita.
Riepilogo
GitHub è uno strumento essenziale per sviluppatori e programmatori. Offre un repository centralizzato per archiviare, monitorare e collaborare sul codice. Una volta appreso come effettuare il push del vostro codice su GitHub da un repo locale, potrete partecipare a questa collaborazione.
Usando la riga di comando, è semplice inviare il codice a GitHub e vi serviranno solo una manciata di comandi una volta configurato il tutto. Tuttavia, potreste prendere in considerazione l’idea di usare un’applicazione GUI dedicata, come GitKraken o GitHub Desktop. Queste applicazioni possono eliminare la riga di comando dall’equazione e permettervi di eseguire quasi tutte le operazioni necessarie con Git da un’interfaccia familiare.
Inoltre, GitHub è fantastico in combinazione con l’Hosting di Applicazioni e Database di alto livello di Kinsta. Questi vi permetteno di collegare il vostro repo GitHub alla nostra rete di 25 data center e di supportare una moltitudine di framework diversi. Anche il prezzo basato sulle risorse è competitivo e alla portata di tutti!
Avete qualche domanda su come effettuare il push su GitHub? Chiedeteci tutto nella sezione commenti qui sotto!
Lascia un commento