Guide de déploiement de Gitea localement avec Docker

À propos de Gitea

Gitea est un service d'hébergement Git léger, similaire aux plateformes comme GitHub et Gitee. Il s'agit d'un projet open source qui peut être déployé localement, ce qui le rend particulièrement adapté à un usage personnel ou à des collaborations en petites équipes. Gitea nécessite un minimum de ressources CPU ( Article connexe  : La différence entre RAM, ROM, ARM, MCU et CPU) et de la mémoire, ce qui le rend idéal pour une utilisation sur des ordinateurs personnels ou des serveurs aux ressources limitées.

Configurer Gitea localement

Ce guide montre le processus de configuration sur Ubuntu 18.04.4 LTS à l'aide de conteneurs Docker. Docker permet aux applications et à leurs dépendances de s'exécuter dans des environnements isolés, tandis que Docker Compose est utilisé pour gérer plusieurs conteneurs de manière transparente.

2.1 Installation de Docker

Gitea sera hébergé dans un conteneur pour empaqueter l'application et ses dépendances dans un environnement isolé. Cela garantit la portabilité et l’évolutivité. Installez Docker avec la commande suivante :

sudo apt installer docker.io 

Vérifiez l'installation :

docker-v 

Résultat attendu :

Docker version 20.10.21, version 20.10.21-0ubuntu1~18.04.3 

2.2 Installation de Docker Compose

Docker Compose simplifie la gestion de plusieurs conteneurs. Vous trouverez ci-dessous deux méthodes d'installation :

2.2.1 Installation en ligne

Téléchargez Docker Compose à l'aide de l'une des commandes suivantes :

• Depuis GitHub (source mondiale) :

  sudo curl -L https://github.com/docker/compose/releases/download/2.30.3/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
  

• From DaoCloud (domestic source):

  sudo curl -L https://get.daocloud.io/docker/compose/releases/download/2.30.3/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
  

If curl is not installed, install it first:

sudo apt install curl

Après le téléchargement, accordez les autorisations d'exécution :

sudo chmod +x /usr/local/bin/docker-compose 

Vérifiez l'installation :

docker-compose -v 

Si des problèmes surviennent (par exemple, le fichier téléchargé est une page HTML), passez à la méthode d'installation hors ligne.

2.2.2 Installation hors ligne

Visitez la page de version de Docker Compose pour télécharger le binaire approprié pour votre architecture système.
Pour ce guide, le système est x86_64 et la version 2.30.3 est utilisée.

Après le téléchargement, renommez et déplacez le fichier vers /usr/local/bin/:

sudo mv docker-compose-Linux-x86_64 /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose 

Vérifiez l'installation :

docker-compose --version 

Résultat attendu :

Docker Compose version v2.30.3 

2.3 Configuration du docker-compose.yml Déposer

Créez un répertoire de projet pour stocker les fichiers de configuration :

mkdir ~/gitea && cd ~/gitea 

Dans ce répertoire, créez un docker-compose.yml déposer. Ce fichier définit deux services : Gitea et MySQL. MySQL fournit le backend de base de données pour Gitea.

docker-compose.yml Exemple de fichier :

réseaux : gitea : externe : falseservices : serveur : image : gitea/gitea:1.21.1 nom_conteneur : gitea environnement : - USER_UID=1000 - USER_GID=1000 - GITEA__database__DB_TYPE=mysql - GITEA__database__HOST=db:3306 - GITEA__database__NAME=gitea - GITEA__database__USER=gitea - GITEA__database__PASSWD=gitea restart : toujours réseaux : - volumes gitea : - ./gitea:/data - /etc/timezone:/etc/timezone:ro - /etc/localtime:/etc/localtime:ro ports : - "3000:3000" - "222:22" depend_on : - db db : image : mysql:8 nom_du conteneur : redémarrage mysql : toujours environnement : - MYSQL_ROOT_PASSWORD=gitea - MYSQL_USER=gitea - MYSQL_PASSWORD=gitea - MYSQL_DATABASE=gitea réseaux : - ports gitea : - volumes "3306:3306" : - ./mysql:/var/lib/mysql 

2.4 Démarrage des conteneurs Docker

Lancez les conteneurs :

sudo docker-compose up -d 

S'il y a des erreurs de délai d'attente, mettez à jour les paramètres du miroir Docker dans /etc/docker/daemon.json (créez le fichier s'il n'existe pas) :

{  "registry-mirrors": ["https://docker-proxy.741001.xyz", "https://registry.docker-cn.com"]}

Rechargez et redémarrez le service Docker :

sudo systemctl démon-reloadsudo systemctl redémarrer le docker 

Réessayez de lancer les conteneurs :

sudo docker-compose up -d 

Vérifiez l'état des conteneurs :

sudo dockerps 

Résultat attendu :

COMMANDE D'IMAGE D'ID DE CONTENEUR ... NOMS DE PORTS89825b4d35bb gitea/gitea:1.21.1 "/usr/bin/entrypoint…" ... 0.0.0.0:3000->3000 giteacd7ef47cc0a9 mysql:8 "docker-entrypoint.s…" .. . 0.0.0.0:3306->3306 MySQL 

2.5 Accéder au service Gitea

Accédez à l'interface web de Gitea à l'aide de votre navigateur :

http://192.168.xx.xx:3000 

Suivez les instructions à l'écran pour la configuration initiale. La configuration doit être automatiquement renseignée à partir du docker-compose.yml déposer. Cliquez sur Installer pour terminer la configuration.

Une fois installé, inscrivez-vous et connectez-vous pour utiliser Gitea. Le premier compte enregistré aura des privilèges d'administrateur.

Gitea prend en charge des fonctionnalités telles que le contrôle de version, la gestion des branches, la révision du code et le suivi des problèmes. Vous pouvez également migrer des référentiels d'autres plateformes vers Gitea à des fins de sauvegarde.