Avec la récente acquisition de GitHub par Microsoft, de nombreuses entreprises et organisations ont décidé de s'éloigner de GitHub et de s'orienter vers des alternatives. GitLab offre bien plus que des référentiels distants et le contrôle de source. Bien que GitLab soit un service payant avec différents niveaux de support et d'options d'hébergement, il dispose également d'une édition communautaire (CE) qui est gratuite pour tout le monde en installant sur ses propres configurations de serveur.

Avec GitLab, vous pouvez planifier vos projets et mettre en œuvre des méthodologies comme Agile pour les membres de votre équipe. Suivre les problèmes et le cycle de développement. Mettre en œuvre un pipeline CD/CI, maintenir des registres de conteneurs et automatiser la conteneurisation des versions nouvellement expédiées. Vous pouvez également rédiger de la documentation et maintenir des wikis privés, surveiller l'environnement et l'utilisation des ressources du logiciel à différentes étapes comme les tests ou la production.

Conditions préalables

Selon les exigences minimales de la communauté GitLab, vous avez besoin de :

1 vCPU mais 2 est recommandé pour des performances optimales
Au moins 4 Go de RAM avec 4 Go d'espace de swap
Accès root ou privilèges sudo sur le serveur

Si vous expérimentez sur votre réseau local (par exemple chez vous), vous n'avez pas besoin d'une adresse IP publique ou d'un nom de domaine complet (FQDN), mais pour des cas d'utilisation réels, il est fortement recommandé d'avoir :

Une IP publique statique sur le serveur où GitLab sera installé
Un FQDN pointant vers cette IP

Plus que toute autre chose, un FQDN vous aidera à intégrer GitLab avec LetsEncrypt, ce qui est tout à fait essentiel du point de vue de la sécurité et de la confidentialité.

Nous parlerons de l'intégration de LetsEncrypt, mais pour la plupart, la démo se fait sur un réseau local avec GitLab s'exécutant derrière un NAT avec une IP privée. Enfin, nous voulons que notre serveur exécute une installation propre Ubuntu 18.04 Serveur LTS afin d'imiter avec précision le scénario du monde réel.

Installation de dépendances et ajout de référentiels

La première étape que nous aurions besoin d'effectuer est la mise à jour et la mise à niveau habituelles du système :

$ sudo apt mise à jour
$ sudo apt upgrade -y

Ensuite, nous devons vérifier que les packages suivants - certificats-ca, propriétés-logicielles-communes et serveur openssh sont installés. Il y a de fortes chances que vous soyez déjà connecté à l'aide d'OpenSSH et que les autres packages sortent de la boîte avec Ubuntu 18.04. Néanmoins, c'est une bonne idée d'être minutieux.

$ sudo apt install ca-certificates openssh-server software-properties-common

Une dépendance importante qui peut nécessiter une certaine assistance lors de l'installation est Postfix, un agent de transfert de courrier. GitLab en a besoin pour communiquer avec les utilisateurs par e-mail.

$ sudo apt installer le suffixe

Ici, il vous sera demandé de sélectionner de quel type d'installation il s'agit, sélectionnez Site Internet, puis assurez-vous que le FQDN.

Ensuite, nous devons ajouter un nom de domaine, si vous utilisez une IP publique ou privée, vous pouvez simplement ajouter cette adresse IP également. J'ai configuré un DNS local et le GitLab est en cours d'installation sur Ubuntu.local. Si vous utilisez un nom de domaine complet, comme gitlab.Exemple.com pour votre instance GitLab, utilisez ce nom de domaine ici.

Nous sommes maintenant prêts à ajouter GitLab à notre liste de référentiels qui seraient ensuite installés.

$ curl https://paquets.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

Ce script installera quelques dépendances supplémentaires, ajoutera des clés gpg pour les référentiels officiels et ajoutera le référentiel à la liste des sources. Préparer notre système pour la dernière étape de l'installation.

Installation et configuration de GitLab

L'installation de GitLab est maintenant aussi simple que l'exécution :

$ sudo apt installer gitlab-ce

Cela peut prendre un certain temps, car le package lui-même est énorme (environ 470 Mo au moment d'écrire ces lignes) et le téléchargement et le déballage peuvent prendre un certain temps. Une fois cela fait, nous sommes maintenant prêts à configurer GitLab.

Ouvrir le fichier /etc/gitlab.rb en utilisant votre éditeur de texte préféré (en utilisant sudo privilèges) et éditez la ligne qui dit URL_externe comme indiqué ci-dessous:

Si vous l'installez sur le service d'hébergement public, avec un FQDN, vous pouvez l'ajouter comme valeur. Vous pouvez également utiliser https, au lieu de http. Donc si votre nom de domaine est gitlab.Exemple.com il sera saisi comme :

Mais nous utiliserons http, car il s'agit d'une installation locale.

Intégration LetsEncrypt (HTTPS)

Cette étape s'applique uniquement aux personnes utilisant un nom de domaine complet et ayant défini URL_externe utiliser https, à l'étape ci-dessus.

Dans le même fichier /etc/gitlab/gitlab.rb, recherchez la section qui concerne LetsEncrypt (recherchez « Let's Encrypt Integration ») et activez Let's Encrypt, puis ajoutez votre compte de messagerie actuel, au cas où LetsEncrypt voudrait vous informer des renouvellements de certificats non programmés/programmés.

Les deux lignes qui ont été modifiées ici sont :

#letsencrypt['enable'] = true
#letsencrypt['contact_emails'] = ['[email protected]']

Vous pouvez maintenant enregistrer le fichier et démarrer l'application GitLab avec la configuration modifiée.

$ sudo gitlab-ctl reconfigurer

C'est ça! Votre instance GitLab est opérationnelle. Utilisez votre navigateur pour visiter le panneau de contrôle sur http://IP_ADDRESS ou https://gitlab.Exemple.com au cas où vous auriez utilisé FQDN avec SSL.

La configuration initiale

Lors de la visite du site Web sur votre navigateur, il vous sera d'abord demandé de définir un mot de passe pour le "racine" utilisateur

Définissez un mot de passe, puis connectez-vous en tant qu'utilisateur "racine" en utilisant le même. À partir de là commence votre voyage gratuit sur GitHub. Prenez le contrôle de vos projets, ajoutez des membres à votre équipe et soyez à nouveau productif!

Conclusion

Bien que je pense personnellement que Microsoft a été un bon intendant de la communauté open source au cours des dernières années, il est toujours bon de savoir qu'il existe des options comme GitLab pour les utilisateurs qui veulent autre chose. Les monopoles ne sont jamais bons pour la communauté. Sur cette note, nous reviendrons sur le sujet de GitLab et verrons comment mettre en place un registre de conteneurs dans un suivi. Restez à l'écoute pour ça!