grimboite/articles/sys/2015-01-22-gitweb.md

1.7 KiB

Title Date Slug Tags
GitWeb 2015-01-22 gitweb git, web, serveur

GitWeb est un frontend Web permettant de visualiser des dépôts Git. En gros (et après traduction), ses principales fonctions sont les suivantes:

  • Visualiser plusieurs dépôts ayant la même racine
  • Parcourir toutes les révisions d'un dépôt donné
  • Visualiser le contenu des fichiers du dépôt (à partir de n'importe quelle révision)
  • Visualiser les logs
  • Générer un flux RSS/Atom pour tous les commits d'une branche
  • ...

Bref, sans atteindre les fonctionnalités d'un GitHub ou d'un GitLab, GitWeb fera très bien son boulot.

Commencez par créer l'utilisateur git, grâce à la commande sudo adduser git. Ceci va (normalement) créer le répertoire /home/git et tous les droits qui lui sont associés. Les dépôts seront alors stockés dans le répertoire /home/git/repositories.

Pour Nginx, voici un exemple de configuration:

location /git/ {
	alias /usr/share/gitweb/;
	fastcgi_param SCRIPT_FILENAME   /usr/share/gitweb/index.cgi;
	include fastcgi_params;
	gzip off;
	fastcgi_param GITWEB_CONFIG /etc/gitweb.conf;
	fastcgi_pass unix:/var/run/fcgiwrap.socket;
}

Et finalement, comme le thème par défaut est peut-être un peu austère, il est possible de le modifier facilement en suivant les étapes définies ici.

Sources