Con la recente acquisizione di GitHub da parte di Microsoft, molte aziende e organizzazioni hanno deciso di allontanarsi da GitHub e spostarsi verso alternative. GitLab offre molto di più dei repository remoti e del controllo del codice sorgente. Mentre GitLab si presenta come un servizio a pagamento con diversi livelli di supporto e opzioni di hosting, ha anche una Community Edition (CE) che è gratuita per chiunque possa essere utilizzata installando sulle proprie configurazioni del server.

Con GitLab, puoi pianificare i tuoi progetti e implementare metodologie come Agile per i membri del tuo team. Tieni traccia dei problemi e del ciclo di sviluppo. Implementare una pipeline CD/CI, mantenere i registri dei container e automatizzare la containerizzazione delle versioni appena spedite. Puoi anche scrivere documentazione e mantenere wiki privati, monitorare l'ambiente e l'utilizzo delle risorse del software in varie fasi come il test o la produzione.

Prerequisiti

In base ai requisiti minimi di GitLab Community è necessario:

1 vCPU ma 2 è consigliato per prestazioni ottimali
Almeno 4 GB di RAM con 4 GB di spazio di swap
Accesso root o privilegi sudo sul server

Se stai sperimentando sulla tua rete locale (diciamo a casa tua), non hai bisogno di un IP pubblico o di un nome di dominio completo (FQDN), ma per casi d'uso reali ti consigliamo vivamente di avere:

Un IP pubblico statico al server in cui installare GitLab
Un FQDN che punta a quell'IP

Più di ogni altra cosa, un FQDN ti aiuterà a integrare GitLab con LetsEncrypt, che è abbastanza essenziale dal punto di vista della sicurezza e della privacy.

Parleremo dell'integrazione di LetsEncrypt, ma per la maggior parte la demo viene eseguita su una rete locale con GitLab in esecuzione dietro un NAT con un IP privato. Infine, vogliamo che il nostro server esegua un'installazione pulita Ubuntu 18.04 server LTS in modo da emulare accuratamente lo scenario del mondo reale.

Installazione di dipendenze e aggiunta di repository

Il primo passo che dovremmo eseguire è il consueto aggiornamento e upgrade del sistema:

$ sudo apt update
$ sudo apt upgrade -y

Quindi dobbiamo verificare che i seguenti pacchetti - certificati-ca, proprietà-software-comuni e openssh-server sono installati. È probabile che tu abbia già effettuato l'accesso utilizzando OpenSSH e gli altri pacchetti escano dalla confezione con Ubuntu 18.04. Tuttavia, è una buona idea essere scrupolosi.

$ sudo apt install ca-certificates openssh-server software-properties-common

Una dipendenza importante che potrebbe richiedere assistenza durante l'installazione è Postfix, un agente di trasferimento della posta. GitLab ne ha bisogno per comunicare con gli utenti via email.

$ sudo apt install postfix

Qui ti verrà chiesto di selezionare che tipo di installazione è, Seleziona Sito internet, e poi assicurati che il FQDN.

Successivamente ci viene richiesto di aggiungere un nome di dominio, nel caso in cui utilizzi un IP pubblico o privato, puoi semplicemente aggiungere anche quell'indirizzo IP. Ho impostato un DNS locale e GitLab viene installato su ubuntu.Locale. Se stai usando un FQDN, come gitlab.esempio.come per la tua istanza GitLab, usa quel nome di dominio qui.

Ora siamo pronti per aggiungere GitLab al nostro elenco di repository che verrebbero poi installati.

$ curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

Questo script installerà alcune dipendenze aggiuntive, aggiungerà chiavi gpg per i repository ufficiali e aggiungerà il repository all'elenco delle fonti. Preparare il nostro sistema per la fase finale dell'installazione.

Installazione e configurazione di GitLab

L'installazione di GitLab ora è facile come eseguire:

$ sudo apt install gitlab-ce

Questo potrebbe richiedere del tempo, perché il pacchetto stesso è enorme (circa 470 MB al momento della stesura di questo articolo) e il download e l'estrazione potrebbe richiedere del tempo. Fatto ciò, siamo pronti per configurare GitLab.

Apri il file /etc/gitlab.rb usando il tuo editor di testo preferito (usando sudo privilegi) e modificare la riga che dice URL_esterno come mostrato di seguito:

Se lo stai installando sul servizio di hosting pubblico, con un FQDN, puoi aggiungerlo come valore. Inoltre puoi usare https, invece di http. Quindi se il tuo nome di dominio è gitlab.esempio.come sarà inserito come:

Ma useremo http, poiché è un'installazione locale.

Integrazione LetsEncrypt (HTTPS)

Questo passaggio è applicabile solo alle persone che utilizzano un FQDN e hanno impostato URL_esterno usare https, nel passaggio precedente.

Nello stesso file /etc/gitlab/gitlab.rb, cerca la sezione che riguarda LetsEncrypt (cerca "Let's Encrypt Integration") e abilita Let's Encrypt, insieme ad esso aggiungi il tuo account email corrente, nel caso in cui LetsEncrypt voglia avvisarti di rinnovi di certificati non pianificati.

Le due righe che sono state modificate qui sono:

#letsencrypt['enable'] = true
#letsencrypt['contact_emails'] = ['[email protected]']

Ora puoi salvare il file e avviare l'applicazione GitLab con la configurazione modificata.

$ sudo gitlab-ctl reconfigure

questo è tutto! La tua istanza GitLab è attiva e funzionante. Usa il tuo browser per visitare il pannello di controllo su http://IP_ADDRESS o https://gitlab.esempio.com nel caso tu abbia usato FQDN con SSL.

Configurazione iniziale

Dopo aver visitato il sito Web sul tuo browser, ti verrà prima chiesto di impostare una password per il "radice" utente

Imposta una password e poi accedi come utente “radice"usando lo stesso. Da qui inizia il tuo viaggio gratuito su GitHub. Prendi il controllo dei tuoi progetti, aggiungi i membri del tuo team e torna ad essere produttivo!

Conclusione

Mentre io, personalmente, penso che Microsoft sia stato un buon amministratore della comunità open source negli ultimi anni, è comunque bello sapere che ci sono opzioni come GitLab per gli utenti che vogliono qualcos'altro. I monopoli non fanno mai bene alla comunità. Su questa nota, torneremo sull'argomento di GitLab e vedremo come impostare un registro contenitori in un follow-up. Resta sintonizzato per questo!