diff --git a/Readme.md b/Readme.md new file mode 100644 index 0000000..724dc67 --- /dev/null +++ b/Readme.md @@ -0,0 +1,44 @@ +Documentation : Mise en place de Gitea sur Debian 12 (LXC)Cette documentation détaille l'installation, la configuration et la sécurisation d'une instance Gitea. Gitea est une solution de forge Git légère, écrite en Go, parfaite pour une exécution optimisée en conteneur LXC.1. Schéma de l'Architecture2. PrérequisHôte : Proxmox VE avec un conteneur LXC Debian 12 (Bookworm).Ressources minimales : 1 vCPU, 512 Mo RAM, 10 Go disque (ajuster selon les dépôts).Privilèges : Accès root sur le conteneur.Réseau : Une adresse IP statique configurée.3. Installation du SystèmeMise à jour et dépendancesMettre à jour les dépôts et installer les outils nécessaires :apt update && apt upgrade -y +apt install -y git sqlite3 curl gnupg2 +Création de l'utilisateur dédiéCréer un utilisateur système git pour isoler l'exécution du service :adduser --system --shell /bin/bash --gecos 'Git Version Control' \ + --group --disabled-password --home /home/git git +4. Déploiement du BinaireArborescence de fichiersRespecter la hiérarchie standard pour faciliter les sauvegardes :/usr/local/bin/gitea : Le binaire./var/lib/gitea : Données, dépôts et logs./etc/gitea : Fichiers de configuration.# Création des dossiers +mkdir -p /var/lib/gitea/{custom,data,log,indexers,queues} +chown -R git:git /var/lib/gitea/ +chmod -R 750 /var/lib/gitea/ + +mkdir -p /etc/gitea +chown root:git /etc/gitea +chmod 770 /etc/gitea +TéléchargementRécupérer la dernière version stable (exemple ici : 1.21.4) :GITEA_VER="1.21.4" +curl -L "[https://dl.gitea.com/gitea/$](https://dl.gitea.com/gitea/$){GITEA_VER}/gitea-${GITEA_VER}-linux-amd64" -o /usr/local/bin/gitea +chmod +x /usr/local/bin/gitea +5. Persistance et Service SystemdCréer le fichier /etc/systemd/system/gitea.service pour gérer le cycle de vie du processus :[Unit] +Description=Gitea (Git with a cup of tea) +After=network.target + +[Service] +RestartSec=2s +Type=simple +User=git +Group=git +WorkingDirectory=/var/lib/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 + +[Install] +WantedBy=multi-user.target +Activer le service au démarrage :systemctl daemon-reload +systemctl enable --now gitea +6. Configuration Initiale (Interface Web)Se rendre sur http://:3000.ParamètreValeur recommandéeType de base de donnéesSQLite3Chemin de la base/var/lib/gitea/data/gitea.dbTitre du siteVotre Forge GitChemin racine des dépôts/home/git/gitea-repositoriesUtilisateur systèmegitURL de basehttp://:3000/Note : Créer le compte administrateur immédiatement via la section "Paramètres du compte administrateur" en bas de page pour éviter que le premier visiteur ne devienne admin.7. Sécurisation Post-InstallationUne fois l'assistant web terminé, le fichier /etc/gitea/app.ini est généré. Il contient des informations sensibles.Verrouillage des permissionschmod 440 /etc/gitea/app.ini +chown root:git /etc/gitea/app.ini +Optimisations dans app.iniModifier les sections suivantes pour renforcer la sécurité :[security] +INSTALL_LOCK = true ; Empêche de relancer l'assistant +DISABLE_GIT_HOOKS = true ; Sécurité contre l'exécution de scripts malveillants via Git + +[service] +DISABLE_REGISTRATION = true ; Désactiver l'auto-inscription si usage privé +SHOW_REGISTRATION_BUTTON = false +8. Maintenance et Mise à jourPour mettre à jour Gitea, le processus est extrêmement simple :Stopper le service : systemctl stop gitea.Télécharger le nouveau binaire et écraser l'ancien dans /usr/local/bin/gitea.Rétablir les permissions : chmod +x /usr/local/bin/gitea.Relancer : systemctl start gitea.9. Stratégie de Sauvegarde (Automatisation)En tant qu'administrateur, privilégier une sauvegarde à froid (snapshot LXC via Proxmox) ou un dump via l'outil interne :# Commande de dump à scripter en cron +su - git -c "/usr/local/bin/gitea dump -c /etc/gitea/app.ini"