Installare GitLab CE e GitLab Runner su Ubuntu Server

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 shell per 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.

Torna su