projet_4/Installation Gitea.md

Gitea version : 1.25.4

Durée estimé : ~10 minutes Prérequis : Debian 13 Ressource : https://dl.gitea.com/gitea/1.25.4/gitea-1.25.4-linux-amd64

Installer sudo de préférence avant d'effectuer la suite de guide

Première étape, faire la mis à jour des paquets (classique) :

sudo apt update && sudo apt -y upgrade

Puis installer Git afin d'éviter tout problème lors de la suite de l'installation

sudo apt install git

Seconde étape : mettre en place un serveur de base de donnée -> Installation de MariaDB

Pour débuter l'installation de gitea, il faut créer un nouvel utilisateur qui servira à exécuter Gitea avec les droits nécessaires :

sudo adduser \
   --system \
   --shell /bin/bash \
   --gecos 'Git Version Control' \
   --group \
   --disabled-password \
   --home /home/git \
   git

Ensuite, il faut créer l'arborescence qui permet à Gitea de fonctionner :

mkdir -p /var/lib/gitea/{custom,data,log}
chown -R git:git /var/lib/gitea/  
chmod -R 750 /var/lib/gitea/  
mkdir /etc/gitea  
chown root:git /etc/gitea  
chmod 770 /etc/gitea

Gitea n'existe pas en version package apt, il faut donc installer le script qui permet de le télécharger :

wget -O gitea https://dl.gitea.com/gitea/1.25.4/gitea-1.25.4-linux-amd64
chmod +x gitea  
sudo mv gitea /usr/local/bin/gitea

Vérifier qu'il s'est bien installé :

gitea --version

Maintenant, on va faire en sorte que Gitea soit utilisé en mode service dans notre système. Pour ce faire, il va falloir créer le fichier qui va déterminer à quoi correspond notre service.

sudo nano /etc/systemd/system/gitea.service

Puis coller :

[Unit]
Description=Gitea
After=network.target mariadb.service
Requires=mariadb.service

[Service]
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
ExecStart=/usr/local/bin/gitea web --config /var/lib/gitea/custom/conf/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea

[Install]
WantedBy=multi-user.target

Exécuter le service.

sudo systemctl daemon-reload
sudo systemctl enable --now gitea

Vous pouvez vérifier que tout fonctionne grâce à un 'status' :

sudo systemctl status gitea

Super ! Maintenant, configurons la base de données précédemment installer. Créer un fichier de config :

sudo nano /etc/gitea/app.ini

Evidemment, si votre base de données se trouve sur une autre VM, il vous faudra modifier les configuration de connexion :

APP_NAME = Gitea
RUN_USER = git
WORK_PATH = /var/lib/gitea

[server]
PROTOCOL = http
HTTP_ADDR = 0.0.0.0
HTTP_PORT = 3000
DOMAIN = 127.0.0.1
ROOT_URL = http://127.0.0.1:3000/

[log]
MODE = console
LEVEL = Info

Redémarrer le service :

sudo systemctl restart gitea

Si tout s'est bien passé, vous devriez pouvoir acceder à l'interface web de Gitea en entrant @ip:3000 : !

Vous pouvez désormais inscrire vos informations de connexion à la base de données. Pour le titre du site, vous pouvez donc renseigner "2028-DI1-P4-G?" par exemple.

Bienvenue sur Gitea

! !

Créer désormais votre premier utilisateur, il sera évidemment doter des permissions administrateur afin de pouvoir manager votre application.

Une fois votre compte activé, alors vous pouvez accéder à votre interface.

!