GitLab - 7.28 Lancer un pipeline GitLab en local

Avec un runner installé sur votre machine, le pipeline utilise vos propres ressources. Cette leçon vérifie les prérequis : port disponible, runner actif et Docker lancé. Elle montre ensuite comment lire un échec et le corriger.

Vérifier le port et le runner

Commencez par vérifier que le port 80 est libre. Si une tâche l'occupe, arrêtez-la ou choisissez un autre port dans votre pipeline, comme le port 5000.

Vérifiez ensuite que le runner est opérationnel, avec la commande de statut du runner.

Vérifier Docker

Le runner utilise Docker, donc Docker doit être lancé. Affichez sa version, puis la liste des images et des conteneurs. Une liste d'images vide signifie qu'aucune image n'est présente sur le système.

docker version
docker images
docker ps

Corriger l'erreur de droits

Au lancement, le job échoue avec une erreur d'autorisation lors de la connexion au démon Docker. Le runner n'a pas le droit d'accéder au socket Docker.

La solution consiste à ajouter l'utilisateur du runner au groupe docker, avec la commande montrée dans la vidéo. Relancez ensuite le pipeline manuellement, car le code n'a pas changé.

Le journal indique l'étape exacte où le job a échoué. Il faut donc le lire dans l'ordre, du début jusqu'à l'erreur.

Le résultat

Le job de construction crée une image à partir de l'image Python officielle, installe le module Flask, puis définit une variable d'environnement. Le job de déploiement lance le conteneur, et l'application répond sur le port 5000.

Sur ce runner local, l'image construite reste présente après le job. C'est pourquoi le déploiement réussit.

Les images construites restent dans le système après le job. La vidéo le vérifie en listant les images et les conteneurs en cours d'exécution.

En résumé

Vérifiez le port, le runner et Docker avant de lancer le pipeline en local. Une erreur d'autorisation Docker se règle en ajoutant le runner au groupe docker. Sur un runner local, les images restent présentes après le job.

Points clés

• Vérifiez qu'un port comme 80 est libre avant de lancer le pipeline.
• Le runner doit être opérationnel, et Docker doit tourner.
• Une erreur d'autorisation Docker signale un problème de droits du runner.
• Un runner local garde les images construites après le job.
• Les images restent présentes jusqu'à leur suppression manuelle.

Questions fréquentes

Que faire si le port 80 est occupé ?

Arrêtez la tâche qui l'utilise, ou changez de port dans le pipeline, par exemple le port 5000 comme dans la vidéo.

Pourquoi une erreur d'autorisation Docker apparaît-elle ?

Le runner n'a pas la permission d'accéder au moteur Docker. L'ajout du runner au groupe docker résout ce problème.

Les images sont-elles supprimées après le job ?

Non. Sur ce runner local, elles restent présentes jusqu'à ce que vous les supprimiez manuellement.