Installer Jenkins sur un VPS Ubuntu

Nous allons installer Jenkins sur un VPS Ubuntu 24.

Mais tout d'abord laissez moi vous présenter Jenkins.

🛠 Qu’est-ce que Jenkins ?

Jenkins est un outil open-source qui aide les développeurs à automatiser certaines tâches dans le processus de création d’un logiciel.

Vous pouvez voir Jenkins comme un robot de chantier pour votre projet de code : il travaille en arrière-plan et fait automatiquement des choses comme :

• Lancer des tests à chaque modification du code
• Construire votre application (compiler, créer un package…)
• Déployer votre application sur un serveur ou un site web
• Vous prévenir s’il y a des erreurs

🔁 À quoi ça sert concrètement ?

Supposons que vous travaillez sur un site web. À chaque fois que vous modifiez le code :

• Jenkins détecte automatiquement la nouvelle version.
• Il exécute des tests pour s'assurer que tout fonctionne.
• Si tout est bon, il peut envoyer le site à la production (le mettre en ligne).
• Sinon, il t'envoie une alerte avec les erreurs.

💡 Pourquoi c’est utile ?

• Gain de temps : vous n’avez plus besoin de tout faire manuellement.
• Moins d’erreurs humaines : Jenkins suit toujours les mêmes étapes.
• Travail en équipe fluide : chaque membre peut coder sans casser le travail des autres.

Pré-requis

Avant de commencer, il faut une version de Java installé sur la machine:

    sudo apt update
    sudo apt install fontconfig default-jre

Une fois qu'on a installé Java , on va installer une LTS de Jenkins :

    sudo wget -O /etc/apt/keyrings/jenkins-keyring.asc \
      https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key
    echo "deb [signed-by=/etc/apt/keyrings/jenkins-keyring.asc]" \
      https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
      /etc/apt/sources.list.d/jenkins.list > /dev/null
    sudo apt-get update
    sudo apt-get install jenkins

Une fois installé, on va créer un fichier service:

Dans /etc/systemd/system/jenkins.service , je mets ceci (fournit par Jenkins dans sa documentation):

    # /etc/systemd/system/jenkins.service
    #
    # This file is managed by systemd(1). Do NOT edit this file manually!
    # To override these settings, run:
    #
    #     systemctl edit jenkins
    #
    # For more information about drop-in files, see:
    #
    #     https://www.freedesktop.org/software/systemd/man/systemd.unit.html
    #
    
    [Unit]
    Description=Jenkins Continuous Integration Server
    Requires=network.target
    After=network.target
    
    [Service]
    Type=notify
    NotifyAccess=main
    ExecStart=/usr/bin/jenkins
    Restart=on-failure
    SuccessExitStatus=143
    
    # /etc/systemd/system/jenkins.service.d/override.conf
    [Service]
    Environment="JAVA_OPTS=-Djava.awt.headless=true"
    Environment="JENKINS_PORT=8081"

Puis on peut rafraîchir tout ça avec:

    sudo systemctl daemon-reload
    
    # Puis lancer
    sudo systemctl start jenkins

A partir de maintenant, on peut accèder à Jenkins via l'IP du serveur sur le port 8081 , mais je vous conseille de prévoir une redirection domaine depuis votre fournisseur.

En bonus, on va configurer Nginx pour Jenkins

Dans /etc/nginx/sites-available/jenkins.conf :

    upstream jenkins {
        server 127.0.0.1:8081;
    }
    
    server {
      server_name <domain>;
    
      location / {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-NginX-Proxy true;
        proxy_pass http://jenkins;
        proxy_redirect off;
    
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
      }
      
      error_page 404 /404.html;
      location = /404.html {
          internal;
      }
    }

Maintenant, on va cloner la conf pour activer le site sur Nginx:

    cd /etc/nginx/sites-enabled
    ln -s ../sites-available/jenkins.conf ./

C'est parti vous avez configuré Jenkins sur votre serveur !

Conclusion

Je vais pouvoir mettre en place des outils de déploiement et CI grâce à ce serveur.

On verra comment faire un pipeline dans un prochain article.