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.