Gitea est une plateforme Git simple, légère et auto-hébergée écrite en Go. C'est un fork de Gogs et très similaire à GitLab. Comparé à GitLab, Gitea est extrêmement simple, léger et simple à configurer. Il peut être installé sur tous les principaux systèmes d'exploitation, notamment Windows, macOS, Linux et ARM. Avec Gitea, vous pouvez suivre le temps, les problèmes, la création de branches de référentiel, le verrouillage de fichiers, la fusion et bien d'autres.
Dans ce tutoriel, nous allons vous montrer comment installer Gitea avec Nginx en reverse proxy sur un VPS Ubuntu 20.04.
Prérequis
- Un VPS Ubuntu 20.04 (nous utiliserons notre plan SSD 2 VPS)
- Accès au compte utilisateur root (ou accès à un compte administrateur avec privilèges root)
Étape 1 :Connectez-vous au serveur et mettez à jour les packages du système d'exploitation du serveur
Tout d'abord, connectez-vous à votre serveur Ubuntu 20.04 via SSH en tant qu'utilisateur root :
ssh root@IP_Address -p Port_number
Vous devrez remplacer "IP_Address" et "Port_number" par l'adresse IP et le numéro de port SSH respectifs de votre serveur. De plus, remplacez "root" par le nom d'utilisateur du compte administrateur si nécessaire.
Avant de commencer, vous devez vous assurer que tous les packages du système d'exploitation Ubuntu installés sur le serveur sont à jour. Vous pouvez le faire en exécutant les commandes suivantes :
apt-get update -y apt-get upgrade -y
Étape 2 :Installer les dépendances requises
Avant d'aller plus loin, vous devrez installer certains packages nécessaires sur votre serveur. Vous pouvez tous les installer avec la commande suivante :
apt-get install git unzip gnupg2 -y
Après avoir installé ces packages, vous pouvez continuer et installer le package du serveur MariaDB.
Étape 3 :Installer et configurer MariaDB
Gitea utilise MariaDB comme backend de base de données donc MariaDB doit être installé sur votre serveur. Vous pouvez l'installer avec la commande suivante :
apt-get install mariadb-server -y
Une fois MariaDB installée, connectez-vous au shell MariaDB avec la commande suivante :
mysql
Une fois connecté, activez la table Innodb à l'aide de la commande suivante :
MariaDB [(none)]>SET GLOBAL innodb_file_per_table = ON;
Ensuite, créez une base de données et utilisez-la pour Gitea avec la commande suivante :
MariaDB [(none)]>CREATE DATABASE gitea; MariaDB [(none)]>CREATE USER 'gitea'@'localhost' IDENTIFIED BY 'securepassword';
Ensuite, accordez tous les privilèges à la base de données gitea et définissez le jeu de caractères sur utf8mb4 :
MariaDB [(none)]>GRANT ALL ON gitea.* TO 'gitea'@'localhost' IDENTIFIED BY 'securepassword' WITH GRANT OPTION; MariaDB [(none)]>ALTER DATABASE gitea CHARACTER SET = utf8mb4 COLLATE utf8mb4_unicode_ci;
Ensuite, videz les privilèges et quittez MariaDB avec la commande suivante :
MariaDB [(none)]>FLUSH PRIVILEGES; MariaDB [(none)]>EXIT;
Ensuite, modifiez le fichier de configuration par défaut de MariaDB et modifiez certains paramètres :
nano /etc/mysql/mariadb.conf.d/50-server.cnf
Ajoutez les lignes suivantes dans la section [mysqld] :
innodb_file_format = Barracuda innodb_large_prefix = 1 innodb_default_row_format = dynamic
Enregistrez le fichier puis redémarrez le service MariaDB pour appliquer les modifications :
systemctl restart mariadb
Étape 4 :Installer Gitea
Avant de télécharger et d'installer Gitea, vous devrez créer un utilisateur distinct pour exécuter Gitea. Vous pouvez créer un nouvel utilisateur avec la commande suivante :
adduser --system --group --disabled-password --shell /bin/bash --home /home/git --gecos 'Git Version Control' git
Après avoir créé un nouvel utilisateur, téléchargez la dernière version de Gitea à l'aide de la commande suivante :
wget https://dl.gitea.io/gitea/1.13.1/gitea-1.13.1-linux-amd64
Une fois téléchargé, copiez le binaire téléchargé dans le chemin système avec la commande suivante :
cp gitea-1.13.1-linux-amd64 /usr/bin/gitea
Ensuite, définissez l'autorisation d'exécution sur le binaire gitea :
chmod 755 /usr/bin/gitea
Ensuite, vous devrez créer une structure de répertoires pour stocker les données et les journaux Gitea. Vous pouvez les créer avec la commande suivante :
mkdir -p /etc/gitea /var/lib/gitea/{custom,data,indexers,public,log} Ensuite, définissez la propriété et l'autorisation appropriées pour tous les répertoires :
chown git:git /etc/gitea /var/lib/gitea/{custom,data,indexers,public,log}
chmod 750 /var/lib/gitea/{data,indexers,log}
chmod 770 /etc/gitea Étape 5 :Créer un fichier d'unité système pour Gitea
Ensuite, créez un fichier de service systemd pour gérer le service Gitea à l'aide de systemd.
nano /etc/systemd/system/gitea.service
Ajoutez les lignes suivantes :
[Unit] Description=Gitea After=syslog.target After=network.target After=mysql.service [Service] RestartSec=2s Type=simple User=git Group=git WorkingDirectory=/var/lib/gitea/ ExecStart=/usr/bin/gitea web -c /etc/gitea/app.ini Restart=always Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea [Install] WantedBy=multi-user.target
Enregistrez et fermez le fichier puis rechargez le démon systemd avec la commande suivante :
systemctl daemon-reload
Ensuite, démarrez le service Gitea et activez-le pour qu'il démarre au redémarrage du système :
systemctl start gitea systemctl enable gitea
Vous pouvez également vérifier le statut de Gitea avec la commande suivante :
systemctl status gitea
Étape 6 : Configurer Nginx en tant que proxy inverse pour Gitea
Tout d'abord, installez le package Nginx avec la commande suivante :
apt-get install nginx -y
Une fois installé, vous devrez configurer Nginx en tant que reverse proxy pour accéder au Gitea.
Tout d'abord, créez un nouveau fichier de configuration d'hôte virtuel Nginx avec la commande suivante :
nano /etc/nginx/conf.d/gitea.conf
Ajoutez les lignes suivantes :
upstream gitea {
server 127.0.0.1:3000;
}
server {
listen 80;
server_name gitea.example.com;
root /var/lib/gitea/public;
access_log off;
error_log off;
location / {
try_files maintain.html $uri $uri/index.html @node;
}
location @node {
client_max_body_size 0;
proxy_pass http://localhost:3000;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $http_host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_max_temp_file_size 0;
proxy_redirect off;
proxy_read_timeout 120;
}
}
Enregistrez et fermez le fichier puis redémarrez le service Nginx pour appliquer les modifications :
systemctl restart nginx
Étape 7 :Accéder à l'interface Web de Gitea
Maintenant, ouvrez votre navigateur web et accédez au Gitea en utilisant l'URL http://gitea.example.com/install . Vous allez être redirigé vers la page de configuration de Gitea :
Fournissez les informations de votre base de données Gitea, port, URL, nom d'utilisateur administrateur, mot de passe et cliquez sur Installer Gitea bouton. Une fois l'installation terminée, vous serez redirigé vers le tableau de bord Gitea :
Toutes nos félicitations! vous avez installé avec succès Gitea sur Ubuntu 20.04 VPS.
Suivez ce tutoriel si vous cherchez à installer Gitea sur Debian 9
Bien sûr, vous n'avez rien à faire si vous utilisez l'un de nos services d'hébergement VPS Git, auquel cas vous pouvez simplement demander à nos administrateurs Linux experts de le configurer pour vous. Ils sont disponibles 24h/24 et 7j/7 et prendront immédiatement en charge votre demande.
PS. Si vous avez aimé cet article, partagez-le avec vos amis sur les réseaux sociaux en utilisant les boutons à gauche ou laissez simplement une réponse ci-dessous. Merci.