Avec l'acquisition récente de GitHub par Microsoft, de nombreuses sociétés et organisations ont décidé de migrer de Github et de se diriger vers des alternatives. GitLab offre bien plus que les référentiels distants et le contrôle de la source. Alors que GitLab est un service payant avec différents niveaux d'options de support et d'hébergement, il a également une édition communautaire (CE) qui est gratuite pour que quiconque puisse utiliser 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. Mettez en œuvre des pipelines CD / CI, maintenez les registres des conteneurs et automatisant 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, dont vous avez besoin:

1. 1 VCPU mais 2 est recommandé pour des performances optimales
2. Au moins 4 Go de RAM avec 4 Go d'espace d'échange
3. Accès racine ou privilèges sudo sur le serveur

Si vous expérimentez sur votre réseau local (par exemple dans votre maison), vous n'avez pas besoin d'une IP publique ou d'un nom de domaine entièrement qualifié (FQDN), mais pour les cas d'utilisation du monde réel, il est fortement recommandé que vous ayez:

1. Une IP publique statique vers le serveur où Gitlab avec
2. Un FQDN pointant vers cette IP

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

Nous allons parler de l'intégration de LetSencrypt, mais pour la plupart, la démo est effectuée sur un réseau local avec GitLab qui se déroule 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 des dépendances et ajout de référentiels

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

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

Ensuite, nous devons vérifier que les packages suivants - ca-certificats, logiciels-properties-communs et OpenSSH-Server sont installés. Il y a de fortes chances que vous soyez déjà connecté à l'utilisation 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-certificats openSSH-server logiciel-properties-common

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

$ sudo apt install postfix

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

Ensuite, nous devons ajouter un nom de domaine, au cas où vous utilisez une IP publique ou privée, vous pouvez simplement ajouter cette adresse IP également. J'ai mis en place un DNS local et le gitlab est installé sur ubuntu.local. Si vous utilisez un FQDN, comme gitlab.exemple.com Pour votre instance GitLab, utilisez ce nom de domaine ici.

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

$ curl https: // packages.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 désormais aussi simple que la course:

$ sudo apt installer gitlab-c

Cela pourrait prendre un certain temps, car le package lui-même est énorme (environ 470 Mo au moment de la rédaction de cet article) et le téléchargement et le déballage pourraient prendre un certain temps. Une fois cela fait, nous sommes maintenant prêts à configurer GitLab.

Ouvrez le fichier / etc / gitlab.RB en utilisant votre éditeur de texte préféré (en utilisant Sudo privilèges) et modifiez la ligne qui dit external_url 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 entré comme:

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

LetSencrypt Integration (HTTPS)

Cette étape est applicable uniquement aux personnes utilisant un FQDN et ont réglé external_url utiliser https, Dans l'étape ci-dessus.

Dans le même fichier / etc / gitLab /gitlab.RB, Recherchez la section qui concerne le refroidissement (recherchez «Intégration de crypte») et permettez-nous de crypter, ainsi qu'ajoutant votre compte de messagerie actuel, au cas où LetSencrypt souhaite vous informer des renouvellements de certificats imprévus / planifiés / planifiés.

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

# letSencrypt ['activer'] = true
# LetSencrypt ['Contact_EMails'] = ['User @ exmaple.com ']

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

$ sudo gitlab-cctl reconfigurer

C'est ça! Votre instance gitlab est opérationnelle. Utilisez votre navigateur pour visiter le panneau de commande à http: // ip_address ou https: // gitlab.exemple.com Dans le cas où vous utiliseriez 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 la même chose. De là commence votre voyage gratuit Github. Prenez le contrôle de vos projets, ajoutez les membres de votre équipe et soyez à nouveau productif!

Conclusion

Alors que moi, personnellement, je pense 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 voir comment configurer un registre de conteneurs dans un suivi. Restez à l'écoute pour ça!