#howto - Installazione di Gitea su tutte le distribuzioni Linux
Gitea è una soluzione hosting Git installabile senza troppe difficoltà su qualsiasi distribuzione Linux. Simile a GitHub, Bitbucket e GitLab, Gitea è un fork di Gogs, e due dei suoi punti di forza sono la velocità e la leggerezza con cui gira.
Gitea è molto facile da utilizzare e da configurare, e in questa guida vedremo come installarlo su un proprio server con qualsiasi distribuzione Linux come base.
Requisiti
Prima di procedere con l’installazione di Gitea è necessario configurare un database ed un utente di sistema che dovrebbe essere utilizzato solamente per questo scopo. Per prima cosa, verifichiamo che Git
sia installato sul sistema con il comando:
git --version
e l’output dovrebbe essere simile al seguente:
git version 2.17.1
In seguito, creiamo un utente che avrà lo scopo di eseguire Gitea. In questa guida utilizzeremo come esempio git
:
sudo adduser --system --home /home/git --shell /bin/bash --group git
realizziamo la struttura delle cartelle in cui girerà il software:
sudo mkdir -p /var/lib/gitea/{custom,data,log}
sudo mkdir /etc/gitea
infine impostiamo i permessi corretti:
sudo chown -R git:git /var/lib/gitea/
sudo chmod -R 750 /var/lib/gitea/
sudo chown root:git /etc/gitea
sudo chmod 770 /etc/gitea
Per concludere, creiamo un database con MySQL, MariaDB o PostgreSQL con dei dati a nostra scelta.
NB: vi consigliamo di creare un utente apposito per la gestione del database di Gitea per una maggior sicurezza.
Installazione di Gitea
Rechiamoci nella nostra home o nella cartella /tmp
e con wget
procediamo al download di Gitea dalle repo ufficiali:
wget -O gitea https://dl.gitea.io/gitea/1.11.4/gitea-1.11.4-linux-amd64
E rendiamo il file scaricato eseguibile:
chmod +x gitea
Verifichiamo che il pacchetto di cui abbiamo effettuato il download sia firmato con la corretta chiave GPG:
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.11.4-linux-amd64.asc gitea-1.11.4-linux-amd64
e per sicurezza forniamo a Gitea un’indicazione sulla directory su cui deve lavorare:
export GITEA_WORK_DIR=/var/lib/gitea/
Infine, copiamo il pacchetto scaricato in precedenza nella cartella principale di Gitea:
sudo cp gitea /usr/local/bin/gitea
Esecuzione di Gitea
Per avviare Gitea ci sono due opzioni: con la prima creeremo un servizio che permetterà di eseguire automaticamente il programma (consigliato), mentre nella seconda ricorreremo al semplice input da terminale.
Creazione di un servizio per avviare Gitea in automatico
Creare un servizio per Gitea con systemd
è molto semplice: creiamo il file gitea.service nella cartella /etc/systemd/system/
e copiamo il seguente blocco di codice, ricordandosi di decommentare la riga dove viene specificato il servizio del proprio programma di database attualmente in esecuzione:
Modificate il parametro dell’utente, del gruppo e della home directory se necessario.
[Unit]
Description=Gitea (Git with a cup of tea)
After=syslog.target
After=network.target
[Service]
#LimitMEMLOCK=infinity
#LimitNOFILE=65535
RestartSec=2s
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
#RuntimeDirectory=gitea
ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea
#CapabilityBoundingSet=CAP_NET_BIND_SERVICE
#AmbientCapabilities=CAP_NET_BIND_SERVICE
[Install]
WantedBy=multi-user.target
Salviamo il file, avviamo Gitea e facciamo in modo che parta automaticamente all’avvio del proprio sistema:
sudo systemctl enable gitea
sudo systemctl start gitea
Esecuzione di Gitea da terminale
Per avviare Gitea attraverso la propria shell non dobbiamo fare altro che scrivere questo semplice comando:
GITEA_WORK_DIR=/var/lib/gitea/ /usr/local/bin/gitea web -c /etc/gitea/app.ini
Post-esecuzione
Nel caso in cui Gitea dovesse avviarsi senza alcun problema, visitiamo l’app web disponibile all’indirizzo: ipdelserver:3000. Se tutto è stato configurato correttamente, dovremmo trovarci di fronte ad una pagina di benvenuto da dove potremo configuare il database.
Per una questione di sicurezza, al termine di quest’ultimo passaggio, cambiate i permessi della cartella di Gitea e del file di configurazione in questo modo:
sudo chmod 750 /etc/gitea
sudo chmod 640 /etc/gitea/app.ini
Conclusione
Gitea è un servizio Git che può tornare molto utile nel caso non si avesse intenzione di usufruire di applicazioni web, ed è consigliato vista la sua semplicità e velocità.
Per maggiori informazioni, non esitate a fare domande sul nostro gruppo Telegram.