Environnements de construction
Les Environnements de Construction sont des emplacements où le code récupéré du RCV est construit. L’environnement peut être spécifique à un Système d’exploitation. De plus, il est possible d’utiliser des paramètres de construction généraux et spécifiques pour chacun des Environnements de Construction.
Les Environnements de Construction doivent être associés à un Niveau avant de devenir actifs.
Les Environnements de Construction sont couramment utilisés dans les cas suivants:
-
Lorsqu’il est associé à un niveau de Construction, l’Environnement de Construction permet la compilation du code Source extrait du RCV.
-
Lorsqu’il est associé à un niveau de Test, l’Environnement de Construction permet des Reconstructions du code pour vérifier si la compilation est possible sur d’autres plates-formes, avec d’autres paramètres de construction, etc.
L’option Environnements de construction permet de démarrer les procédures suivantes:
-
Aperçu des environnements de construction
L’écran Aperçu des Environnements de construction vous permet de vérifier et modifier les informations concernant les Environnements de construction et les Phases associées. Les actions suivantes sont possibles:
-
Paramètres de construction
L’écran Aperçu des Paramètres vous permet de créer, modifier, supprimer et copier les Paramètres de construction et de consulter leur historique. Pour plus d’informations se référer au chapitre Paramètres d’environnement
Créer un environnement de construction
-
Dans le contexte de l'Administration des projets, sélectionnez Environnements de construction > Créer.
L’écran suivant s’affiche:
-
Complétez les champs pour le nouvel Environnement de Construction.
Les champs suivants sont disponibles. Les champs marqués d’un astérisque rouge doivent être complétés obligatoirement.
Champ Description Nom
Saisissez dans ce champ la dénomination de l’Environnement de Construction.
Niveau
Si nécessaire, sélectionnez, à partir du menu déroulant, un niveau auquel vous voulez associer cet Environnement de Construction.
Machine
Sélectionnez, à partir du menu déroulant, la Machine à laquelle cet Environnement de Construction doit être associé physiquement.
Note: Les Emplacements Source et Cible doivent exister ou doivent pouvoir être créés sur la Machine sélectionnée.
Outil de construction
Sélectionnez, à partir du menu déroulant, l’Outil de Déploiement pour cet Environnement de Construction.
Les chemins définis pour l’Outil de Construction associé doivent exister sur la Machine associée à l’Environnement de Construction.
Script de construction
Dans ce champ vous pouvez saisir le chemin relatif vers le script de construction que vous voulez sélectionner spécifiquement pour cet Environnement de Construction.
Si vous laissez ce champ vide, le script de construction par défaut, comme défini dans les Paramètres du Projet, sera utilisé.
Emplacement Source
Ce champ contient le chemin vers l’emplacement physique où seront placés le code Source, le code Source dépendant ou le résultat de la construction dépendante.
IKAN ALM ajoute l’identifiant (OID) de la construction et la dénomination du Projet:
EmplacementSource/OIDdeConstruction/Nom_Projet_RCV
Cet emplacement est transmis au script de construction sous la forme d’un paramètre appelé source.
Emplacement Cible
Ce champ contient le chemin vers l’emplacement physique où IKAN ALM attend le résultat du script de construction exécuté. IKAN ALM ajoute l’identifiant (OID) de la construction:
EmplacementCible/OIDdeConstruction.
Cet emplacement est transmis au script de construction sous la forme d’un paramètre appelé target.
Le script de déploiement est ajouté au résultat, délivrant le contrôle de version du script de déploiement et de la construction associée.
Le résultat est compressé et archivé dans les Archives de constructions. La dénomination du fichier est structurée comme suit: webpad_H_1.0_b12_CONTBUILD_win.zip où:
-
webpad: Dénomination du projet
-
H: Type de branche: H pour une Branche principale, B pour une Branche Secondaire
-
1-0: Préfixe de construction
-
b12: Numéro de construction
-
CONTBUILD: Dénomination de l’Environnement de Construction
-
win: Suffixe de construction
-
zip: extension référant à la méthode de compression, .zip pour les plates-formes Windows, .tgz pour les plates-formes Unix et Linux.
Suffixe de construction
Si nécessaire, saisissez dans ce champ le suffixe de construction pour l’Environnement de Construction.
Construction téléchargeable
Indiquez si les fichiers de construction compressés créés pour ce niveau de Construction sont téléchargeables ou non.
Si l’option est activée, un lien donnant accès aux résultats de construction compressés sera affiché sur l’onglet Résultats de l’écran Informations détaillées.
Voir Résultats
Débogage
Indiquez si l’option de débogage doit être activée ou non pour cet Environnement de Construction.
Si l’option Débogage est activée pour un Environnement de Construction, les actions de Nettoyage du code Source et du Résultat 15 et 16 de l’aperçu des Requêtes de niveau de Construction et de Déploiement ne seront pas exécutées pour que l’Utilisateur puisse utiliser le code Source disponible pour exécuter le script manuellement pour des tests.
-
-
Vérifier les détails affichés dans le panneau Aperçu des environnements de construction.
Cet aperçu affiche tous les Environnements de construction défini pour tous les Niveaux appartenant au Projet en question.
Pour plus d’informations concernant les liens disponibles, voir la section Aperçu des environnements de construction.
-
Une fois tous les champs complétés, cliquez sur le bouton Créer pour confirmer la création du nouvel Environnement de Construction.
Vous pouvez également cliquer sur le bouton Réinitialiser pour nettoyer les champs.
Aperçu des environnements de construction
-
Dans le contexte de l'Administration des projets, sélectionnez Environnements de construction > Aperçu.
L’écran suivant s’affiche:
-
Définissez les critères de recherche requis dans le panneau de recherche.
La liste des éléments dans l’aperçu est synchronisée automatiquement en fonction des critères sélectionnés.
Vous pouvez également:
-
cliquer sur le lien Montrer/Cacher les options avancées pour afficher ou masquer tous les critères de recherche disponibles,
-
cliquer sur le lien Rechercher pour synchroniser la liste en fonction des critères de recherche actuels,
-
cliquer sur le lien Réinitialiser la recherche pour nettoyer les champs.
-
-
Vérifiez les informations disponibles dans l’Aperçu des Environnements de construction.
Pour une description détaillée, se référer à la section Créer un environnement de construction.
Les colonnes marquées de l’icône peuvent être rangées par ordre alphabétique (ascendant ou descendant).
-
En fonction de vos droits d’accès, les liens suivants peuvent être disponibles dans la fenêtre Aperçu des Environnements de construction:
Modifier
Cette option permet de modifier l’Environnement de Construction.
Supprimer
Cette option permet de supprimer l’Environnement de Construction. Si vous supprimez un Environnement, les informations historiques telles que les Constructions et les Logs de construction seront également supprimées.
Cloner
Cette option permet ce cloner un Environnement de Construction.
Modifier les Phases
Cette option permet de modifier les Phases de l’Environnement de Construction.
Voir les Paramètres
Cette option permet d’afficher les Paramètres de l’Environnement de Construction.
Historique
Cette option permet d’afficher l’Historique de l’Environnement de Construction.
Les colonnes marquées de l’icône peuvent être rangées par ordre alphabétique (ascendant ou descendant).
Modifier un environnement de construction
-
Accédez à l’écran Aperçu des Environnements de construction. Voir Aperçu des environnements de construction
-
Cliquez sur le lien Modifier pour l’Environnement de Construction requis.
L’écran suivant s’affiche:
-
Ensuite, cliquez sur le lien Modifier dans la fenêtre Informations sur l’Environnement de construction.
L’écran Modifier un Environnement de construction s’affiche:
-
Si nécessaire, modifiez les champs.
Pour une description détaillée, se référer à la section Créer un environnement de construction.
-
Cliquez sur le bouton "Enregistrer" pour enregistrer vos modifications.
Vous pouvez également cliquer sur le bouton Actualiser pour revenir aux valeurs d’origine ou sur le bouton Annuler pour retourner à l’écran Modifier l’Environnement de construction sans enregistrer vos modifications.
Supprimer un environnement de construction
-
Accédez à l’écran Aperçu des Environnements de construction.
-
Cliquez sur le lien Supprimer pour l’Environnement de Construction sélectionné.
L’écran suivant s’affiche:
-
Cliquez sur le bouton Supprimer pour confirmer la suppression de l’environnement de construction.
Vous pouvez également cliquer sur le bouton Précédent pour retourner à l’écran précédent sans supprimer l’Environnement.
Si vous supprimez un Environnement de Construction, vous supprimez également les Environnements de déploiement connectés à cet Environnement, ainsi que toutes les informations historiques, telles que les Constructions, les Logs de Construction, les Déploiements et les Logs de Déploiement.
Cloner un environnement de construction
Si vous clonez un Environnement, toute la définition, y compris les Phases et les Paramètres, sera clonée
-
Accédez à l’écran Aperçu des Environnements de construction.
-
Cliquez sur le lien Cloner pour cloner l’Environnement de Construction.
L’écran suivant s’affiche:
-
Dans le panneau Cloner un Environnement de Construction, spécifiez le Nom, l’Emplacement Cible et le Niveau pour le nouvel Environnement.
Si nécessaire, modifiez les autres champs. Pour une description détaillée des champs, se référer à la section Créer un environnement de construction
-
Cliquez sur le bouton Cloner pour confirmer l’action.
Vous pouvez également cliquer sur le bouton Précédent pour retourner à l’écran précédent sans cloner l’Environnement.
Phases d’environnement de construction
Lors de la création d’un Environnement de construction, IKAN ALM créera automatiquement le flux de Phases d’Environnement de construction par défaut.
Les Phases par défaut sont:
-
Transfert des Sources
-
Vérification du script de construction
-
Exécution du script de construction
-
Transfert du script de déploiement
-
Compression de la construction
-
Archivage Résultat
-
Nettoyage Emplacement Source
-
Nettoyage Emplacement Cible
Lors de l’exécution d’une Construction sur un Environnement, un Journal sera créé pour chacune des Phases. Voir Informations détaillées
Pour des informations plus détaillées, se référer aux sections suivantes:
L’Aperçu des Phases d’Environnement de construction
-
Accédez à l’écran Aperçu des Environnements de construction.
-
Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien Modifier les Phases.
L’écran Aperçu des Phases d’Environnement de construction s’affiche.
Le lien vers cet écran est également disponible dans l’écran Modifier un Environnement de construction.
-
Utilisez les liens dans le panneau Aperçu des Phases pour modifier une Phase.
Les liens suivants sont disponibles:
-
Les liens Monter et Descendre pour modifier l’ordre des Phases.
-
Le lien Modifier pour modifier les Paramètres de la Phase sélectionnée. Modifier une Phase d’environnement de construction
-
Le lien Voir les Paramètres pour gérer les Paramètres de phase obligatoires et optionnels. Afficher les Paramètres de phase d’Environnement de construction
-
Le lien Supprimer pour supprimer une Phase. Supprimer une Phase d’environnement de construction
La modification des Phases pourrait avoir des effets indésirables sur le Cycle de Vie. Pour plus d’informations se référer au document HOW TO Using and Developing a Phase in IKAN ALM (version anglaise).
-
-
Insérez une Phase, si nécessaire.
Cliquez sur le lien Insérer une Phase en bas du panneau Aperçu des Phases.
-
Cliquez sur le bouton Précédent pour retourner à l’écran Aperçu des Environnements de Construction.
Insérer une Phase d’environnement de construction
-
Accédez à l’écran Aperçu des Environnements de construction.
-
Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien Modifier les Phases.
-
Dans le panneau Aperçu des Phases, cliquez sur le lien Insérer une Phase.
L’écran Insérer une Phase s’affiche.
-
Sélectionnez la Phase à insérer à partir du panneau Phases disponibles.
-
Complétez les champs pour la nouvelle Phase.
Les champs suivants sont disponibles:
Champ Description Phase
Sélectionnez, à partir du panneau Phases disponibles, la Phase à ajouter.
Abandon si erreur
Dans ce champ, indiquez si la Construction doit être considérée comme étant échouée si la Phase rencontre une erreur.
Insérer à la position
Ce champ indique la position dans le flux de travail de l’Environnement de construction à laquelle la Phase sera insérée. La position de la Phase est également affichée dans le panneau Aperçu des Phases.
Phase suivante si erreur
Ce champ indique la Phase suivante à exécuter si la Phase rencontre une erreur.
Libellé
Dans ce champ optionnel vous pouvez saisir un libellé pour la Phase à insérer.
Si vous utilisez la même Phase plusieurs fois, il est utile d’ajouter un libellé pour donner des informations additionnelles concernant l’usage de la Phase.
-
Cliquez sur le bouton Insérer pour confirmer la création de la nouvelle Phase.
Vous pouvez également utiliser le bouton Annuler pour retourner à l’écran précédent sans enregistrer les modifications.
Modifier une Phase d’environnement de construction
-
Accédez à l’écran Aperçu des Environnements de construction.
-
Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien Modifier les Phases.
-
Cliquez sur le lien Modifier devant la Phase que vous voulez modifier.
L’écran Modifier la Phase d’Environnement de construction s’affiche.
-
Modifiez les champs dans le panneau Modifier une Phase d’Environnement de construction.
Pour une description détaillée des champs, se référer à la section Insérer une Phase d’environnement de construction.
-
Cliquez sur le bouton Enregistrer pour enregistrer vos modifications.
Vous pouvez également cliquer sur le bouton Actualiser pour revenir aux valeurs d’origine ou sur le bouton Annuler pour retourner à l’écran Modifier l’Environnement de construction sans enregistrer vos modifications.
Modifier la séquence des Phases d’Environnement de construction
-
Accédez à l’écran Aperçu des Environnements de construction.
-
Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien Modifier les Phases.
-
Utilisez les liens Monter et Descendre devant la Phase d’Environnement de construction pour modifier la position de la Phase sélectionnée dans la séquence.
-
Cliquez sur le bouton Précédent pour retourner à l’écran Aperçu des Environnements de Construction.
Attention de ne pas modifier la position d’une Phase de telle manière que sa Phase suivante si erreur se trouve à une position antérieure dans le flux de travail: cela aurait une boucle infinie comme résultat. Sinon, modifiez sa Phase suivante si erreur avec une Phase postérieure.
Afficher les Paramètres de phase d’Environnement de construction
-
Accédez à l’écran Aperçu des Environnements de construction.
-
Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien Modifier les Phases.
-
Cliquez sur le lien Voir les Paramètres devant la Phase d’Environnement de construction pour laquelle vous voulez gérer les Paramètres.
L’écran Aperçu des Paramètres de la phase s’affiche.
-
Afficher les Paramètres de phase d’Environnement de construction.
Le panneau Paramètres de la phase affiche tous les Paramètres définis de la Phase de Environnement de construction et permet de créer des Paramètres de Phase non-obligatoires.
Les champs suivants sont disponibles:
Champ Modifiable Description Nom
Non
Le nom du Paramètre.
Valeur
Oui
La valeur du Paramètre.
Initialement, au moment où la Phase est insérée, la valeur sera copiée à partir de la Valeur par défaut spécifiée dans l’Administration globale (si saisie).
Ce champ peut être modifié en modifiant le Paramètre de phase.
Type d’intégration
Non
Ce champ indique si la valeur du Paramètre est une simple valeur texte, ou si elle représente un lien (une intégration) vers un objet IKAN ALM de l’Administration globale.
Les valeurs possibles sont:
-
Aucun: la valeur se compose de texte simple
-
Transporteur: un lien vers un Transporteur
-
Référentiel: un lien vers un Référentiel de Contrôle de Version
-
Suivi des incidents: un lien vers un Système de Suivi des Incidents
-
Outil de script: un lien vers un Outil de script
-
ANT: un lien vers un Outil de script Ant
-
GRADLE: un lien vers un Outil de script Gradle
-
NANT: un lien vers un Outil de script NAnt
-
MAVEN2: un lien vers un Outil de script Maven2
Obligatoire
Non
Ce champ indique si le Paramètre a été créé automatiquement lors de l’insertion de la Phase dans le Niveau. Ceci est le cas pour les Paramètres obligatoires.
Les Paramètres non-obligatoires doivent être créés après l’insertion de la Phase dans un Niveau, en utilisant le lien Créer un Paramètre.
Sécurisé
Non
Ce champ indique si le Paramètre est sécurisé ou non.
-
-
Cliquez sur le lien Modifier un Paramètre à côté du Paramètre de phase.
La fenêtre suivante s’affiche.
Spécifiez la valeur du Paramètre de phase d’Environnement de construction et cliquez sur le bouton Enregistrer pour enregistrer la valeur.
Les boutons suivants sont également disponibles:
-
Réinitialiser pour revenir à la valeur d’origine.
-
Annuler pour retourner à l’écran Aperçu des Paramètres de la phase sans enregistrer la valeur.
-
-
Si vous voulez créer un Paramètre de phase non-obligatoire, cliquez sur le lien Créer un Paramètre à côté du Paramètre de phase.
La fenêtre suivante s’affiche.
Si une valeur de paramètre par défaut a été spécifiée dans la section Administration globale, cette valeur sera proposée.
Spécifiez la valeur du Paramètre de phase d’Environnement de construction et cliquez sur le bouton Créer.
-
Réinitialiser pour revenir à la valeur d’origine.
-
Annuler pour retourner à l’écran Aperçu des Paramètres de la phase sans enregistrer la valeur.
-
-
Si vous voulez supprimer un Paramètre de phase non-obligatoire, cliquez sur le lien Supprimer un Paramètre à côté du Paramètre de phase.
La fenêtre suivante s’affiche.
Cliquez sur le bouton Supprimer pour confirmer la suppression du Paramètre de phase d’Environnement de construction obligatoire.
Vous pouvez également cliquer sur le bouton Annuler pour fermer l’écran sans supprimer le Paramètre.
-
Cliquez sur le lien Modifier un Paramètre de phase global à côté du Paramètre de phase.
L’Utilisateur sera renvoyé vers l’écran Modifier une Phase (dans le contexte de l’Administration globale) et l’écran Modifier un Paramètre de phase s’affichera.
La procédure pour modifier le Paramètre de phase global est décrite dans la section Modifier les Paramètres de phase.
Pour retourner au Paramètre de phase dans le contexte de l’Administration des projets, cliquez sur le lien _ Paramètre de phase d’environnement_ approprié dans le panneau Paramètres d’environnement connectés.
Supprimer une Phase d’environnement de construction
-
Accédez à l’écran Aperçu des Environnements de Construction.
-
Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien Modifier les Phases.
-
Dans le panneau Aperçu des Phases, cliquez sur le lien Supprimer.
L’écran Supprimer une Phase d’Environnement de construction s’affiche.
-
Cliquez sur le bouton Oui pour confirmer la suppression de la Phase.
Vous pouvez également cliquer sur le bouton Non pour retourner à l’écran précédent sans supprimer la Phase d’Environnement de construction.
Afficher les paramètres d’environnement de construction
-
Accédez à l’écran Aperçu des Environnements de construction.
-
Cliquez sur le lien Voir les Paramètres pour consulter les paramètres rattachés à l’Environnement de Construction.
L’écran suivant s’affiche:
Pour une description détaillée des champs, se référer à la section Créer un Paramètre d’Environnement.
Afficher l’historique d’un environnement de construction
-
Accédez à l’écran Aperçu des Environnements de construction.
-
Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien Historique pour afficher l’écran Aperçu de l’Historique de l’Environnement de construction.
Pour une description détaillée de l’Aperçu de l’Historique, se référer à la section Enregistrement de l’historique et des événements.
Cliquez sur le bouton Précédent pour retourner à l’écran précédent.