Comment auto-héberger Gitea sur un VPS (Guide Complet)

Gitea est un service Git léger et auto-hébergé qui permet aux développeurs de gérer leurs projets facilement. Dans ce guide, nous allons passer en revue les étapes pour auto-héberger Gitea sur un serveur privé virtuel (VPS) en utilisant Docker. Cette configuration vous donne le contrôle sur la gestion de votre code source tout en maintenant des coûts bas.

Choisir un fournisseur de VPS

Lors de la sélection d’un VPS pour faire fonctionner Gitea, considérez des facteurs tels que la performance, le coût et la fiabilité. Voici une comparaison des fournisseurs de VPS populaires qui conviennent à l’auto-hébergement d’applications comme Gitea :

Pour Gitea, même un VPS de faible spécification suffira, bien que vous souhaitiez peut-être considérer un fournisseur avec un meilleur temps de disponibilité et un meilleur support client, comme Contabo ou Hetzner.

Pré-requis

Avant de commencer l’installation, assurez-vous d’avoir ce qui suit :

1. Une instance VPS fonctionnant sur une distribution Linux (Ubuntu est recommandée).
2. Un accès root à votre VPS.
3. Docker et Docker Compose installés sur votre serveur. S’ils ne sont pas installés, suivez les étapes ci-dessous :

Installer Docker et Docker Compose

1. Connectez-vous à votre VPS via SSH :

   ssh root@your_vps_ip

2. Mettez à jour votre index de paquets :

   apt update && apt upgrade -y

3. Installez Docker :

   apt install -y docker.io

4. Activez et démarrez Docker :

   systemctl enable docker
   systemctl start docker

5. Installez Docker Compose :

   apt install -y docker-compose

Installer Gitea avec Docker

Maintenant que Docker est installé, nous pouvons procéder au déploiement de Gitea.

1. Créez un répertoire pour Gitea :

   mkdir -p /opt/gitea
   cd /opt/gitea

2. Créez un fichier Docker Compose nommé docker-compose.yml :

   version: '3'
   services:
     gitea:
       image: gitea/gitea:latest
       environment:
         - USER=git
         - GITEA__database__DB_TYPE=sqlite3
         - GITEA__database__PATH=/data/gitea.db
         - GITEA__server__DOMAIN=yourdomain.com
         - GITEA__server__ROOT_URL=https://yourdomain.com
         - GITEA__server__HTTP_PORT=3000
         - GITEA__server__SSH_PORT=22
         - GITEA__security__INSTALL_LOCK=true
       volumes:
         - gitea_data:/data
       ports:
         - "3000:3000"
         - "222:22"
   volumes:
     gitea_data:

3. Remplacez yourdomain.com par votre nom de domaine réel ou l’adresse IP de votre VPS.

4. Démarrez le service Gitea :

   docker-compose up -d

5. Vérifiez si Gitea fonctionne :

   docker ps

Configurer Gitea

Après avoir démarré Gitea, vous pouvez y accéder dans votre navigateur en entrant http://your_vps_ip:3000 ou http://yourdomain.com:3000. La configuration initiale vous guidera pour configurer la base de données et le compte admin.

Étapes à Configurer :

1. Base de données : Puisque nous utilisons SQLite, vous pouvez conserver les paramètres par défaut.

2. URL de l’application : Réglez cela sur votre domaine ou votre IP.

3. Compte Admin : Créez le compte utilisateur admin.

4. Paramètres supplémentaires : Configurez les notifications par e-mail et d’autres fonctionnalités selon vos besoins.

Gérer Gitea

Une fois Gitea installé et configuré, vous pouvez le gérer via l’interface web. Vous pouvez créer des dépôts, gérer les contrôles d’accès et utiliser les diverses fonctionnalités offertes par Gitea.

FAQs

1. Puis-je utiliser Gitea pour des dépôts privés ?

Oui, Gitea vous permet de créer des dépôts privés où seuls les collaborateurs invités peuvent accéder au code. C’est parfait pour les équipes travaillant sur des projets propriétaires ou des codes sensibles.

2. Quelle est la sécurité de Gitea lors de l’auto-hébergement ?

La sécurité dépend en grande partie de la configuration de votre serveur. Assurez-vous que votre pare-feu est configuré, gardez votre logiciel à jour, et envisagez d’utiliser HTTPS pour des connexions sécurisées. Des sauvegardes régulières de vos données sont également une bonne pratique.

3. Puis-je migrer mes projets de GitHub vers Gitea ?

Oui, Gitea fournit des outils intégrés pour importer des dépôts depuis GitHub et d’autres services. Suivez simplement les outils d’importation dans l’interface web de Gitea et fournissez les URL des dépôts nécessaires et les jetons d’authentification.

Conclusion

L’auto-hébergement de Gitea sur un VPS est un processus simple qui vous offre flexibilité et contrôle sur vos dépôts de code. La méthode de déploiement Docker assure une installation, une évolutivité et une gestion faciles de votre instance Gitea. Pour une vue d’ensemble complète des différentes options de VPS pour héberger vos applications, consultez notre comparaison complète de VPS. Bon codage !