Configurer une CI/CD avec GitLab auto-hébergé chez LWS

L’automatisation du déploiement est devenue une étape incontournable dans tout processus de développement moderne. ✨Avec GitLab CI/CD, chaque commit peut automatiquement déclencher des tests, des builds ou des déploiements, sans intervention manuelle. Cette approche améliore la productivité, la fiabilité et réduit les erreurs humaines. 🎉Dans un environnement autohébergé, comme un VPS chez LWS, GitLab offre un contrôle total sur la chaîne d’intégration et de déploiement continue.⚓

Cela signifie que vous n’êtes plus dépendant de services tiers pour gérer votre infrastructure CI/CD. ⚡Dans cet article, nous allons créer un fichier .gitlab-ci.yml, configurer une CI/CD avec GitLab, exécuter un pipeline de test, et voir pourquoi héberger sa propre CI/CD sur un VPS GitLab LWS est une solution durable et sécurisée.✔

Objectif

Ce guide vous apprendra à déployer une CI/CD complète avec GitLab sur un serveur privé. Vous verrez :

• Comment écrire un fichier .gitlab-ci.yml,

• Configurer un runner (Docker ou Shell),

• Lancer un pipeline simple,

• Comprendre la gestion des jobs, logs, statuts.

Vous saurez aussi pourquoi l’auto-hébergement de GitLab CI/CD sur VPS LWS vous offre maîtrise, confidentialité et souplesse, notamment pour les équipes souhaitant une solution technique 100 % configurable.💯

Prérequis

Avant de commencer, vous devez disposer des éléments suivants :

• Un serveur VPS LWS avec GitLab Community Edition installé.

• Un accès administrateur au GitLab et au système (SSH).

• Git installé sur votre poste de travail.

• Docker installé sur le serveur si vous souhaitez utiliser un runner Docker.

• Une connexion Internet stable pour les tests CI/CD.

Assurez-vous également d’avoir un projet actif sur GitLab (privé ou public) et les droits Maintainer pour pouvoir y configurer la CI/CD.
Enfin, un minimum de connaissances en YAML, bash ou Docker est un plus pour personnaliser les pipelines.

Création d’un fichier .gitlab-ci.yml

Le fichier .gitlab-ci.yml est le cœur de la CI/CD GitLab. Il doit être placé à la racine du dépôt Git. Ce fichier, écrit en YAML, définit les étapes (stages) à exécuter, les jobs, les environnements et les conditions d’exécution.

Voici un exemple de structure basique :

stages:
  - test

unit_tests:
  stage: test
  script:
    - echo "Exécution des tests unitaires"
    - pytest tests/

Dans ce cas :

• La pipeline a une seule étape : test

• Elle exécute un job unit_tests qui lance une commande

Les jobs sont exécutés dans l’ordre des stages, ce qui permet d’enchaîner des étapes comme build, test, deploy.
Vous pouvez aussi spécifier :

• des environnements Docker

• des variables d’environnement

• des règles (only, except) pour limiter quand le pipeline s’exécute

Chaque fois que vous poussez une modification de ce fichier, GitLab tente d’exécuter la CI/CD. En cas d’erreur de syntaxe YAML, la pipeline échouera avant même de lancer les jobs.
Un bon .gitlab-ci.yml doit rester simple, clair et versionné avec votre code.

Configuration d’un runner GitLab (Docker, Shell)

Un runner GitLab est un agent qui exécute les jobs définis dans .gitlab-ci.yml. Vous pouvez en enregistrer plusieurs types : Shell, Docker, Kubernetes, etc.

Sur un VPS LWS, vous pouvez facilement configurer un runner Docker ou runner Shell local. Pour procéder rapidement, rendez-vous dans le panel d’administration.

Ensuite, rendez-vous dans la section « CI/CD › runners ». Sur la page qui vous est présentée, cliquez sur le bouton « Create instance runner ».

Vous devez alors remplir tous les champs présentés, notamment les tags, cocher les options relatives et diffusez le temps pendant lequel, celui va être exécuté.Une fois que vous avez terminé, cliquez sur le bouton « Create runner » et vous serez redirigé vers la page de confirmation. Vous avez ainsi la structure de la commande de votre runner que vous pouvez copier pour l’exécuter dans l’interface de ligne de commandes.

Vous pouvez retrouver tous les runners dans la section dédiée.

La deuxième façon de créer un runner consiste à utiliser la console de commande. Voici comment procéder et les différentes commandes que vous pouvez utiliser :

Installation du runner :

1. Connectez-vous à votre VPS :

ssh root@votre-ip

2. Téléchargez et installez le GitLab Runner :

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | bash
apt install gitlab-runner

Enregistrement :

Pour enregistrer le runner :

gitlab-runner register

Répondez aux questions :

• URL de GitLab

• Jeton : disponible dans la section « GitLab > Admin > Runners ».

• Description, tags

• Type d’exécution (docker ou shell)

Pour Docker :

Vous devez avoir Docker installé et actif. Vous pouvez ensuite définir l’image à utiliser (ex. : python:3.10) dans le fichier .gitlab-ci.yml.

Une fois qu’il est configuré, votre runner peut exécuter automatiquement tous les jobs dès qu’un pipeline démarre.

Exemple de pipeline simple

Voici un exemple fonctionnel d’un pipeline simple pour un projet Python avec tests :

stages:
  - lint
  - test

lint_code:
  stage: lint
  image: python:3.10
  script:
    - pip install flake8
    - flake8 src/

run_tests:
  stage: test
  image: python:3.10
  script:
    - pip install -r requirements.txt
    - pytest tests/

Explication :

• stages : définit les phases de la pipeline. Ici, lint puistest

• lint_code : vérifie le style du code avec flake8

• run_tests : exécute les tests avec pytest

Chaque job utilise une image Docker officielle. Vous pouvez adapter cela à n’importe quel langage : Node.js, PHP, Java, etc.

Ce pipeline se déclenche à chaque push dans GitLab. Il garantit que le code est propre (lint) et fonctionnel (tests) avant tout déploiement. Ce type de pipeline constitue la base d’un système CI/CD robuste et peut ensuite être étendu à des jobs de build, déploiement ou vérifications de sécurité.

Visualisation et gestion des pipelines

Une fois que votre pipeline est lancé, GitLab fournit une interface dédiée pour en suivre l’exécution.
Depuis votre projet :

• Accédez à la section « CI/CD > Pipelines » pour voir la liste des pipelines récents

• Cliquez sur un pipeline pour voir le détail : jobs, statuts, logs, durée

Chaque job s’exécute dans un environnement isolé. Vous pouvez consulter ses logs en temps réel, relancer un job individuellement, ou redémarrer tout le pipeline si nécessaire.

Les échecs de jobs sont clairement identifiés avec des codes d’erreur et les logs complets. Cela facilite le debug rapide.

Vous pouvez également :

• créer des pipelines manuels

• ajouter des pipelines planifiés (cron)

• intégrer des règles de déclenchement par branche, tag, ou événement

L’interface GitLab rend la CI/CD visuelle, compréhensible et actionnable, même pour les équipes non devops.

Pourquoi configurer une CI/CD avec GitLab chez LWS ?

 

Héberger sa CI/CD sur un VPS GitLab chez LWS, c’est faire le choix de la maîtrise totale de ses pipelines et de ses données. Contrairement aux solutions cloud publiques, tout est localisé, configurable et isolé.

• Environnement clé en main : VPS préinstallé avec GitLab, prêt à l’emploi.

• Conformité RGPD : données hébergées en France, dans un cadre légal européen.

• Support francophone : assistance technique réactive et adaptée.

• Ressources évolutives : CPU, RAM et SSD ajustables selon vos besoins.

• Haute disponibilité : infrastructure robuste avec sauvegardes régulières.

• Sécurité renforcée : accès SSH sécurisé, isolation des projets, pare-feu activé.

• Coût maîtrisé : pas de frais cachés lors de l’exécution des pipelines.

• Maîtrise totale : liberté de configurer les runners, jobs et environnements.

• Performance : exécution rapide des jobs CI/CD, faible latence.

• Interopérabilité : compatibilité avec Docker, Kubernetes, runners distants, etc.

Besoin d'un serveur privé virtuel VPS sécurisé ?

LWS vous conseille sa formule d’hébergement sur VPS en promotion à -75% (offre à partir de 4,99€ par mois au lieu de 19,99 €). Non seulement les performances sont au rendez-vous mais vous profitez en plus d’un support exceptionnel.

Découvrir l'offre

Conclusion

Mettre en place une CI/CD GitLab sur VPS LWS, c’est accéder à une chaîne d’automatisation performante, sécurisée et personnalisable.💥
Avec un simple fichier .gitlab-ci.yml et un runner bien configuré, vous pouvez lancer des tests, contrôler la qualité, et déployer automatiquement vos projets. Cette solution auto-hébergée offre un contrôle total et une flexibilité précieuse pour les équipes techniques modernes.⚡
Si vous cherchez une alternative aux services SaaS fermés, LWS + GitLab CI/CD est une option sérieuse à considérer.

Lectures associées

---

• Initiation au Script Bash Linux avec exemples
• Démarrer avec un VPS GitLab clé en main chez LWS : Installation et premier dépôt
• Héberger un dépôt Git privé sur un VPS GitLab chez LWS
• IP dédiée : de quoi s’agit-il, en avez-vous besoin et comment l’obtenir ?

Grâce à ce guide, vous êtes désormais capable de configurer une CI/CD avec GitLab sur un VPS auto-hébergé chez LWS. Si vous avez des questions, ou souhaitez en savoir plus sur nos offres VPS GitLab, écrivez-nous dans la section dédiée aux commentaires.