Environnements de construction

Les Environnements de construction sont des emplacements où le code Source 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 Source 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:

Créer un Environnement de construction

  1. Dans le Menu d’Administration des projets, sélectionnez Environnements de construction > Créer.

    L’écran suivant s’affiche:

    ProjAdmin BuildEnv Create
  2. 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 comme défini dans la Phase de noyau Compression de la construction. Voir Phase Compression de la construction..

    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.

    Paramètres contrôlés par Utilisateurs

    Autorise les Utilisateurs avec un rôle d’Utilisateur de Projet à créer, lire, modifier et supprimer des Paramètres d’Environnement. Une fois autorisé, les Paramètres gardent cet état jusqu’à ce qu’un Administrateur de Projet annule cette option.

  3. 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.

  4. 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

  1. Dans le Menu d’Administration des projets, sélectionnez Environnements de construction > Aperçu.

    L’écran suivant s’affiche:

    ProjAdmin BuildEnv Overview
  2. 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.

  3. 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 icon sort peuvent être rangées par ordre alphabétique (ascendant ou descendant).

  4. En fonction de vos droits d’accès, les liens/icônes suivants peuvent être disponibles dans la fenêtre Aperçu des Environnements de construction:

    Icône Description

    edit Modifier

    Cette option permet de modifier l’Environnement de construction.

    Modifier un Environnement de construction

    delete 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.

    Supprimer un Environnement de construction

    clone Cloner

    Cette option permet ce cloner un Environnement de construction.

    Cloner un Environnement de construction

    edit phases Modifier les Phases

    Cette option permet de modifier les Phases de l’Environnement de construction.

    Modifier une Phase d’Environnement de construction

    icon viewparameters Voir les Paramètres

    Cette option permet d’afficher les Paramètres de l’Environnement de construction.

    Afficher les paramètres d’Environnement de construction

    history Historique

    Cette option permet d’afficher l’Historique de l’Environnement de construction.

    Afficher l’historique d’un Environnement de construction

    Les colonnes marquées de l’icône icon sort peuvent être rangées par ordre alphabétique (ascendant ou descendant).

Modifier un Environnement de construction

  1. Accédez à l’écran Aperçu des Environnements de construction. Voir Aperçu des Environnements de construction

  2. Cliquez sur le lien edit Modifier pour l’Environnement de construction requis.

    L’écran suivant s’affiche:

    ProjAdmin BuildEnv Edit
  3. Ensuite, cliquez sur le lien Modifier dans la fenêtre Informations sur l’Environnement de construction.

    L’écran Modifier l’Environnement de construction s’affiche:

    ProjAdmin BuildEnv Edit popup
  4. Si nécessaire, modifiez les champs.

    Pour une description détaillée, se référer à la section Créer un Environnement de construction.

  5. 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

  1. Accédez à l’écran Aperçu des Environnements de construction.

  2. Cliquez sur le lien delete Supprimer pour l’Environnement de construction sélectionné.

    L’écran suivant s’affiche:

    ProjAdmin BuildEnv Delete
  3. 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.

  1. Accédez à l’écran Aperçu des Environnements de construction.

  2. Cliquez sur le lien clone Cloner pour cloner l’Environnement de construction.

    L’écran suivant s’affiche:

    ProjAdmin BuildEnv Clone
  3. 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

  4. 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. Les journaux seront visibles sur la page Informations détaillées des Requêtes de niveau. Pour plus d’information, 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

  1. Accédez à l’écran Aperçu des Environnements de construction.

  2. Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien edit phases Modifier les Phases.

    L’écran Aperçu des Phases d’Environnement de construction s’affiche.

    ProjAdmin BuildEnv EditPhases

    Le lien vers cet écran est également disponible dans l’écran Modifier un Environnement de construction.

  3. Utilisez les liens dans le panneau Aperçu des Phases pour modifier une Phase.

    Les liens suivants sont disponibles:

  4. Insérez une Phase, si nécessaire.

    Cliquez sur le lien Insérer une Phase en bas du panneau Aperçu des Phases.

  5. 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

  1. Accédez à l’écran Aperçu des Environnements de construction.

  2. Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien edit phases Modifier les Phases.

  3. Dans le panneau Aperçu des Phases, cliquez sur le lien edit phases Insérer une Phase.

    L’écran Insérer une Phase s’affiche.

    ProjAdmin BuildEnv InsertPhase
  4. Sélectionnez la Phase à insérer à partir du panneau Phases disponibles.

  5. 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.

  6. 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

  1. Accédez à l’écran Aperçu des Environnements de construction.

  2. Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien edit phases Modifier les Phases.

  3. Cliquez sur le lien edit Modifier devant la Phase que vous voulez modifier.

    L’écran Modifier la Phase d’Environnement de construction s’affiche.

    ProjAdmin BuildEnv EditBuildEnvPhase
  4. 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.

  5. 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

  1. Accédez à l’écran Aperçu des Environnements de construction.

  2. Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien edit phases Modifier les Phases.

  3. Utilisez les liens up Monter et down Descendre devant la Phase d’Environnement de construction pour modifier la position de la Phase sélectionnée dans la séquence.

  4. 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

  1. Accédez à l’écran Aperçu des Environnements de construction.

  2. Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien edit phases Modifier les Phases.

  3. Cliquez sur le lien icon viewparameters 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.

    ProjAdmin BuildEnv BuildEnvPhaseParamsOverview
  4. 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 icon createparameter Créer un Paramètre.

    Sécurisé

    Non

    Ce champ indique si le Paramètre est sécurisé ou non.

  5. Cliquez sur le lien edit Modifier un Paramètre à côté du Paramètre de phase.

    La fenêtre suivante s’affiche.

    ProjAdmin BuildEnv BuildEnvPhaseParams EditValue

    Spécifiez la valeur du Paramètre de phase d’Environnement de construction et cliquez sur le bouton Sauvegarder 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.

  6. Si vous voulez créer un Paramètre de phase non-obligatoire, cliquez sur le lien icon createparameter Créer un Paramètre à côté du Paramètre de phase.

    La fenêtre suivante s’affiche.

    ProjAdmin BuildEnv BuildEnvPhaseParams CreateParam

    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.

  7. Si vous voulez supprimer un Paramètre de phase non-obligatoire, cliquez sur le lien delete Supprimer un Paramètre à côté du Paramètre de phase.

    La fenêtre suivante s’affiche.

    ProjAdmin BuildEnv BuildEnvPhaseParams DeleteParamValue

    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.

  8. Cliquez sur le lien Phase EditEnvPhaseParameter 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.

    ProjAdmin BuildEnv BuildEnvPhaseParams EditGlobalPhaseParam

    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 Phase EditEnvPhaseParameter Paramètre de phase d’environnement approprié dans le panneau Paramètres d’environnement connectés.

Supprimer une Phase d’Environnement de construction

  1. Accédez à l’écran Aperçu des Environnements de Construction.

  2. Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien edit phases Modifier les Phases.

  3. Dans le panneau Aperçu des Phases, cliquez sur le lien delete Supprimer.

    L’écran Confirmer la suppression d’une Phase d’Environnement de construction s’affiche.

    ProjAdmin BuildEnv DeletePhase
  4. 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

  1. Accédez à l’écran Aperçu des Environnements de construction.

  2. Cliquez sur le lien icon viewparameters Voir les Paramètres pour consulter les paramètres rattachés à l’Environnement de construction.

    L’écran suivant s’affiche:

    ProjAdmin BuildEnv ViewParameters

    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

  1. Accédez à l’écran Aperçu des Environnements de construction.

  2. Dans le panneau Aperçu des Environnements de construction, cliquez sur le lien history 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.