Gogs est le moyen le plus simple d’exécuter un serveur Git local (voici comment le configurer)

Vous ne voulez pas pousser votre code vers un dépôt Git hébergé ? Exécutez ensuite votre propre serveur Git en interne. Gogs est le moyen le plus simple de le faire. Voici comment le configurer.

Le problème avec les référentiels hébergés dans le cloud

Sans aucun doute, Git est le système de contrôle de version par excellence. Même avec des projets à développeur unique, Git offre de la valeur et des avantages en raison de sa fonctionnalité de gestion des versions. Pour les projets multi-développeurs, Git apporte une toute autre dimension. Avec un référentiel central et distant, Git permet une capacité de collaboration qui transformera la façon dont vos équipes de développement voient le contrôle de version.

C’est pourquoi des services comme GitHub, GitLab et BitBucket existent, et pourquoi ils ont connu une telle adoption et croissance. GitHub héberge à lui seul plus de 200 millions de référentiels. Mais les référentiels hébergés dans le cloud ne conviennent pas à tout le monde. La plupart d’entre eux facturent l’hébergement de référentiels privés. Certains d’entre eux imposent des limites de stockage, des limites d’utilisateurs ou des limites de transfert de données sur les comptes gratuits.

Même si votre utilisation et la taille de votre équipe correspondent aux restrictions des comptes gratuits, ou même si vous êtes prêt à payer pour une licence commerciale, vous ne vous sentirez peut-être pas à l’aise pour stocker votre base de code dans le cloud.

L’alternative est d’héberger votre propre serveur Git soit localement sur votre propre réseau, soit accessible en privé dans votre propre cloud privé. La configuration d’un serveur Git qui fournit une interface Web avec l’apparence, la convivialité et les options que GitHub et ses amis ont rendues si populaires nécessitait un certain degré de compétence technique. C’est là que Gogs entre en jeu.

Qu’est-ce que Gogs ?

Gogs est un projet relativement nouveau, écrit en Go, qui fournit une instance Git facile à installer, mais complète. Il n’y a pas de limites à la taille de l’équipe, au stockage ou à quoi que ce soit d’autre.

Même si vous êtes un programmeur amateur, l’utilisation de Gogs en tant que service Git sur votre réseau local vous permet de stocker une copie de votre code loin de votre machine de développement. Lorsque vous – ou quelqu’un d’autre – souhaitez travailler sur un ordinateur différent ou nouveau, il vous suffit de cloner un référentiel à partir de votre serveur Gogs, comme vous le feriez à partir de GitHub.

Si vous allez utiliser Gogs fréquemment, vous trouverez probablement pratique de l’ajouter aux applications de démarrage de l’ordinateur sur lequel il s’exécute.

Comment installer Gogs

Pour installer Gogs, téléchargez le fichier d’archive approprié, décompressez-le et exécutez le binaire principal. Vous remplissez quelques formulaires et Gogs initialise votre référentiel et vous ajoute en tant qu’utilisateur administrateur. Vous pouvez ensuite accéder à votre instance Gogs, ajouter des utilisateurs et créer des référentiels.

Gogs utilise une base de données pour son stockage principal. Il prend en charge MySQL, MariaDB, PostgreSQL et TiDB. Si vous souhaitez utiliser l’un de ces puissants moteurs de base de données, vous devez le localiser et l’installer vous-même avant d’installer Gogs. Pour les petites équipes, vous pouvez utiliser SQLite3. Si vous optez pour SQLite3, il est installé pour vous. Bien sûr, vous devrez avoir git installé aussi.

Téléchargez le binaire approprié.

• Pour la plupart des distributions Linux modernes, téléchargez le fichier « Linux amd64 ».
• Si vous utilisez une version 32 bits de Linux, téléchargez le fichier « Linux 386 ».
• Si vous installez sur un Raspberry Pi 2 ou plus tôttéléchargez le fichier « Linux armv7 ».
• Si vous installez sur un Raspberry Pi 3, 3+ ou plus tardtéléchargez le fichier « Linux armv8 ».
• Si vous utilisez un Mac Intel, téléchargez le fichier « macOS amd64 ».
• Pour un Apple Silicon Mac, téléchargez le fichier « macOS arm64 ».

Nous avons téléchargé le fichier ZIP « Linux amd64 », pour une installation sur un ordinateur 64 bits avec Ubuntu 22.10. Le fichier est petit (environ 25 Mo seulement), alors ne soyez pas surpris s’il se télécharge très rapidement. C’est normal.

Localisez le fichier dans votre système de fichiers. Si vous avez conservé l’emplacement de téléchargement par défaut de votre navigateur, le fichier se trouvera probablement dans votre répertoire « ~/Downloads ». Faites un clic droit dessus et sélectionnez « Extraire » dans le menu contextuel. Certains navigateurs de fichiers peuvent utiliser « Extraire ici » à la place.

Un répertoire est extrait du fichier ZIP. Il porte le nom du fichier téléchargé. Dans notre cas, il s’appelait « gogs_0.11.91_linux_amd64 ».

Double-cliquez sur le répertoire extrait et vous verrez un autre répertoire appelé « gogs ».

Double-cliquez sur le répertoire « gogs ». Vous verrez les fichiers et répertoires Gogs. Faites un clic droit dans la fenêtre du navigateur de fichiers et sélectionnez « Ouvrir dans le terminal » dans le menu contextuel.

Pour démarrer votre instance Gogs, saisissez cette commande :

./gogs web

Gogs se lance et vous indique qu’il écoute sur le port 3000.

Connectez-vous à votre serveur Gogs en ouvrant un navigateur Web et en accédant à l’adresse IP ou au nom de réseau de l’ordinateur sur lequel Gogs s’exécute. Ajoutez « :3000 » après l’adresse IP ou le nom du réseau. N’incluez aucun espace blanc.

Si vous naviguez sur l’ordinateur sur lequel Gogs s’exécute, vous pouvez utiliser « localhost » comme nom de machine, comme ceci « localhost:3000 ». Notre ordinateur Gogs s’appelle « ubuntu-22-10.local », donc à partir d’un ordinateur différent sur le même réseau, l’adresse à laquelle nous devons naviguer est « ubuntu-22-10.local:3000 », y compris le numéro de port.

La première fois que vous faites cela, vous verrez le formulaire qui capture certaines informations de configuration initiale.

La première chose que nous devons faire est de sélectionner « SQLite3 » dans le menu déroulant « Type de base de données » et d’entrer votre nom d’utilisateur dans le champ « Exécuter l’utilisateur ».

Si vous souhaitez configurer des notifications par e-mail, vous devrez configurer quelques étapes supplémentaires. Vous devrez relayer les e-mails via un serveur de messagerie SMTP (Simple Mail Transfer Protocol) que vous êtes autorisé à utiliser. Si vous êtes un utilisateur de Google Gmail, vous pouvez utiliser le serveur SMTP Gmail de Google.

Cela nécessitera des paramètres sur le serveur de messagerie pour permettre à votre compte d’accepter et de relayer l’e-mail. Ces paramètres varient d’un serveur de messagerie à l’autre.

Gogs vous demande de saisir les informations suivantes concernant votre serveur de messagerie.

• Hôte SMTP: L’adresse et le port du serveur de messagerie. Dans notre exemple, il s’agit du serveur SMTP de Google sur smtp.gmail.com:587.
• De: L’adresse e-mail à partir de laquelle l’e-mail sera envoyé. Pour Gmail, il doit s’agir de l’adresse e-mail Gmail du compte que vous utilisez.
• E-mail de l’expéditeur: Doit être le même que ci-dessus. Il s’agit de l’ID de compte de messagerie que Gogs utilisera pour communiquer avec le serveur SMTP.
• Mot de passe de l’expéditeur: C’est ne pas le mot de passe du compte Gmail. C’est le mot de passe spécifique à l’application que vous obtenez de Google lorsque vous configurez votre compte pour autoriser une application à envoyer des e-mails en votre nom.
• Activer la confirmation d’inscription: Pour que Gogs vérifie les e-mails des utilisateurs, cochez cette case. Les nouveaux utilisateurs recevront un e-mail contenant un lien. Ils doivent cliquer sur pour prouver que l’adresse e-mail est authentique et sous leur contrôle.
• Activer la notification par courrier: Cochez cette case pour autoriser les notifications par e-mail de Gogs.

Bien sûr, si vous ne voulez pas être harcelé par des e-mails, vous pouvez ignorer tous les paramètres de messagerie.

Cliquez sur le bouton bleu « Installer Gogs » lorsque vous êtes prêt à continuer. Gogs écrit un fichier de configuration, initialise le stockage de la base de données et démarre votre instance Git.

Vous verrez la page d’accueil principale de Gogs.

Le premier compte d’utilisateur que vous créez recevra automatiquement des droits d’administrateur. Cliquez sur le lien « S’inscrire ».

Remplissez le formulaire « S’inscrire » avec votre nom de compte, un mot de passe pour ce compte (entrez-le deux fois) et les chiffres du Captcha. Cliquez sur le bouton vert « Créer un nouveau compte ». Vous verrez la page « Connexion ».

Entrez votre nom de compte et votre mot de passe, puis cliquez sur le bouton vert « Connexion ».

Une visite rapide de Gogs

Si vous êtes familier avec une autre instance Git accessible sur le Web, vous vous y retrouverez très facilement dans Gogs.

La vue « Tableau de bord » de Gogs est un peu clairsemée jusqu’à ce que vous disposiez d’un référentiel avec lequel travailler. Cliquez sur le bouton bleu « + » et remplissez le formulaire « Nouveau référentiel ».

Il demande un nom de référentiel, qu’il soit privé ou public, et une description.

Les trois champs suivants créent des fichiers à partir de modèles.

• Le menu « .gitignore » vous permet de sélectionner un modèle pour votre fichier « .gitignore » configuré avec des paramètres selon les langues sélectionnées. Vous pouvez faire plus d’un choix dans ce menu, pour répondre aux référentiels qui utilisent un mélange de technologies de développement.
• Le menu « Licence » vous permet de choisir une licence dans une liste complète.
• Le menu « Readme » a une seule option, un fichier « README.md » par défaut.

Cochez la case « Initialiser ce référentiel avec les fichiers et modèles sélectionnés », puis cliquez sur le bouton vert « Créer un référentiel ».

Votre nouveau dépôt s’affiche pour vous. Gogs a créé nos trois fichiers standard pour nous et les a ajoutés au référentiel avec le message de validation « Commit initial ».

Nous avons cloné le référentiel sur notre ordinateur, ajouté un fichier appelé « ack.c », l’avons validé et l’avons poussé vers notre référentiel Gogs distant. Tout cela a été fait à l’aide des commandes Git standard.

Comme prévu, notre nouveau fichier apparaît dans notre référentiel Gogs.

Cliquer sur un fichier nous montre le contenu du fichier individuel. Les fichiers Markdown sont interprétés pour vous, avec des en-têtes, des liens, des listes et toutes les autres fonctionnalités de Markdown. Les fichiers « README.md » sont généralement écrits en Markdown.

En cliquant sur l’icône crayon « Modifier », nous pouvons directement éditer notre fichier « README.md ». Nous avons ajouté du texte, utilisé des balises Markdown pour insérer des hyperliens et des italiques, et validé nos modifications. Tout cela depuis Gogs.

De retour dans notre vue de référentiel, notre fichier « README.md » mis à jour s’affiche et l’entrée « README.md » dans la liste des fichiers affiche un nouveau message de validation et une heure de mise à jour.

Le serveur Git le plus simple – Bar None

Gogs est un triomphe absolu. Il allie parfaitement fonctionnalité et simplicité.

Prêt à l’emploi, il répondra aux besoins de la majorité des amateurs ou des petites équipes de développement. Certaines de ses options avancées sont activées en modifiant le fichier de configuration qui, par défaut, se trouve dans « ~/Downloads/gogs_0.12.10_linux_amd64/gogs/custom/conf/app.ini ». Notez que le chemin reflétera la version de Gogs que vous utilisez.

L’administration générale du système peut être effectuée à partir du panneau d’administration, accessible à l’adresse Your Profile > Admin panel.

Bien que la documentation de Gogs soit brève au point d’être concise, cela signifie qu’il est facile de trouver ce que vous cherchez et que les descriptions sont suffisamment détaillées pour que vous puissiez les suivre.

Si vous vous méfiez des référentiels hébergés dans le cloud qui sont finalement sous le contrôle d’autres personnes, envisagez d’utiliser Gogs localement. Vous ne perdrez pas la fonctionnalité, mais vous gagnerez le contrôle et la confidentialité garantie.