Comment programmer l'exécution automatique d'une tâche freestyle ?

Ouvrez les déclencheurs de build et cochez « Build périodique », puis saisissez la syntaxe cron, par exemple H 2 * * * pour une exécution nocturne. Le H répartit la charge sur l'heure. L'interrogation du SCM utilise la même syntaxe, mais ne déclenche une build que lorsque le dépôt est modifié.

Où est-ce que Jenkins Stocker un travail freestyle sur disque ?

Chaque tâche est stockée dans JENKINS_HOME/jobs/, avec ses paramètres de formulaire dans config.xml, et chaque exécution se fait sous builds/. La sauvegarde de ce dossier suffit pour déplacer ou restaurer la tâche.

Comment créer une nouvelle tâche de construction dans Jenkins Projet Freestyle

⚡ Résumé intelligent

Jenkins Freestyle Project est une tâche de compilation répétable qui regroupe l'extraction du code source, les étapes de compilation et les actions post-compilation en une seule tâche configurable, créée entièrement via Jenkins Interface web sans écrire de code de pipeline.

(I.e. Définition: Un travail freestyle est Jenkins' type de projet à usage général, configuré par le biais de formulaires plutôt que par un Jenkinsfichier.
☑️ Pré-requis : Une course Jenkins Un contrôleur, un JDK sur l'agent de construction, le plugin Git et un dépôt accessible sont nécessaires au préalable.
✅ Dix étapes : Connectez-vous, créez un nouvel élément, nommez-le, définissez le dépôt, ajoutez une étape de compilation, enregistrez, compilez et lisez la sortie de la console.
🧪 Exemple concret : Un projet HelloWorld extrait de GitHub est compilé avec javac et exécuté avec java à l'intérieur d'un Windows Étape de construction par lots.
️ Carte de configuration : Six sections de formulaire — Général, Source Code Gestion, déclencheurs de compilation, environnement de compilation, étapes de compilation et actions post-compilation : toutes les options sont couvertes.
⚙️ Limite de portée : Les tâches freestyle conviennent à l'automatisation d'une seule tâche ; les tâches de livraison en plusieurs étapes relèvent plutôt d'un pipeline avec contrôle de version.

Qu'est-ce que la Jenkins Projet Freestyle ?

Jenkins Projet Freestyle Il s'agit d'une tâche de compilation, d'un script ou d'un pipeline répétable comprenant des étapes et des actions post-compilation. C'est une tâche améliorée pouvant couvrir plusieurs opérations. Elle vous permet de configurer des déclencheurs de compilation et offre une sécurité basée sur le projet pour votre Jenkins Le projet propose également des plugins pour vous aider à créer des étapes et des actions post-compilation.

Les types d'actions que vous pouvez effectuer dans un Jenkins Les étapes de compilation ou les actions post-compilation sont assez limitées. De nombreux plugins standard sont disponibles. Jenkins Projet Freestyle pour vous aider à surmonter ce problème.

Le schéma ci-dessous situe le travail freestyle à l'intérieur d'un cadre plus large. intégration continue boucle, depuis l'extraction du code source jusqu'aux actions post-compilation qui signalent le résultat.

Étapes pour créer un emploi dans Jenkins Projet Freestyle — Comment créer un emploi dans Jenkins

Conditions préalables à la création d'un Jenkins Travail freestyle

Avant que les dix étapes ci-dessous puissent être appliquées de bout en bout, quatre éléments doivent être réunis. L'absence de l'un d'entre eux est la raison habituelle pour laquelle une première construction freestyle échoue avec une balle rouge plutôt que bleue.

Une course Jenkins contrôleur. Jenkins Écoute par défaut sur le port 8080. Si Jenkins Le système n'est pas encore en marche, suivez le présentation de l'installation d'abord.
Un JDK installé sur la machine qui exécute la compilation. L'exemple fonctionnel se compile Java, De sorte javac doit figurer dans le PATH du contrôleur ou de l'agent qui exécute la tâche. Confirmez cela avec une seule ligne. java -version Étape de construction avant d'ajouter quoi que ce soit d'autre.
Le plugin Git. Le Git Cette option n'apparaît que sous Source Code La gestion une fois le plugin installé, via Gérer Jenkins > Plugins.
Un dépôt accessible. Un HTTPS public URL Aucun identifiant n'est requis. Un dépôt privé nécessite un identifiant stocké dans Jenkins Premièrement, sinon la procédure d'extraction échoue dès la première compilation.

Un compte auprès de Création d'emploi L'autorisation est également nécessaire — sur un nouvel utilisateur unique Jenkins Le compte administrateur le possède déjà.

Comment créer une nouvelle tâche de construction dans Jenkins

Le travail de construction freestyle est une option très flexible et facile à utiliser. Vous pouvez l'utiliser pour tout type de projet ; il est facile à configurer et bon nombre de ses options apparaissent dans d'autres tâches de construction. Vous trouverez ci-dessous un processus étape par étape pour créer un emploi Jenkins.

Étape 1) Connectez-vous à Jenkins

Créer un Jenkins Travail freestyle, connectez-vous à votre Jenkins tableau de bord en visitant votre Jenkins chemin d'installation. Généralement, il sera hébergé sur localhost à http://localhost:8080 Si vous n'avez pas encore suivi Installé Jenkins Dans un autre chemin, utilisez le chemin approprié URL pour accéder à votre tableau de bord comme indiqué ci-dessous Jenkins Exemple de création d'emploi.

Étape 2) Créer un nouvel élément

Cliquer sur "Nouvel article« » se trouve en haut à gauche de votre tableau de bord. La capture d’écran ci-dessous montre l’emplacement de ce lien.

Étape 3) Entrez les détails de l'article

Dans l'écran suivant,

Entrez le nom de l'élément que vous souhaitez créer. Nous utiliserons le « Hello world » pour cette démo.
Sélectionnez un projet Freestyle
Cliquez sur OK

Étape 4) Entrez les détails du projet

Saisissez les détails du projet que vous souhaitez tester. La page de configuration qui s'ouvre est affichée ci-dessous.

Étape 5) Accéder au dépôt URL

Sous la source Code Gestion, saisissez votre dépôt URLNous avons un dépôt de tests situé à l'adresse suivante : https://github.com/kriru/firstJava.git

Il vous est également possible d'utiliser un référentiel local.

Si votre dépôt GitHub est privé, Jenkins Nous validerons d'abord vos identifiants de connexion auprès de GitHub, puis nous extrairons le code source de votre dépôt GitHub.

Étape 6) Ajustez les paramètres

Maintenant que vous avez fourni tous les détails, il est temps de générer le code. Ajustez les paramètres sous le construire section pour construire le code au moment où vous le souhaitez. Vous pouvez même planifier la construction de manière périodique, à des heures définies.

En construction,

Cliquer sur "Ajouter une étape de construction »
Cliquer sur "Exécution Windows commande par lots» et ajoutez les commandes que vous souhaitez exécuter pendant le processus de construction.

Le menu déroulant qui répertorie les étapes de compilation disponibles ressemble à ceci.

⚠️ Note de version : récent Jenkins Les communiqués étiquetent cette zone Étapes de construction plutôt que des Se construisentet sur Linux ou macOS agents l'option équivalente est Exécuter le shellLe bouton s'appelle toujours ainsi. Ajouter une étape de construction.

Ici, j'ai ajouté les commandes java pour compiler le code java.

J'ai ajouté les commandes Windows suivantes :

javac HelloWorld.java
java HelloWorld

La boîte de commande contenant ces deux lignes est affichée ci-dessous.

Étape 7) Enregistrez le projet

Lorsque vous avez saisi toutes les données,

Cliquez à nouveau Appliquer
Enregistrer le projet.

Étape 8) Créer le code source

Maintenant, dans l'écran principal, cliquez sur le bouton Construire maintenant sur le côté gauche pour créer le code source.

Étape 9) Vérifiez l'état

Après avoir cliqué sur Build now, vous pouvez voir l'état de la build que vous exécutez sous Build History.

Étape 10) Voir la sortie de la console

Cliquez sur le numéro de build, puis sur « Sortie de la console » pour afficher l'état de la compilation. Un message de réussite devrait s'afficher si vous avez correctement suivi la procédure d'installation décrite ci-dessous. Jenkins Exemple de création d'un nouvel emploi.

En résumé, nous avons exécuté un programme HelloWorld hébergé sur GitHub. Jenkins Il extrait le code du dépôt distant et le compile en continu à une fréquence que vous définissez.

Jenkins Explication des sections de configuration d'un projet freestyle

La procédure décrite ci-dessus ne concerne que les champs nécessaires à l'exemple HelloWorld. La page de configuration est divisée en six sections de formulaire ; connaître le contenu de chacune facilite grandement la recherche des autres options.

Blog	Ce qu'il contrôle	Cadre typique
Généralités	Description de la tâche, suppression des anciennes versions, paramètres et indication de l'agent sur lequel la tâche s'exécute	Description plus une limite de rétention de construction
Gestion du code source	Quel dépôt extraire, avec quels identifiants et sur quelle branche ?	Git, un HTTPS URL, bifurquer `/master` or `/main`
Créer des déclencheurs	Qu'est-ce qui lance la construction automatiquement ?	Interroger le SCM, effectuer une compilation périodique ou utiliser un webhook depuis GitHub
Construire l'environnement	Des enveloppes sont appliquées autour de l'ensemble de la construction.	Supprimez l'espace de travail avant le début de la compilation ; ajoutez des horodatages au journal de la console
Étapes de construction	Les commandes qui effectuent le travail s'exécutent de haut en bas.	Exécution Windows Commande par lots ou exécuter une commande shell
Actions post-construction	Que se passe-t-il une fois les étapes terminées, quel que soit le résultat ?	ArchiExaminer les artefacts, publier un rapport de test, envoyer un courriel

Deux habitudes permettent d'éviter bien des débogages par la suite. Ajoutez les étapes de compilation dans l'ordre où elles doivent s'exécuter, car Jenkins Le processus les traite de haut en bas et s'arrête à la première erreur. Ensuite, il archive les éléments produits par la compilation, car l'espace de travail est réutilisé pour la compilation suivante tandis que les artefacts archivés sont conservés pour chaque numéro de compilation.

Projet freestyle ou pipeline : lequel choisir ?

Le mode libre n'est pas le seul type de projet disponible sur l'écran Nouvel élément, et il n'est pas toujours le plus adapté. Le tableau ci-dessous le compare à d'autres modes de réalisation. Emploi dans le pipeline sur les points qui déterminent la plupart des choix réels.

Point de comparaison	Projet Freestyle	Pipeline
Comment cela est défini	Les formulaires Web sont stockés dans le cadre de la tâche. `config.xml` sur la manette	A Jenkinsfichier validé avec le code de l'application
historique des modifications	Tenu par Jenkins, en dehors de votre dépôt	Revvisualisé et versionné comme n'importe quel autre fichier source
Étapes et travail parallèle	Une liste simple et concise des étapes de construction	Étapes nommées, branches parallèles et vue d'ensemble
Courbe d'apprentissage	Aucun script nécessaire	Nécessite la syntaxe déclarative du pipeline
Meilleur ajustement	Une compilation, un script, une tâche planifiée ou un apprentissage Jenkins	Flux de construction, de test et de déploiement en plusieurs étapes dans différents environnements

Une règle pratique : privilégiez le style libre lorsque la tâche est unique et que vous apprenez encore à maîtriser l’outil, puis passez à un travail plus complexe. Pipeline CI / CD dès qu'une deuxième étape est franchie ou qu'une révision du code est nécessaire. Les équipes qui s'associent Jenkins Les outils de construction permettent souvent d'atteindre rapidement ce point — un Maven et Selenium installation est un déclencheur courant pour le commutateur, et le même raisonnement s'applique à tout tests d'automatisation suite qui s'exécute en plusieurs phases.

FAQ

La sortie de la console indique la cause. Les trois causes les plus fréquentes sont : javac absent du PATH de l’agent, un dépôt privé sans informations d’identification enregistrées et un nom de branche incorrect. Corrigez la ligne signalée, puis relancez la compilation.

Ouvrez les déclencheurs de construction et cochez Construire périodiquement, puis saisissez la syntaxe cron telle que : H 2 * * * pour un jogging nocturne. H répartit la charge sur l'heure. Sondage SCM Utilise la même syntaxe, mais ne se compile que lorsque le dépôt a été modifié.

Choisissez Exécuter le shell depuis le menu Ajouter une étape de compilation plutôt que Exécuter Windows Commande par lots. L'option affichée dépend du système d'exploitation du contrôleur ou de l'agent auquel la tâche est liée, et non de votre propre machine.

Stockez le jeton ou la clé SSH une seule fois sous Gérer Jenkins > IdentifiantsSélectionnez-le ensuite dans le menu déroulant « Identifiants » de la source. Code Section de gestion. Jenkins Elle le valide avant le paiement, de sorte qu'une authentification incorrecte entraîne l'échec immédiat de la compilation.

Les outils d'apprentissage automatique analysent les journaux de la console et regroupent les échecs répétés, distinguant ainsi une véritable erreur de compilation d'un agent instable ou d'un délai d'attente dépassé. Ce tri vous permet de trouver rapidement l'information pertinente, sans avoir à parcourir manuellement un long journal.

Copilote GitHub Ce script génère le script batch ou shell lors d'une étape de compilation, et son interface en ligne de commande peut résumer un journal d'erreurs. Il ne permet pas de naviguer dans le formulaire de configuration ; il est donc important de vérifier chaque commande générée avant de l'enregistrer.

Ajouter Archiles artefacts en tant qu'action post-compilation et donnez-lui un modèle tel que **/*.class. ArchiLes fichiers ved sont stockés par numéro de build, ils survivent donc à la réutilisation ou au nettoyage de l'espace de travail lors de l'exécution suivante.

Chaque emploi vit dans JENKINS_HOME/jobs/<job-name>, avec les paramètres du formulaire dans config.xml et chaque course sous builds/La sauvegarde de ce dossier suffit pour déplacer ou restaurer le travail.