Jenkins¶

Dans cet article

• Jenkins. Fonctionnalités clés
• Fonctionnalités de déploiement
• Démarrage après le déploiement de Jenkins en tant que Managed App
• Démarrage après le déploiement de Jenkins depuis la Marketplace
• Authentification et menu de démarrage
• Commander un serveur avec Jenkins via l'API

Jenkins. Fonctionnalités clés¶

• Builds automatisés : Simplifie les processus de build pour les langages de programmation et frameworks populaires.
• Tests complets : S'intègre parfaitement à n'importe quel outil de test. Exécute automatiquement tous les types de tests, des tests unitaires aux intégrations complexes, garantissant la qualité du code à chaque étape.
• Livraison flexible : Automatise l'intégralité 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 l'erreur humaine.
• Builds évolutifs : Répartit 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 permet de gagner du temps de développement.
• Écosystème étendu : Offre plus de 1500 plugins pour une intégration avec presque n'importe quel outil de développement et plateforme DevOps.
• Pipelines puissants : Vous permet de décrire des processus CI/CD complexes sous forme de code en utilisant un Jenkinsfile.
• Notifications intelligentes : Informe votre équipe des résultats des builds et des tests 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 utilisateur.

Fonctionnalités de déploiement¶

Logiciels installés :

• Java Runtime Environment (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
• Jobs : /var/lib/jenkins/jobs
• Logs : /var/log/jenkins/jenkins.log

Démarrage après le déploiement de Jenkins en tant que Managed App¶

Après avoir déployé Jenkins en tant qu' application gérée, vous trouverez les éléments suivants dans l'onglet My Apps du panneau de contrôle du serveur :

• un lien vers l'application ;
• l'identifiant et le mot de passe pour l'accès ;
• des informations concernant l'utilisation et la gestion du service.

Pour plus de détails sur le fonctionnement avec les applications gérées, consultez les instructions.

Démarrage après le déploiement de Jenkins depuis la Marketplace¶

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 inclura l'adresse IP du VPS et les identifiants de connexion pour l'accès. Les clients de notre entreprise gèrent leur équipement via le panneau de gestion du serveur et l'API — Invapi.

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

• Lien pour accéder au panneau de configuration de Jenkins via l'interface web : dans le tag webpanel. Utilisez ce lien pour accéder à votre Jenkins.
• Pour référence : L'adresse par défaut pour accéder à Jenkins est http://[server_IP_address]: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 comporte plusieurs étapes.

Étape 1 : Déverrouiller Jenkins

1. Lors du premier lancement, vous verrez l'écran Unlock Jenkins.
2. Pour déverrouiller, saisissez le mot de passe administrateur généré automatiquement qui se trouve dans :
   • Le fichier sur le serveur : /var/lib/jenkins/secrets/initialAdminPassword
3. Copiez le mot de passe du 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 choisir Install suggested plugins pour les utilisateurs débutants.
2. L'installation des plugins sélectionnés commencera, affichée sous forme de liste avec une 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 — confirmation du 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 de PR et la variable d'environnement BUILD_URL.
5. Cliquez sur Save and Finish pour enregistrer les paramètres ou sur 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¶

Pour installer ce logiciel via l'API, suivez ces instructions.