Add installation guides for Gitea and MariaDB on Debian 13

Installation Gitea.md

@@ -0,0 +1,145 @@
+**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) :
+
+```bash
+sudo apt update && sudo apt -y upgrade
+```
+
+Puis installer Git afin d'éviter tout problème lors de la suite de l'installation
+
+```bash
+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 :
+
+```bash
+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 :
+
+```bash
+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 :
+
+```bash
+
+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é :
+
+```bash
+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.
+
+```bash
+sudo nano /etc/systemd/system/gitea.service
+```
+
+Puis coller :
+```ini
+[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.
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable --now gitea
+```
+
+Vous pouvez vérifier que tout fonctionne grâce à un 'status' :
+
+```bash
+sudo systemctl status gitea
+```
+
+Super ! Maintenant, configurons la base de données précédemment installer. Créer un fichier de config :
+
+```bash
+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 :
+
+```ini
+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 :
+
+```bash
+sudo systemctl restart gitea
+```
+
+Si tout s'est bien passé, vous devriez pouvoir acceder à l'interface web de Gitea en entrant @ip:3000 :
+![[Pasted image 20260227143655.png]]
+
+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
+
+![[Pasted image 20260227145538.png]]
+
+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.
+
+![[Pasted image 20260227145747.png]]

Installation de MariaDB.md

@@ -0,0 +1,54 @@
+
+**Durée estimé : ~3 minutes**
+**Prérequis : Debian 13**
+
+Pas grand chose de compliqué, mais ici vous allez trouver toutes les commandes dans le cadre de la mis en place de Gitea.
+
+Mis à jour des paquets APT :
+
+```bash
+sudo apt update && sudo apt -y upgrade
+```
+
+Installation de MariaDb Server (toutes les dépendances seront téléchargés à l'exécution de la commande, si vous êtes sur Debian 13, vous verrez toutes les dépendances nécessaires)
+
+```bash
+sudo apt install -y mariadb-server
+```
+
+Une fois l'installation terminé, vous pouvez vérifier si le service s'est exécuté à l'aide de la commande suivante :
+
+```bash
+systemctl status mariadb --no-pager
+```
+
+Vous devriez voir un statut actif, si ce n'est pas le cas, aller voir les logs ;)
+
+Passons maintenant à la configuration de la base de données. Gitea à besoin d'une base de donnée, il fera les migrations tout seul. Pour ce faire, entré dans MariaDB à l'aide de la commande :
+
+```bash
+sudo mariadb
+```
+
+Puis, entrer ligne par ligne les requêtes SQL suivante :
+
+```sql
+
+CREATE DATABASE gitea CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+
+CREATE USER 'gitea'@'localhost' IDENTIFIED BY 'MotDePasseUltraFort';
+
+GRANT ALL PRIVILEGES ON gitea.* TO 'gitea'@'localhost';
+
+FLUSH PRIVILEGES;
+EXIT;
+```
+
+Explication :
+- On créer la base de donnée 'gitea' en appliquant une règle de formatage des données en UTF-8
+- On créer l'utilisateur 'gitea' avec le mot  de passe 'MotDePasseUltraFort' (à modifier évidemment, avec un mot  de passe générer dans votre Keepass)
+- On donne ensuite les droits d'accès à l'utilisateur 'gitea' sur la base de données 'gitea' et les tables qu'elle contient.
+- On applique la modification des droits de l'utilisateur.
+- Puis on sort du terminal MariaDB.
+
+L'initialisation côté base de donnée est **terminé**.