AllInfo

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

admin
Gogs

Je ne veux 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.

Table des matières

Le problème Avec des référentiels hébergés dans le cloud
Qu'est-ce que Gogs ?
Comment installer Gogs
Une visite rapide de Gogs
Le serveur Git le plus simple – Aucun 

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.

RELATEDQu'est-ce que GitHub et à quoi sert-il ?

C'est pourquoi des services tels que GitHub, GitLab et BitBucket existent, et pourquoi ils ont connu une telle adoption et une telle 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 pour payer une licence commerciale, vous ne vous sentirez peut-être pas à l'aise de 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à qu'intervient Gogs.

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 êtes 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.

CONNEXE : Comment exécuter un programme Linux au démarrage avec systemd

Comment Installer Gogs

Pour installer Gogs, vous 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 également installer git.

Téléchargez le binaire approprié.

Nous avons téléchargé le “Linux amd64” Fichier ZIP, à installer sur un ordinateur 64 bits avec Ubuntu 22.10. Le fichier est petit – seulement environ 25 Mo – 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 dossier “~/Downloads” annuaire. Faites un clic droit dessus et sélectionnez “Extraire” depuis 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.”

< p>Double-cliquez sur le répertoire extrait et vous verrez un autre répertoire appelé “gogs.”

Double-cliquez sur le bouton “gogs” annuaire. Vous verrez les fichiers et répertoires Gogs. Cliquez avec le bouton droit dans la fenêtre du navigateur de fichiers et sélectionnez & #8220;Ouvrir dans le terminal & #8221; depuis le menu contextuel.

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

./gogsweb

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. Ajouter “: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” à partir du “Type de base de données” menu déroulant et entrez votre nom d'utilisateur dans le champ “Exécuter l'utilisateur” champ.

Si vous souhaitez configurer des notifications par e-mail, vous devez 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.

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 utilisateur que vous créez recevra automatiquement des droits d'administrateur. Cliquez sur “S'inscrire” lien.

Complétez le “S'inscrire” formulaire avec votre nom de compte, un mot de passe pour ce compte (saisissez-le deux fois) et les chiffres du Captcha. Cliquez sur le bouton vert “Créer un nouveau compte” bouton. Vous verrez le bouton "Connexion" page.

Entrez votre nom de compte et votre mot de passe, puis cliquez sur le signe vert Dans” bouton.

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.

Les Gogs “Tableau de bord” La vue est un peu clairsemée jusqu'à ce que vous ayez un référentiel avec lequel travailler. Cliquez sur le bleu “+” et remplissez le champ “Nouveau référentiel” form.

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.

Cochez la case “Initialiser ce référentiel avec les fichiers et modèles sélectionnés” case à cocher, puis cliquez sur la case verte “Créer un référentiel” bouton.

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'a validé et l'a poussé vers notre référentiel Gogs distant. Tout cela a été fait à l'aide de commandes Git standard.

Comme prévu, notre nouveau fichier s'affiche 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. “LISEZMOI.md” les fichiers sont généralement écrits en Markdown.

En cliquant sur le bouton “Modifier” icône crayon, nous pouvons directement modifier notre “README.md” dossier. Nous avons ajouté du texte, utilisé des balises Markdown pour insérer des hyperliens et des italiques, et validé nos modifications. Le tout depuis Gogs.

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

Le serveur Git le plus simple – Interdire aucun

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, disponible dans Votre profil > Panneau d'administration.

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 à 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 de fonctionnalités, mais vous gagnerez le contrôle et la confidentialité garantie.

CONNEXE : Comment vérifier et mettre à jour votre version de Git< /p> LIRE SUIVANT

Exit mobile version