GitLab è una delle piattaforme più utilizzate per il versionamento del codice, gestione dei repository Git e per il Continuous Integration/Continuous Delivery (CI/CD). In questa guida, ti mostrerò come installare GitLab Community Edition (CE) e GitLab Runner su un server Ubuntu.
Prima di iniziare, assicurati di avere:
- Un server Ubuntu con accesso root o un utente con privilegi sudo.
- Almeno 4GB di RAM per GitLab.
- Un nome di dominio o un indirizzo IP pubblico per l'accesso a GitLab.
Installazione di GitLab CE
È importante assicurarsi che il sistema sia aggiornato prima di procedere con l'installazione. Esegui i seguenti comandi:
sudo apt update
sudo apt dist-upgrade -y
GitLab richiede alcune dipendenze per funzionare correttamente. Installiamole:
sudo apt install -y curl ca-certificates tzdata perl
Aggiungiamo il repository ufficiale di GitLab utilizzando curl per scaricare il pacchetto e apt per installarlo:
curl -s https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
Dopo aver aggiunto il repository, possiamo procedere con l'installazione:
sudo apt install gitlab-ce
Una volta installato, dobbiamo configurare GitLab per il nostro dominio o IP. Modifica il file di configurazione principale:
sudo nano /etc/gitlab/gitlab.rb
Trova la riga external_url e impostala sul tuo dominio o IP:
external_url 'https://example.com'
Salva e chiudi il file. Poi, esegui il seguente comando per applicare la configurazione:
sudo gitlab-ctl reconfigure
Questo comando impiegherà alcuni minuti e configurerà automaticamente GitLab CE.
Una volta completata la configurazione, puoi accedere a GitLab visitando il dominio o l'IP configurato nel passaggio precedente tramite un browser. La prima volta che accedi, ti verrà chiesto di impostare una password per l'utente root.
Installazione di GitLab Runner
GitLab Runner è lo strumento che GitLab utilizza per eseguire i job CI/CD. Ora vedremo come installarlo.
Per prima cosa, aggiungi il repository GitLab Runner:
curl -s https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash
Installa GitLab Runner con il seguente comando:
sudo apt install gitlab-runner
Dopo l'installazione, dobbiamo registrare il Runner con il nostro progetto GitLab. Prima di tutto, accedi alla tua interfaccia GitLab, vai su "Settings" del tuo progetto e poi su "CI/CD" > "Runners". Troverai un token di registrazione. Usa quel token per registrare il Runner eseguendo:
sudo gitlab-runner register
Durante il processo di registrazione, ti verrà chiesto di fornire:
- URL di GitLab (es.
https://example.com) - Token di registrazione
- Descrizione del Runner (puoi dare un nome qualsiasi)
- Tag del Runner (puoi lasciare vuoto se non sei sicuro)
- Esecutore (scegli
shellper un'installazione base)
Una volta registrato, avvia e abilita GitLab Runner per avviarsi automaticamente all'avvio del sistema:
sudo gitlab-runner start
sudo systemctl enable gitlab-runner
Conclusione
Abbiamo visto come installare e configurare GitLab CE e GitLab Runner su Ubuntu Server. Con GitLab CE, puoi gestire i tuoi repository e implementare pipeline CI/CD efficienti grazie a GitLab Runner. Puoi ora iniziare a lavorare sui tuoi progetti con uno strumento potente e versatile come GitLab.