Installation de Jenkins avec Docker¶

Derrière chaque « ça se déploie tout seul » se cache souvent un vétéran discret : Jenkins. C'est le grand ancien de l'intégration continue — pas le plus élégant du lot, mais d'une robustesse et d'un écosystème de plugins que peu égalent. Le mettre en conteneur, c'est s'offrir un chef d'orchestre pour vos builds sans jamais polluer la machine hôte.

Le mot de passe qu'on cherche toujours au premier lancement

Au tout premier démarrage, Jenkins se verrouille avec un mot de passe d'amorçage qui n'est pas affiché dans l'interface. On le récupère dans les logs (docker logs) ou dans /var/jenkins_home/secrets/initialAdminPassword (voir plus bas). C'est le rite de passage classique — autant le savoir avant de chercher dix minutes.

Prérequis¶

Avant de démarrer, assurez-vous d’avoir :

Docker et Docker Compose installés — voir Installation Docker
Les droits sudo (ou être root)
Un volume Docker pour la persistance
Un réseau Docker dédié (optionnel mais recommandé)

1⃣ Créer un réseau Docker dédié (optionnel)¶

Ce réseau permet aux conteneurs Jenkins et agents associés de communiquer efficacement.

docker network create jenkins

2⃣ Lancer Jenkins dans un conteneur Docker¶

Commande complète¶

docker run \
  --name jenkins-docker \
  --detach \
  --privileged \
  --network jenkins \
  --network-alias jenkins \
  --publish 2080:8080 \
  --volume jenkins_data:/var/jenkins_home \
  jenkins/jenkins:lts

Explication des paramètres¶

Paramètre	Description
`--name jenkins-docker`	(Facultatif) Nom du conteneur Jenkins
`--detach`	Exécute le conteneur en arrière-plan
`--privileged`	Accorde des privilèges étendus (nécessaire pour Docker-in-Docker)
`--network jenkins`	Connecte Jenkins au réseau personnalisé nommé `jenkins`
`--network-alias jenkins`	Alias réseau interne permettant aux autres conteneurs de l’atteindre
`--publish 2080:8080`	Expose Jenkins sur le port `2080` de l’hôte
`--volume jenkins_data:/var/jenkins_home`	Persistance des données Jenkins
`jenkins/jenkins:lts`	Utilise l’image Docker officielle en version LTS (Long Term Support)

Accès à l'interface Jenkins¶

Une fois le conteneur démarré, accédez à l'interface Jenkins à l’adresse suivante :

http://localhost:2080

Récupérer le mot de passe administrateur¶

docker exec jenkins-docker cat /var/jenkins_home/secrets/initialAdminPassword

Copiez ce mot de passe et utilisez-le pour le premier accès à Jenkins.

Plugins & Configuration initiale¶

Lors du premier démarrage, Jenkins vous proposera :

L’installation des plugins recommandés
La création d’un premier utilisateur administrateur

Il est recommandé de suivre les suggestions par défaut pour une configuration rapide.

En résumé¶

Votre Jenkins tourne, isolé et persistant, prêt à encaisser vos pipelines. Deux réflexes de terrain avant de lui confier des projets sérieux : épinglez une version d'image plutôt que de suivre lts à l'aveugle sur une CI dont vous dépendez, et sauvegardez /var/jenkins_home — c'est là que vivent vos jobs, vos credentials et toute votre configuration. Le jour où une mise à jour de plugin tourne mal, vous serez heureux de pouvoir revenir en arrière.