Jenkins¶

Dans cet article

• Jenkins. Fonctionnalités clés
• Fonctionnalités de déploiement
• Premiers pas après le déploiement de Jenkins
• Authentification et menu de démarrage
• Commander un serveur avec Jenkins via l'API

Jenkins. Fonctionnalités clés¶

• Compilations automatisées : Simplifie les processus de compilation pour les langages de programmation et frameworks populaires.
• Tests complets : S'intègre parfaitement avec tous les outils de test. Exécute automatiquement tous types de tests, des tests unitaires aux tests d'intégration complexes, garantissant la qualité du code à chaque étape.
• Livraison flexible : Automatise l'ensemble du processus de déploiement dans n'importe quel environnement. Déployez votre code directement dans les environnements de production en un seul clic, minimisant ainsi les erreurs humaines.
• Compilations évolutives : Distribue les tâches sur plusieurs agents, accélérant considérablement l'exécution et permettant le traitement parallèle des tâches, ce qui fait gagner du temps de développement.
• Écosystème étendu : Propose plus de 1500 plugins pour l'intégration avec presque tous les outils de développement et plateformes DevOps.
• Pipelines puissants : Permet de décrire des processus CI/CD complexes sous forme de code à l'aide de Jenkinsfile.
• Notifications intelligentes : Informe votre équipe des résultats de compilation et de test via e-mail, Slack, Microsoft Teams et d'autres canaux de communication.
• Sécurité fiable : Prend en charge divers systèmes d'authentification et d'autorisation (LDAP, OAuth, SSO) ainsi qu'une gestion détaillée des rôles utilisateurs.

Fonctionnalités de déploiement¶

Logiciels installés :

• Environnement d'exécution Java (JRE)
• Jenkins
• Répertoire personnel pour Jenkins : /var/lib/jenkins
• Fichier de configuration : /etc/default/jenkins
• Fichier du mot de passe administrateur : /var/lib/jenkins/secrets/initialAdminPassword
• Plugins : /var/lib/jenkins/plugins
• Tâches (Jobs) : /var/lib/jenkins/jobs
• Journaux : /var/log/jenkins/jenkins.log

Premiers pas après le déploiement de Jenkins¶

Après le paiement, un e-mail de notification sera envoyé à votre adresse e-mail enregistrée dès que le serveur sera prêt. Il contiendra l'adresse IP du VPS et les identifiants de connexion pour l'accès. Les clients de notre entreprise gèrent les équipements via le panneau de gestion des serveurs et l'API — Invapi.

Les données d'authentification peuvent être trouvées dans l'onglet Configuration >> Tags du panneau de gestion des serveurs ou dans l'e-mail envoyé :

• Lien pour accéder au panneau de contrôle de Jenkins via l'interface web : dans la balise webpanel. Utilisez ce lien pour accéder à votre Jenkins.
• Pour référence : L'adresse par défaut pour accéder à Jenkins est http://[adresse_IP_du_serveur]:8080. Cette option est utile lors d'une installation entièrement manuelle du logiciel.

Authentification et menu de démarrage¶

La configuration initiale de Jenkins implique plusieurs étapes.

Étape 1 : Déverrouiller Jenkins

1. Au premier lancement, vous verrez l'écran Unlock Jenkins.
2. Pour déverrouiller, entrez le mot de passe administrateur généré automatiquement trouvé dans :
   • Fichier sur le serveur : /var/lib/jenkins/secrets/initialAdminPassword
3. Copiez le mot de passe depuis le fichier spécifié et collez-le dans le champ Administrator password.
4. Cliquez sur Continue pour continuer.

Étape 2 : Configuration des plugins

1. Sur la page Customize Jenkins, vous avez deux options pour l'installation des plugins :
   • Install suggested plugins — installe les plugins recommandés considérés comme les plus utiles par la communauté Jenkins.
   • Select plugins to install — choisissez manuellement les plugins qui correspondent le mieux à vos besoins.

1. Il est recommandé de sélectionner Install suggested plugins pour les utilisateurs débutants.
2. L'installation des plugins sélectionnés commencera, affichée sous forme de liste avec la progression pour chaque plugin.

Étape 3 : Créer un compte administrateur

1. Après l'installation des plugins, vous verrez l'écran Create First Admin User.
2. Remplissez les champs suivants :
   • Username — nom d'utilisateur pour la connexion ;
   • Password — mot de passe pour la connexion ;
   • Confirm Password — confirmez le mot de passe ;
   • Full Name — votre nom complet ;
   • Email Address — votre adresse e-mail.
3. Après avoir rempli tous les champs, cliquez sur Save and Continue.
   • Si vous ne souhaitez pas créer un nouvel utilisateur, vous pouvez cliquer sur Skip and continue as admin, mais cette option n'est pas recommandée pour les environnements de production car elle réduit la sécurité et complique l'audit des actions des utilisateurs.

Étape 4 : Configurer l'URL de l'instance Jenkins

1. Sur l'écran Instance Configuration, configurez l'URL de Jenkins.
2. Le champ Jenkins URL suggérera une URL générée à partir de la requête actuelle.
3. Il est conseillé de définir une URL accessible pour les utilisateurs accédant à Jenkins.
4. L'URL est cruciale pour le bon fonctionnement de nombreuses fonctionnalités de Jenkins, y compris les notifications par e-mail, les mises à jour des PR et la variable d'environnement BUILD_URL.
5. Cliquez sur Save and Finish pour enregistrer les paramètres ou Not now pour configurer l'URL plus tard.

Après avoir terminé toutes les étapes précédentes, vous verrez l'écran Jenkins is ready!. Cliquez sur Start using Jenkins pour accéder à l'interface principale de Jenkins.

Commander un serveur avec Jenkins via l'API¶