Déployer un projet Laravel avec GitLab CI/CD sur un VPS GitLab LWS

Déployer un projet Laravel peut vite devenir complexe sans automatisation. 😒Avec GitLab CI/CD, vous pouvez automatiser chaque étape : tests, build, transfert et mise en ligne. Grâce à un VPS GitLab LWS, vous bénéficiez d’un hébergement puissant, sécurisé et adapté au déploiement continu.✨

👇Dans ce guide, vous apprendrez à déployer un projet Laravel avec GitLab via un pipeline CI/CD personnalisé. 💥 Du dépôt initial à la mise en production automatique, chaque étape sera détaillée pour vous offrir un processus fluide, reproductible et fiable. L’objectif : allier performance, productivité et bonnes pratiques DevOps, même pour les petites équipes.✨

Objectif

👇L’objectif de cet article est de vous guider pas à pas pour déployer un projet Laravel avec GitLab CI/CD sur un VPS GitLab LWS.
Vous apprendrez à :

• Créer un dépôt GitLab avec code Laravel
• Configurer le serveur cible (VPS)
• Écrire un pipeline .gitlab-ci.yml
• Tester le déploiement et l’automatiser
• Exploiter les atouts d’un hébergement LWS optimisé pour GitLab CI

Prérequis

Voici ce dont vous avez besoin avant de commencer :

• Un compte GitLab actif
• Un projet Laravel fonctionnel (Laravel 9+ recommandé)
• Un VPS LWS avec accès root/SSH
• PHP 8.1+, Composer, Git, Apache ou Nginx installés sur le VPS
• Une base de données prête à l’emploi
• Une clef SSH privée/publique
• Notions de Git et de pipelines CI/CD

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

Étapes pour déployer un projet Laravel avec GitLab CI/CD sur un VPS GitLab LWS

1. Créer un dépôt GitLab avec GitLab LWS

• Créez un dépôt GitLab (privé ou public) via votre compte. Depuis votre machine locale Laravel :

git init
git remote add origin git@gitlab.com:votre-utilisateur/projet-laravel.git
git add .
git commit -m "Initial commit"
git push -u origin main

• Incluez dans le repo :
  • .env.example (pas .env !)
  • .gitignore pour exclure, vendor, node_modules, etc.
• Activez l’onglet CI/CD dans les paramètres GitLab.
• Activez le runner GitLab (Shell ou Docker).

En combinant un VPS GitLab LWS et GitLab.com, vous gardez le code, l’intégration et la livraison dans un même environnement, pour une chaîne DevOps simplifiée.

2. Préparer le VPS cible pour le déploiement

• Connexion SSH au VPS :

ssh root@IP_DU_VPS

• Installation des dépendances Laravel :

apt update && apt install php php-cli php-mbstring php-xml php-curl php-zip unzip git curl composer nginx mysql-server -y

• Clonage du projet dans /var/www/laravel :

cd /var/www
git clone git@gitlab.com:votre-utilisateur/projet-laravel.git laravel
cd laravel
composer install

• Configuration Laravel :

cp .env.example .env
php artisan key:generate
php artisan migrate

• Configuration Nginx (ou Apache) Pointage vers /public, activation SSL, logs personnalisés.
• Permissions :

chown -R www-data:www-data /var/www/laravel
chmod -R 775 storage bootstrap/cache

• Test local : Visitez http://IP_DU_VPS pour vérifier que Laravel fonctionne avant de lier GitLab CI/CD.

Ce VPS est maintenant prêt pour être déclenché à chaque push GitLab.

Besoin d’un serveur VPS performant et flexible ?

Découvrez nos offres VPS KVM haut de gamme : des ressources garanties et un contrôle total pour vos projets. Profitez d’un hébergement 100 % SSD, d’un accès root complet, le tout dans un datacenter en France. Démarrez dès maintenant à partir de 4,99 €/mois !

Je choisis mon VPS KVM

3. Configurer le pipeline GitLab (.gitlab-ci.yml)

Créez à la racine du projet un fichier .gitlab-ci.yml avec le contenu suivant :

stages:
  - test
  - deploy

variables:
  APP_ENV: production
  DEPLOY_USER: root
  DEPLOY_SERVER: IP_DU_VPS
  DEPLOY_PATH: /var/www/laravel

before_script:
  - 'which ssh-agent || ( apt-get update -y && apt-get install openssh-client -y )'
  - eval $(ssh-agent -s)
  - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add - > /dev/null
  - mkdir -p ~/.ssh
  - chmod 700 ~/.ssh
  - ssh-keyscan $DEPLOY_SERVER >> ~/.ssh/known_hosts

test:
  stage: test
  image: php:8.1
  script:
    - apt update && apt install git unzip curl -y
    - curl -sS https://getcomposer.org/installer | php
    - php composer.phar install
    - php artisan test

deploy:
  stage: deploy
  image: alpine
  script:
    - ssh $DEPLOY_USER@$DEPLOY_SERVER "cd $DEPLOY_PATH && git pull origin main && composer install --no-dev && php artisan migrate --force"
  only:
    - main

Ajoutez dans les variables CI/CD GitLab : SSH_PRIVATE_KEY, APP_KEY, DB_HOST, etc. Ne jamais committer .env ! Votre pipeline est à présent sécurisé, automatisé et efficace.

4. Tester le déploiement

• Validez .gitlab-ci.yml via GitLab > CI/CD > Lint.
• Push test :

echo "# test" >> README.md git add . && git commit -m "test ci" && git push

• Analysez le pipeline : GitLab va automatiquement lancer le job test et déployer via ssh si les tests passent
• Logs utiles : dans l’interface CI/CD, consultez chaque log pour déboguer.

Problèmes possibles :

Voici ci-dessous quelques problèmes que vous pouvez rencontrer :

• Accès SSH refusé (vérifiez la clé privée)
• composer install qui échoue
• Migrations bloquées

Bonnes pratiques pour déployer un projet Laravel avec GitLab CI/CD LWS

Déployer un projet Laravel avec GitLab CI/CD sur un VPS GitLab LWS demande une configuration propre et sécurisée. Voici les bonnes pratiques à suivre :

1. Préparer le VPS

Installez PHP (>=8.1), Composer, Nginx ou Apache, MySQL, et configurez correctement les permissions. Assurez-vous que le répertoire /var/www/ est accessible par l’utilisateur web.

2. Stocker les clés SSH

Ajoutez la clé SSH privée du déploiement comme variable sécurisée (CI_SSH_PRIVATE_KEY) dans GitLab, et associez la clé publique au VPS (~/.ssh/authorized_keys).

3. Automatiser le déploiement avec .gitlab-ci.yml

Créez un fichier .gitlab-ci.yml avec des étapes pour :

• Installer les dépendances via Composer

• Compiler les assets (avec Laravel Mix si nécessaire)

• Transférer les fichiers avec scp ou rsync

• Exécuter les migrations (php artisan migrate)

4. Séparer les environnements

Utilisez des branches distinctes pour staging et production. Limitez les déploiements automatiques à la branche main.

5. Sécuriser les données sensibles

Ne stockez jamais .env dans Git. Utilisez des variables d’environnement ou déployez le fichier .env manuellement via SSH.

6. Tester avant chaque push

Ajoutez des jobs pour tester l’application (lint, tests unitaires) avant le déploiement.

Quels sont les avantages du VPS GitLab LWS ?

Le VPS GitLab proposé par LWS (Ligne Web Services) offre une solution robuste pour héberger vos dépôts Git en toute autonomie. Contrairement à GitLab.com, cette offre VPS vous donne un contrôle total sur votre environnement, tout en restant simple à administrer.

• Hébergement privé et sécurisé : avec un VPS GitLab LWS, vos projets sont stockés sur un serveur dédié, isolé des autres utilisateurs. Cela garantit une confidentialité maximale, un point essentiel pour les entreprises et les équipes travaillant sur des projets sensibles ou confidentiels.

• Accès root complet : vous avez un accès root au serveur, ce qui vous permet d’installer, configurer et personnaliser GitLab selon vos besoins. Vous pouvez ajuster les ressources, ajouter des extensions ou intégrer des outils tiers pour un flux de travail sur mesure.

• Sauvegardes automatiques et snapshot : LWS inclut des sauvegardes régulières et des snapshots manuels, assurant la récupération rapide de vos données en cas de problème. Vous avez aussi la possibilité de programmer vos propres sauvegardes via GitLab.

• Performances garanties : chaque VPS dispose de ressources dédiées (CPU, RAM, disque SSD), garantissant la stabilité et la rapidité de l’interface GitLab, même avec plusieurs utilisateurs ou projets volumineux.

• Mises à jour simplifiées : LWS facilite les mises à jour du système et de GitLab avec des outils intégrés dans le panneau d’administration. Vous restez à jour sans complexité technique.
• Support technique basé en France : en cas de besoin, le support technique LWS est disponible 7j/7, en français, par ticket ou téléphone.

Un VPS GitLab LWS vous permet de centraliser le code, les runners et le serveur web dans une même machine. Moins de latence, plus de contrôle, moins de risques de dépendances externes. C’est une solution fiable pour freelances, agences ou startups tech.

Conclusion

Déployer un projet Laravel avec GitLab CI/CD devient une tâche simple, rapide et sécurisée grâce à l’automatisation. ✨Avec un VPS GitLab LWS, vous réunissez en un seul espace votre code, vos runners et votre production. 👆Ce guide vous a montré comment créer un pipeline .gitlab-ci.yml, préparer un VPS et effectuer un déploiement sans interaction manuelle. 📈 N’hésitez pas à adapter ce workflow selon vos projets (tests, staging, rollback). Désormais, chaque commit est synonyme de livraison continue, et chaque push peut devenir un gain de temps précieux.

Des questions ou des retours sur ce tutoriel ? Laissez un commentaire ci-dessous ! 💬