< Précédent | Suivant >

Leçon 8 : Jazz Team Builds

Cette section examine l'interface utilisateur de Jazz Team Build du point de vue d'un développeur intéressé par les fonctions de génération de Rational Team Concert. Toutefois, vous devrez réaliser certaines tâches de configuration habituellement accomplies par un administrateur chargé des générations ou des versions. Pour qu'une génération Jazz Team Build réponde aux besoins de votre projet, vous devrez personnaliser et adopter les scripts de génération en fonction de vos besoins spécifiques. Heureusement, Jazz Team Build est très facile à utiliser et vous pourrez rapidement voir comment il fonctionne comme s'il le faisait pour votre équipe.
Jazz Team Build occupe une place centrale dans Rational Team Concert. Il ne génère rien par lui-même mais fournit la structure requise pour extraire le travail de votre équipe depuis le référentiel de Rational Team Concert, le connecter aux scripts de génération et enregistrer les résultats dans Rational Team Concert. En tant qu'utilisateur de Rational Team Concert ayant besoin de produire des générations, vous pouvez suivre la production des générations et accéder à leurs résultats. Depuis que Rational Team Concert, existe, Jazz Team Build a été lui-même utilisé pour produire les générations de Rational Team Concert.
Comment Jazz Team Build fonctionne-t-il ? Voici son principe :
  1. Définir une planification : une génération s'effectue selon une planification que vous définissez. Souvenez-vous que, dans le cadre du contrôle des sources de Rational Team Concert, une équipe partage les travaux de développement via un ou plusieurs flux de travaux d'équipe.
  2. Contrôler les modifications : Quand il est temps pour une équipe de produire une nouvelle génération, Jazz Team Build contrôle si des modifications ont été apportées au contenu des flux de l'équipe et valide ces modifications (qu'on appelle alors des ensembles d'artefacts modifiés) dans son propre espace de travail de génération afin de disposer d'une copie actualisée des flux.
  3. Extraire le contenu du référentiel et produire la génération : le système de génération importe le contenu de l'espace de travail de génération dans le système de fichiers où les scripts de génération vont produire la génération.
  4. Publier les artefacts dans le référentiel : les artefacts générés sont publiés dans le référentiel de Rational Team Concert à l'intention des utilisateurs.
  5. Avertir que la génération est terminée : le statut de toutes les générations est communiqué en temps réel et vous êtes automatiquement informé quand les générations sont terminées.
Jazz Team Build comprend moteur de génération Jazz et le kit de génération Jazz. Ces composants sont faciles à installer et à utiliser. A partir de client Jazz, exécutez les tâches suivantes :
  • Définir un script de génération (le client Eclipse de client Jazz fera l'essentiel du travail pour vous).
  • Elaborer une définition de génération qui identifie le script de génération
  • Identifier le moteur de génération chargé de produire la génération définie
  • Démarrer le moteur de génération qui répondra aux requêtes de génération, produira les générations et publiera les résultats
Vous pourrez donc demander une génération, examiner les résultats et naviguer dans l'interface utilisateur de génération comme si vous étiez un développeur ou un utilisateur de la génération produite par Jazz Team Build.
Remarque : La procédure de configuration peut parfois être assez longue. Vous pouvez faire une pause maintenant si vous le désirez. Si vous décidez de ne pas continuer la configuration des générations, il est recommandé de lire la section qui suit, qui présente l'interface utilisateur de Jazz Team Build. Elle vous apprendra comment demander des générations et examiner les résultat.

Configuration d'un espace de travail Eclipse pour le membre de l'équipe de génération

Dans ce tutoriel, le membre de l'équipe de génération que vous avez créé au cours d'une leçon précédente est l'utilisateur de génération dédié. Créez et configurez un nouvel espace de travail Eclipse pour le pour le membre de l'équipe de génération.
Pour créer et configurer un nouvel espace de travail Eclipse pour le pour le membre de l'équipe de génération, procédez comme suit :
  1. Accédez à un nouvel espace de travail Eclipse.
  2. Créez une connexion de référentiel.
  3. Connectez-vous à la zone de projet Prelude.
Pour plus d'informations, voir Leçon 2 : Connexion. Une fois la configuration terminée, votre vue Artefacts de l'équipe doit s'afficher comme suit :

espace de travail Eclipse du membre de l'équipe de génération

Création d'un script de génération

Pour créer un script de génération :
Vérifiez qu'il existe une connexion avec le référentiel et que vous êtes connecté.
  1. Dans la vue Packages, cliquez avec le bouton droit de la souris sur un projet puis cliquez sur Exporter.
  2. Dans l'assistant Exporter, dans la page Sélectionner, sous Général, sélectionnez Fichiers de génération Ant puis cliquez sur Suivant.
  3. Dans la page Exporter, vérifiez que votre projet et toutes les cases à cocher sont sélectionnées puis cliquez sur Terminer.
Un fichier nommé build.xml est ajouté au projet. Ce fichier utilise le langage de script Ant. Ce script compilera le projet et produira des fichiers Java™. Notez qu'il s'agit d'une modification sortante.

Fichier build.xml ajouté à la vue Packages

Avertissement : Ne publiez pas le script Ant pour le moment.

Création d'un espace de travail de référentiel dédié

Vous pouvez créer un espace de travail de référentiel dédié qui sera utilisé par la définition de génération Jazz pour votre projet. Pendant une génération, moteur de génération Jazz , qui est connecté au référentiel Jazz à l'aide d'un ID utilisateur préaffecté, utilise cet espace de travail de génération pour identifier le contenu à générer. Il commence par accepter les modifications entrantes depuis le flux de l'équipe puis charge le contenu de l'espace de travail de génération dans le système de fichiers local en vue du traitement.
Pour créer un espace de travail de référentiel de génération dédié :
  1. Dans la vue Artefacts de l'équipe, cliquez à l'aide du bouton droit de la souris sur Mes espaces de travail de référentiel, puis cliquez sur Nouveau > Espace de travail de référentiel.
  2. Dans l'assistant Nouvel espace de travail de référentiel, dans la page Sélection d'un flux, cliquez sur le bouton Transmettre à un flux puis, dans le volet situé en dessous, sélectionnez Flux équipe 1 (Equipe 1).
  3. Cliquez sur Suivant.
  4. Dans la page Nouvel espace de travail de référentiel, tapez le nom de l'espace de travail de génération Espace de travail de génération Equipe 1, puis cliquez sur Suivant.
  5. Dans la page de lecture des droits d'accès, vérifiez que Public est sélectionné, puis cliquez sur Suivant.
  6. Dans la page Composants à ajouter, confirmez la sélection du composant du flux et décochez la case Charger l'espace de travail de référentiel après sa création.
  7. Cliquez sur Terminer. L'espace de travail de référentiel de génération s'affiche dans votre vue.

    Espace de travail de référentiel de génération ajouté à la vue Mes espaces de travail de référentiel.

Création d'une définition et d'un moteur de génération

Vous pouvez maintenant créer une définition de génération Jazz pour votre projet. La définition de génération est configurée pour utiliser le nouvel espace de travail de génération. Lorsque la génération s'exécute, elle peut donc accepter toutes les modifications du flux d'équipe avant le démarrage de la génération.
Pour créer une définition de génération :
  1. Dans la vue Artefacts de l'équipe, développez le dossier du projet.
  2. Cliquez avec le bouton droit de la souris sur Générations puis cliquez sur Nouvelle définition de génération.
  3. Dans l'assistant Nouvelle définition de génération, dans la page Nouvelle définition de génération, acceptez les valeurs par défaut et cliquez sur Suivant.
  4. Dans la page Informations générales, dans le volet Modèles de génération disponibles, sélectionnez Moteur de génération Jazz - Ant puis cliquez sur Suivant.
  5. Dans la page Pré-génération, sélectionnez Jazz Source Control puis cliquez sur Suivant.
  6. Dans la page Post-génération, acceptez les valeurs par défaut puis cliquez sur Suivant.
  7. Dans la page Configuration supplémentaire, vérifiez que toutes les options sont sélectionnées puis cliquez sur Terminer. L'éditeur Définition de génération s'affiche.
  8. Créer un moteur de génération pour la définition de génération :
    1. Dans le volet Moteurs de génération de support, cliquez sur Créer un moteur.
    2. Dans la boîte de dialogue Créer un moteur de génération, dans la zone ID moteur, entrez PreludeBuildEngine.
    3. Cliquez sur OK.
  9. Cliquez sur l'onglet Jazz Source Control de l'éditeur Définition de génération.
  10. Dans le volet Options de chargement, dans la zone Répertoire de chargement, entrez fetched.
  11. Pour spécifier un espace de travail de génération, procédez comme suit :
    1. Dans la sous-fenêtre Espace de travail de génération, cliquez sur Sélectionner.
    2. Dans la sous-fenêtre Eléments correspondants de la boîte de dialogue Sélection d'un flux ou d'un espace de travail, sélectionnez Espace de travail de génération Equipe 1 puis cliquez sur OK. .
  12. Cliquez sur l'onglet Ant.
  13. Dans le champ Fichier de génération, entrez le chemin suivant : fetched/projectname/build.xml, où projectname est le nom de votre projet Java. Dans le cadre de ce tutoriel, nous utilisons le projet HelloWorld.
  14. Dans la zone Répertoire principal Java, entrez le nom de chemin de votre compilateur Java. Par exemple, entrez C:\Program Files\IBM\TeamConcert\jdk.
  15. Cliquez sur Sauvegarder.
La configuration est terminée. Si vous regardez la vue Artefacts de l'équipe, vous y verrez la définition et le moteur de la génération.

Définition et moteur de la génération dans la vue Artefacts de l'équipe

Publication du script de génération

Avant de démarrer le moteur de génération pour produire les générations, souvenez-vous que le script de génération (build.xml) du projet Hello Prelude n'a pas été publié dans le flux de travaux. Sans cette étape, moteur de génération Jazz n'aura pas les instructions nécessaires pour produire la génération. Nous allons donc publier cette modification maintenant.
  1. Dans la vue Modifications en attente, sous Composant par défaut, cliquez avec le bouton droit sur Non résolu puis cliquez sur Ajout et distribution.

    Vue Modifications en attente

  2. Dans l'assistant Ajout et distribution, dans le volet Commentaire pour l'ensemble d'artefacts modifiés, entrez un commentaire puis cliquez sur Suivant.
  3. Dans la page Associer l'élément de travail, sélectionnez un élément de travail existant et cliquez sur Terminer.
Le script de génération est maintenant dans le flux. Il sera disponible quand la génération s'exécutera.

Démarrage du moteur de génération

Démarrez le moteur de génération afin de produire une génération.
Remarque : Lorsque vous démarrez le moteur de génération, pour être certain d'utiliser le JDK approprié, vous pouvez préciser le JDK inclus dans client Jazz à l'aide de l'argument de ligne de commande -vm.

Pour démarrer le moteur de génération :
  1. A partir d'une ligne de commande, accédez à installdir/buildsystem/buildengine/eclipse, où installdir est le répertoire d'installation de Build System Toolkit.
  2. Tapez jbe -vm clientinstalldir/jazz/client/eclipse/jdk/bin/java -repository repositoryURL -userId build –pass password -engineId PreludeBuildEngine , où
    • clientinstalldir est le répertoire d'installation de client Jazz.
    • URLréférentiel représente l'URL de votre référentiel. Par exemple, http://localhost:9080/jazz/.
    • password est le mot de passe de l'utilisateur de la génération.
    Dans ce tutoriel, l'ID utilisateur est build et l'identificateur du moteur de génération utilisateur est PreludeBuildEngine.
Le moteur démarre et a l'aspect suivant dans la console (d'autres messages peuvent aussi apparaître) :
2009-06-11 16:08:47 Running build loop...
2009-06-11 16:08:47 Waiting for request...

La valeur du paramètre -sleepTime est 1 (seconde) pour s'assurer que les requêtes de génération soient traitées tout de suite.

Le moteur de génération attend de commencer son travail. Il est temps de produire une génération.

Présentation de l'interface utilisateur de Jazz Team Build

Cette section présente des informations supplémentaires sur les tâches de génération que vous pouvez réaliser avec Jazz Team Build.

client Jazz vous permet de réaliser les tâches de génération suivantes :

Examinons chacune de ces tâches.

Demande d'une génération

Vous pouvez demander une génération à partir de la vue Artefacts de l'équipe. Vous pouvez aussi modifier les propriétés d'une génération ou demander une génération personnalisée qui soit sans effet sur le statut de la définition de génération et s'effectue dans un espace de travail que vous spécifiez.
Pour demander une génération :
  1. Dans la vue Artefacts de l'équipe, développez le dossier du projet.
  2. Développez le dossier Générations et recherchez le nom de la génération désirée dans la liste.
  3. Cliquez avec le bouton droit de la souris sur Génération équipe 1 puis cliquez sur Demander une génération.
    1. Facultatif : Pour demander une génération personnalisée sans effet sur le statut de la définition de génération et exécuté dans un espace de travail défini, sélectionnez Génération personnalisée dans le volet Options de génération. Si nécessaire, actualisez les champs Espace de travail du référentiel et Règles de chargement des composants.
  4. Dans la boîte de dialogue Demander une génération, cliquez sur Soumettre.
Le moteur de génération exécute la demande de génération. Vous pouvez observer ce processus dans la fenêtre de commande où vous avez démarré le moteur de génération.

Si la génération échoue, examinez le fichier journal publié dans les résultats.

Affichage des résultats de la génération

Regardons les résultats de la génération pour voir ce qui s'est produit.
Les onglets disponibles dans l'éditeur résultats de la génération sont Présentation, Journaux et Propriétés. Des onglets supplémentaires peuvent s'afficher selon les données fournies par le script de génération au résultat de génération. Par exemple, si le script de génération fournit des résultats de génération et des téléchargements, l'éditeur de résultat de génération comprend alors les onglets Compilation et Téléchargements.

Vous avez réalisé les tâches suivantes :

  1. Vous avez soumis une demande de génération. Elle aurait pu être initialisée automatiquement avec une planification prédéfinie.
  2. La demande a été réceptionnée par moteur de génération Jazz avec la définition de la génération.
  3. A l'aide d'un espace de travail de référentiel indiqué dans la définition de génération (Espace de travail de génération Equipe 1), moteur de génération Jazz a exécuté une opération accept pour mettre à jour l'espace de travail de génération à partir du flux. Dans la première génération, ceci a importé le nouveau script de génération (build.xml) dans l'espace de travail de génération, ce qui est nécessaire pour produire une génération.
  4. Le contenu mis à jour de l'espace de travail de génération a été chargé dans le système de fichiers à l'aide d'un répertoire nommé fetched indiqué dans la définition de la génération.
  5. Le script de génération indiqué dans la définition est appelé. Le script a compilé le projet HelloWorld et créé les fichiers de classe Java. Un script plus sophistiqué aurait créé un fichier .jar et l'aurait publié dans Jazz.
  6. Une fois le script exécuté, le journal des générations et les autres résultats publiés sont stockés dans référentiel Jazz.
  7. L'équipe est informée que la génération est terminée.

Editeur des résultats de la génération

L'éditeur des résultats de génération fournit plusieurs informations :

Consultation du journal de la génération

Examinons le journal de la génération pour voir si le nouveau script de génération a fonctionné.
  1. Accédez à la page Journaux. Regardons ce que la génération a fait.

    Page Journaux

  2. Sélectionnez le fichier journal puis cliquez sur Ouvrir. Vous pouvez voir les principales actions réalisées.

    Exemple de journal de génération

    Vous commencez à voir que les générations produites par Jazz sont tout à fait visibles par vous-même et votre équipe.

Surveillance du statut des générations

Vous pouvez connaître le statut des générations d'une manière active ou passive. Les informations sur la génération sont fournies de deux manières sans action de votre part : dans la section Génération de la vue Centre de contrôle de l'équipe et dans les alertes de génération qui apparaissent brièvement sur votre écran.

A l'issue des générations, la section Génération de la vue Centre de contrôle de l'équipe est mise à jour avec l'état des générations terminées des équipes qui ont participé.

Pour chaque génération affichée dans cette vue, vous pouvez voir le statut et demander une nouvelle génération.

Pour personnaliser la fréquence de mise à jour de l'état, procédez comme suit :

Recherche des générations disponibles

Vous pouvez afficher les générations disponibles, le statut des générations en cours et les générations mises en file d'attente dans la vue Générations, accessible par le menu contextuel Afficher les résultats de la génération depuis le dossier Générations, dans la vue Artefacts de l'équipe.

Option de menu Afficher les résultats de la génération

Vous pouvez trier le contenu de la vue en sélectionnant une colonne. Il existe un certain nombre d'actions de menu contextuel intéressantes. Vous pouvez par exemple comparer une génération avec le flux dont elle provient ou créer un nouveau flux à partir d'une génération (utile pour créer une nouvelle base de code à partir d'une base de code validée).

Vue Résultats de la génération

Vous pouvez également afficher les résultats de la génération en définissant un viewlet de génération dans votre tableau de bord Jazz basé sur le Web :

Résultats de la génération dans le tableau de bord Jazz basé sur le Web

L'équipe de développement de Jazz personnalise son processus de génération depuis un certain temps déjà. L'éditeur des résultats de génération de Jazz propose des onglets supplémentaires nommés Compilation, JUnit, Téléchargements et Liens externes. Voici une capture d'écran provenant d'une génération Jazz qui vous donnera une idée des possibilités.

Exemple de résultats de génération personnalisés

Point de contrôle de la leçon

Dans cette leçon, vous avez appris les concepts de base des fonctionnalités de Jazz Team Build.
< Précédent | Suivant >

Commentaire

Etes-vous satisfait ? Envoyez vos commentaires sur Jazz.net (inscription requise) : Entrez vos remarques dans les forums ou soumettez un incident