Jenkins¶

Dans cet article

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

Jenkins. Fonctionnalités clés¶

• Builds automatisés: Simplifie les processus de construction pour les langages de programmation et cadres populaires.
• Tests complets: S'intègre sans effort avec n'importe quel outil de test. Exécute automatiquement tous les types de tests, du test unitaire aux intégrations complexes, assurant 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, réduisant les erreurs humaines.
• 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, économisant 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: Vous 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 des builds et tests via e-mail, Slack, Microsoft Teams et 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 de 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

Commencer après le déploiement de Jenkins¶

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

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

• Lien vers le panneau de contrôle 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 complète manuelle du logiciel.

Authentification et menu de démarrage¶

La configuration initiale de Jenkins implique plusieurs étapes.

Étape 1 : Déverrouiller Jenkins

1. Lors du 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 d'installation de plugins :
   • Install suggested plugins — installer les plugins recommandés considérés comme les plus utiles par la communauté Jenkins.
   • Select plugins to install — choisir manuellement les plugins qui conviennent 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 de 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 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 Jenkins, y compris les notifications par e‑mail, les mises à jour 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 complété toutes les étapes précédentes, vous verrez l'écran Jenkins is ready!. Cliquez sur Start using Jenkins pour passer à l'interface principale de Jenkins.

Commander un serveur avec Jenkins via API¶

Pour installer ce logiciel en utilisant l'API, suivez les instructions suivantes.