Configurare GitLab su un server Linux – Ospita la tua piattaforma DevOps

Scopri come installare GitLab su Linux in modo efficiente per ottimizzare i flussi di lavoro DevOps e migliorare la collaborazione del team → Scopri di più ora

10 novembre 20266 min di lettura0 Visualizzazioni0 utile

Introduzione

GitLab è una piattaforma DevOps completa che consente ai team di collaborare sul codice, automatizzare i flussi di lavoro e gestire in modo efficiente l'intero ciclo di sviluppo software. In questa guida spieghiamo come installare GitLab su un server Linux.

Installare GitLab con le App One-Click

Puoi installare GitLab direttamente tramite le App One-Click nell'interfaccia web del VPS. Dopo la prima configurazione delle app, apri il catalogo app, cerca GitLab e avvia il deployment con le impostazioni preferite per progetto, ambiente e dominio. In questo modo puoi distribuire e gestire GitLab rapidamente e in modo user-friendly, senza configurazioni manuali da riga di comando, beneficiando comunque di una gestione web integrata, supporto per domini personalizzati e rilascio SSL dove disponibile.

Preparazione

I seguenti requisiti sono raccomandati dal team ufficiale di GitLab. È fortemente consigliato rispettarli per evitare problemi e inconvenienti futuri.

Hardware

Componenti	Minimo	Consigliato
CPU	2x 2 GHz	4x 2,6+ GHz
RAM	4 GB	8 GB
Spazio disco	10 GB	50+ GB
Banda	100 Mbit/s (Up & Down)	100 Mbit/s (Up & Down)

Software

Piattaforma	Opzioni
Sistema operativo	Ubuntu (20.04, 22.04, 24.04), Debian (10, 11, 12), OpenSUSE (15.5)
Database	PostgreSQL 14.9+
Webserver	NGINX (incluso con GitLab), Puma 6.4.2+
Altro	Redis 7.x+, Sidekiq 7.3.2+, Prometheus 2.54.1+

Info

Per le specifiche più aggiornate e dettagliate consulta la documentazione ufficiale Hardware Requirements di GitLab.

Per installare GitLab sul tuo server Linux devi connetterti tramite client SSH. Consulta la nostra guida Primo accesso (SSH).

Una volta stabilita la connessione, puoi installare i pacchetti necessari per GitLab.

Passo 1: Installare le dipendenze

Per prima cosa devi installare alcune dipendenze affinché l'installer di GitLab funzioni. Usa i seguenti comandi per installare i pacchetti necessari sul tuo server Linux.

Aggiorna la lista dei pacchetti e installa OpenSSH Server e i prerequisiti con questo comando. Così ospiterai l'interfaccia web di GitLab.

Code

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates tzdata perl

Opzionalmente puoi installare Postfix (server SMTP) se vuoi inviare notifiche email tramite GitLab.

Se vuoi usare le notifiche email, installa Postfix con:

Code

sudo apt-get install -y postfix

Aggiorna la lista pacchetti e installa OpenSSH Server e prerequisiti con:

Code

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates perl

Opzionalmente installa Postfix per notifiche email:

Code

sudo apt-get install -y postfix

Su OpenSUSE installa con:

Code

sudo zypper install curl openssh perl

Assicurati che il demone OpenSSH sia attivo:

Code

sudo systemctl status sshd
sudo systemctl enable sshd
sudo systemctl start sshd

Se usi firewalld, assicurati che le porte necessarie siano aperte.

Controlla se firewalld è attivo con:

bash

sudo systemctl status firewalld

Se sì, apri le porte standard (80 e 443):

Code

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld

Per le notifiche email, installa Postfix e avvialo:

Code

sudo zypper install postfix
sudo systemctl enable postfix
sudo systemctl start postfix

Info

Durante l'installazione di Postfix potrebbe apparire una configurazione. Seleziona "Internet Site" e conferma con Invio. Inserisci come "mail name" il DNS esterno del tuo server Linux e conferma. Se compaiono altre schermate, conferma con Invio per accettare i valori predefiniti. Se preferisci un'altra soluzione per l'invio email, salta questo passo e configura un server SMTP esterno dopo l'installazione di GitLab seguendo la guida ufficiale.

Passo 2: Installare GitLab

Dopo aver installato tutte le dipendenze, puoi procedere con l'installazione di GitLab.

In questa guida installeremo GitLab direttamente dai repository ufficiali.

Questo script aggiunge i repository GitLab al gestore pacchetti apt:

Code

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

Poi puoi installare il pacchetto gitlab-ee:

bash

sudo apt-get install -y gitlab-ee

Per Zypper (OpenSUSE) aggiungi i repository con:

Code

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash

E installa gitlab-ee:

bash

sudo zypper install gitlab-ee

Al termine GitLab dovrebbe essere pronto sul tuo server Linux. Nel prossimo passo configurerai le impostazioni essenziali per un funzionamento ottimale.

Passo 3: Configurare GitLab

Per far funzionare tutto devi modificare alcune impostazioni nel file di configurazione. Apri il file di configurazione di GitLab con l'editor di testo che preferisci. Qui usiamo nano come esempio.

Code

sudo nano /etc/gitlab/gitlab.rb

Cerca la riga external_url e inserisci il tuo dominio o l'indirizzo IP del server Linux se non vuoi usare un dominio.

Code

## URL di GitLab
##! URL dove GitLab sarà raggiungibile.
##! Per maggiori dettagli sulla configurazione di external_url vedi:
##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab
##!
##! Nota: Durante installazioni/aggiornamenti la variabile d'ambiente
##! EXTERNAL_URL viene usata per impostare/sovrascrivere questo valore.
##! Su istanze AWS EC2 si tenta di recuperare il nome host/IP pubblico da AWS.
##! Maggiori info:
##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html
external_url 'http`s`://`tuo dominio o indirizzo IPv4 del server Linux`'

Consigliamo inoltre di inserire la tua email nella riga letsencrypt['contact_emails'] per permettere a Let's Encrypt di contattarti riguardo ai certificati SSL gratuiti e automatici.

Info

Per ottenere un certificato SSL gratuito da Let's Encrypt è necessario un dominio. Non è possibile richiedere un certificato per un indirizzo IP.

Code

################################################################################
# Integrazione Let's Encrypt
################################################################################
# letsencrypt['enable'] = nil
# letsencrypt['contact_emails'] = [`tua email qui`] # Deve essere un array di indirizzi email
# letsencrypt['group'] = 'root'
# letsencrypt['key_size'] = 2048
# letsencrypt['owner'] = 'root'
# letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www'
# Vedi https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically per maggiori info
# letsencrypt['auto_renew'] = true
# letsencrypt['auto_renew_hour'] = 0
# letsencrypt['auto_renew_minute'] = nil # Deve essere un numero o espressione Cron se specificato.
# letsencrypt['auto_renew_day_of_month'] = "*/4"
# letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt'
# letsencrypt['alt_names'] = []

Suggerimento

Premi CTRL+W per cercare letsencrypt['contact_emails'] e poi Invio per non dover scorrere manualmente tutto il file.

Quando hai finito, premi CTRL+X, poi Y e Invio per salvare le modifiche.

Infine esegui questo comando per riconfigurare GitLab con le nuove impostazioni:

Code

sudo gitlab-ctl reconfigure

Questa operazione può richiedere tempo perché GitLab si inizializza con i dati aggiornati. Se hai usato un dominio, i certificati SSL saranno emessi automaticamente.

Passo 4: Accesso all'interfaccia web

Dopo l'inizializzazione il server dovrebbe essere raggiungibile via browser. Visita il sito inserendo il tuo dominio o indirizzo IP:

Code

https://[tuo_dominio] OPPURE http://[tuo_indirizzo_ip]

Alla prima visita apparirà la pagina di login.

Per il primo accesso usa l'utente root.

La password si trova in un file sul server Linux. Apri il file con questo comando e cerca il campo Password:

Code

sudo nano /etc/gitlab/initial_root_password

Code

# ATTENZIONE: Questo valore è valido solo se

# 1. È stato impostato manualmente (tramite variabile d'ambiente `GITLAB_ROOT_PASSWORD` o impostazione `gitlab_rails['initial_root_password']` in `gitlab.rb` prima del primo popolamento del database).

# 2. La password non è stata cambiata manualmente né via UI né da riga di comando.

#

# Se la password mostrata qui non funziona, devi resettare la password admin: https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.

Password: `[LA_TUA_PASSWORD_QUI]`

# NOTA: Questo file viene cancellato automaticamente dopo 24 ore dal primo reconfigure.

Inserisci username e password nella pagina di login per accedere al dashboard GitLab per la prima volta. Ora hai accesso al tuo pannello GitLab sul tuo server Linux.

Consigliamo vivamente di creare un nuovo utente e/o cambiare la password dell'utente root. Puoi farlo da Admin in basso a sinistra, poi Panoramica -> Utenti. Qui puoi gestire tutti gli utenti della tua istanza GitLab.

Opzionale: Configurare il firewall con ufw

Puoi saltare questo passo se non vuoi configurare un firewall o se usi già firewalld su OpenSUSE. Assicurati che le porte 80/443 e 22 siano aperte.

Installare ufw

Se ufw è già installato, salta questo passo.

bash

sudo apt-get install -y ufw

bash

sudo zypper install ufw

Aprire le porte necessarie

Code

sudo ufw allow http
sudo ufw allow https
sudo ufw allow OpenSSH

Attivare il firewall

Attenzione

Di default ufw blocca tutte le porte tranne quelle consentite. Assicurati che la whitelist sia corretta prima di eseguire questo comando.

Attiva il firewall con:

Code

sudo ufw enable

Conclusione

Congratulazioni, hai installato GitLab con successo! Se hai domande o problemi, il nostro team di supporto è disponibile ogni giorno per aiutarti.

Se vuoi fare altre configurazioni, ti consigliamo di leggere la documentazione ufficiale GitLab per i prossimi passi.

FAQ

Domande frequenti

Puoi installare GitLab direttamente tramite le App One-Click nell'interfaccia web, cercando GitLab nel catalogo app e avviando il deployment con le impostazioni preferite per progetto, ambiente e dominio.

Minimo: CPU 2x 2 GHz, 4 GB RAM, 10 GB spazio disco e banda 100 Mbit/s. Consigliato: CPU 4x 2,6+ GHz, 8 GB RAM e 50+ GB spazio disco.

GitLab è una piattaforma DevOps completa che permette ai team di collaborare sul codice, automatizzare i flussi di lavoro e gestire l'intero ciclo di sviluppo software in modo efficiente.

Feedback

Questo articolo ti è stato utile?

Il tuo feedback ci aiuta a definire le priorità e a migliorare i contenuti.

0 di 0 I feedback hanno giudicato utile questo articolo.

Assistenza personale

Le istruzioni non sono sufficienti?

Il supporto ZAP conosce il tuo prodotto: descrivi brevemente la tua richiesta e ti aiuteremo personalmente.

## URL di GitLab ##! URL dove GitLab sarà raggiungibile. ##! Per maggiori dettagli sulla configurazione di external_url vedi: ##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab ##! ##! Nota: Durante installazioni/aggiornamenti la variabile d'ambiente ##! EXTERNAL_URL viene usata per impostare/sovrascrivere questo valore. ##! Su istanze AWS EC2 si tenta di recuperare il nome host/IP pubblico da AWS. ##! Maggiori info: ##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html external_url 'http`s`://`tuo dominio o indirizzo IPv4 del server Linux`'

################################################################################ # Integrazione Let's Encrypt ################################################################################ # letsencrypt['enable'] = nil # letsencrypt['contact_emails'] = [`tua email qui`] # Deve essere un array di indirizzi email # letsencrypt['group'] = 'root' # letsencrypt['key_size'] = 2048 # letsencrypt['owner'] = 'root' # letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www' # Vedi https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically per maggiori info # letsencrypt['auto_renew'] = true # letsencrypt['auto_renew_hour'] = 0 # letsencrypt['auto_renew_minute'] = nil # Deve essere un numero o espressione Cron se specificato. # letsencrypt['auto_renew_day_of_month'] = "*/4" # letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt' # letsencrypt['alt_names'] = []

Quali 🍪 cookie desideri consentire?

Configurare GitLab su un server Linux – Ospita la tua piattaforma DevOps

Introduzione

Installare GitLab con le App One-Click

Preparazione

Hardware

Software

Passo 1: Installare le dipendenze

Passo 2: Installare GitLab

Passo 3: Configurare GitLab

Passo 4: Accesso all'interfaccia web

Opzionale: Configurare il firewall con ufw

Installare ufw

Aprire le porte necessarie

Attivare il firewall

Conclusione

Domande frequenti

Software

Installare GitLab con le App One-Click

Passo 1: Installare le dipendenze

Passo 2: Installare GitLab

Passo 3: Configurare GitLab

Passo 4: Accesso all'interfaccia web

Opzionale: Configurare il firewall con ufw

Installare ufw

Aprire le porte necessarie

Attivare il firewall

Conclusione

Server di gioco

Server e hosting

ZAPX

Risorse

ZAP-Hosting