Installation et configuration de Gogs avec Nginx (Debian 8.7)

Gogs (GO Git Service) est une interface web Git légère. Il est écrit en Go.

Installation de Gogs

Afin de nous simplifier l’installation et les mises à jour de Gogs, nous allons l’installer à partir du dépôt mis à disposition. Pour cela, on tape la commande suivante :

1

# echo "deb https://deb.packager.io/gh/pkgr/gogs jessie pkgr" | tee /etc/apt/sources.list.d/gogs.list

Nous allons maintenant la clé qui permettra de vérifier l’authenticité des paquets que nous téléchargerons depuis le dépôt via leur signature. Pour cela, on tape la commande suivante :

1

# wget -qO - https://deb.packager.io/key | apt-key add -

Maintenant que le nouveau dépot est créé et que la clé est importée, nous pouvons mettre à jour la liste des packages et installer Gogs. Pour cela, on tape les commandes suivantes :

1
2
3

# apt-get install apt-transport-https
# apt-get update
# apt-get install gogs

Installation de Nginx

Nous allons l’installer via la commande suivante :

1

# apt-get install nginx

Maintenant on peut vérifier que notre serveur fonctionne bien en entrant l’adresse suivante dans notre navigateur :

http://IP_DE_VOTRE_SERVEUR/

Vous devriez obtenir le résultat suivant :

Configuration de Nginx

On créé le répertoire qui contiendra les fichiers de log du site web via la commande suivante :

1

# mkdir /var/log/nginx/git.monsiteweb.fr

Nous allons créer un VirtualHost que nous appellerons « monsiteweb.fr.conf » via la commande suivante :

1

# vi /etc/nginx/conf.d/git.monsiteweb.fr.conf

On y enregistre les lignes suivantes :

1
2
3
4
5
6
7
8
9

server {
     listen 80;
     server_name git.monsiteweb.fr;
     location / {
          proxy_pass http://127.0.0.1:6000;
     }
     error_log /var/log/nginx/git.monsiteweb.fr/error.log;
     access_log /var/log/nginx/git.monsiteweb.fr/access.log;
}

On vérifie que l’on n’a pas fait d’erreur lors de la configuration de notre VirtualHost via la commande suivant :

1

# nginx -t

Nous devons obtenir les messages suivants :

1
2

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Si c’est bon, on recharge la configuration de Nginx via la commande suivante :

1

# systemctl reload nginx.service

Installation et configuration de MariaDB

Installation du serveur MariaDB via la commande suivante :

1

# apt-get install mariadb-server-10.0

L’installeur va nous demander de définir le mot de passe root de MariaDB (« mariadb » par exemple). On vérifie que MariaDB fonctionne bien via la commande suivante :

1
2
3

# mysql -u root -p
entrer le mot de passe
MariaDB [(none)]> quit

Maintenant nous pouvons lancer l’outil de configuration MariaDB pour supprimer les utilisateurs anonymes, supprimer les bases de tests et désactiver la possibilité pour root de se connecter à distance via la commande :

1
2
3
4
5
6
7
8

# /usr/bin/mysql_secure_installation

Enter current password for root (enter for none) : Taper le mot de passe précédemment entré
Set root password? [Y/n] n
Remove anonymous users? [Y/n] Taper sur la touche Entrer
Disallow root login remotely? [Y/n] Taper sur la touche Entrer
Remove test database and access to it? [Y/n] Taper sur la touche Entrer
Reload privilege tables now? [Y/n] Taper sur la touche Entrer

Création d’un utilisateur et d’une base de données pour Gogs

Nous allons nous connecter au serveur MariaDB via la commande suivante :

1

# mysql -u root -p

Nous allons créer une base de données « gogsdb » via la commande suivante :

1

MariaDB [(none)]> CREATE DATABASE IF NOT EXISTS gogsdb CHARACTER SET utf8 COLLATE utf8_general_ci;

Nous allons créer un utilisateur « gogs » avec le mot de passe « password » et lui donner tous les droits à sur la base de donnée « gogsdb » ainsi que spécifier le type de moteur de stockage à utiliser pour cette base via les commandes suivantes :

1
2
3
4
5

MariaDB [(none)]> grant usage on gogsdb.* to gogs@localhost identified by 'password';
MariaDB [(none)]> grant all privileges on gogsdb.* to gogs@localhost ;
MariaDB [(none)]> flush privileges;
MariaDB [(none)]> use gogsdb;
MariaDB [(none)]> SET default_storage_engine=INNODB;

On quitte le serveur MariaDB via la commande suivante :

1

MariaDB [(none)]> quit

Configuration de Gogs

Afin de configurer Gogs, nous allons nous rendre à l’adresse : http://git.monsiteweb.fr/ et on rempli les champs comme ci-dessous. La base de données:

Paramètres généraux de Gogs

Paramètres facultatifs

Création d’un repository/dépôt Gogs

Un repository/dépôt Gogs est une sorte de répertoire qui contiendra l’ensemble des fichiers du projet. Pour en créer un, nous devons cliquer en haut à droite sur le petit « + », puis « Nouveau dépôt »

On renseigne le nom du repository/projet, ainsi qu’une description, puis l’on clique sur « Créer un dépôt »

Une nouvelle page va s’afficher avec les URL (au format HTTPS et SSH) pour la synchronisation avec notre futur repository/dépôt local. Nous allons copier l’URL au format SSH dans un document texte. Elle nous servira par la suite

Création d’une SSH

Nous allons maintenant nous attaquer à la création d’une paire clé SSH (Publique et Privée) afin de nous permettre de synchroniser notre repository/dépôt local avec notre repository/dépôt GitHub. Elles seront au format RSA et auront une longueur de 4096 bits. Pour cela on tape la commande suivante :

1

# ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

Lors de la création, il va vous êtes proposer de créer une passphrase (« mot de passe ») pour la clé. Pour plus de sécurité, je vous conseille d’en mettre un. Maintenant que la paire de clé est créée, nous devons copier la clé publique sur GitHub. Pour cela, nous éditons le fichier « id_rsa.pub » via la commande suivante :

1

# vi .ssh/id_rsa.pub

On copie l’ensemble du contenu. Ensuite on se rend sur son compte Gogs, on clique en haut à droite, a droite du « + », puis sur « Paramètres »

On clique sur « Clés SSH » dans les onglets verticaux

On clique sur le bouton « Ajouter une clé »

Pour en simplifier la gestion on donne un nom (nom de l’ordinateur à partir duquel elle a été générée) à la clé publique et on la colle dans l’encadré « Contenu » prévu à cet effet, puis on clique sur « Ajouter une clé »

Configuration du client Git

Afin de pouvoir utiliser le client Git, nous devons configurer un nom d’utilisateur et une adresse mail. Pour cela, on tape les commandes suivantes :

1
2

# git config --global user.name "your_name"
# git config --global user.email "your_email@example.com"

Synchronisation sur Gogs à l’aide du client Git

Maintenant que le client est installé, nous devons créer un répertoire dans lequel nous créerons le repository/projet. Pour cela, nous tapons la commande suivante :

1

# mkdir Git_Repository

On se rend dans le répertoire via la commande suivante :

1

# cd Git_Repository

Maintenant que l’on est dans le répertoire, on peu créer le repository/projet via la commande suivante :

1

# git init mon_projet

On se rend dans le répertoire « mon_projet » via la commande suivante :

1

# cd mon_projet

Le repository/projet étant créé, on créé/copie les fichiers dans le répertoire « mon_projet » afin de pouvoir faire les actions qui vont suivre. Une fois les fichiers créés, nous allons devoir activer le suivi de version/modifications pour l’ensemble des fichiers présent dans le répertoire. Pour cela, nous allons taper les commandes suivantes :

1

# git add --all

Le suivi de version étant activé, nous devons maintenant « Valider » l’ensemble des modifications effectués dans le repository/projet. Pour cela on tape la commande suivante :

1

# git commit --all

Avant de pouvoir synchroniser le repository/projet local avec Gogs, nous devons configurer l’URL du repository/dépôt Gogs dans le client Git. Pour cela on tape la commande suivante :

1

# git remote add mon_projet gogs@git.monsiteweb.fr:Usernamme/mon_projet.git

On peut vérifier la bonne prise en compte de l’URL via la commande suivante :

1

# git remote -v

Maintenant que le client Git est configuré, on peut envoyer le contenu de notre repository dans la branche master sur GitHub via la commande suivante :

1

# git push -u mon_projet master

Quelques commandes supplémentaires

« Valider » les modifications avec un commentaire :

1

# git commit -m "mon_commentaire"

Effacer/Supprimer des fichiers du repository/projet :

1

# git rm mon_fichier

Renommer un fichier du repository/projet :

1

# git mv fichier_d_origine fichier_cible