Phases - Informations générales

En général, la Phase Récupération des Sources est la première Phase exécutée dans une Requête de niveau. Elle récupère (check out) les codes Source à partir du RCV et les copie dans l’Emplacement de Transfert (un sous-répertoire de l’Emplacement des Copies de travail) où ils seront disponibles pour les Agents exécutant les Constructions de la Requête de niveau.

S’il s’agit d’une Requête de niveau pour un Niveau de Construction, les codes Source les plus récents sont récupérés; s’il s’agit d’une Requête de niveau pour un Niveau de Test, les codes Source balisés seront récupérés.

S’il s’agit d’une Requête de niveau pour un Niveau de Construction associée à une Branche basée sur une Balise existante, les codes Source ayant la Balise spécifiée dans le champ Balise RCV lors de la création de la Requête de niveau seront récupérés. Pour la description du champ Balise RCV, se référer à la section Création d’une Requête de niveau de Construction.

La Phase Récupération des Sources récupère également les codes Source et/ou les résultats de construction de toutes les Constructions dépendantes desquelles dépend cette Requête de niveau. Voir Dépendances de construction

Dans le cas d’une Construction partielle (Créer une Branche Secondaire), seuls les codes Source modifiés seront récupérés et rendus disponibles pour les Agents exécutant les Constructions de la Requête de niveau.

Le Paramètre de phase (d’environnement) alm.phase.retrieve.source.partialBuild.partialCheckout spécifie comment cela sera fait. S’il est établi à true (la valeur par défaut) et si le RCV le supporte, cela est effectué par la récupération partielle des codes Source modifiés. Sinon, tous les codes Source seront récupérés, tandis que seuls les codes Source modifiés seront transportés vers l’Emplacement Source de l’Environnement de Construction.

Si aucune Construction n’est associée à la Requête de niveau, la Phase Récupération des Sources ne fait rien et se termine avec le statut Réussi. Dans ce cas, vous pourriez supprimer la Phase Récupération Code du flux de travail du Niveau.

La Phase Construction démarre l’exécution des Constructions de la Requête de niveau et en fait le suivi.

Elle active les Agents de construction sur les Machines Agents pour démarrer toutes les Constructions en attente de la Requête de niveau. Ensuite, elle attend la fin de tous ces processus de Construction.

Entre-temps, si une Requête de niveau est annulée pendant la Phase de Construction, la Phase Construction notifie et arrête les Agents de construction.

Si toutes les Constructions sont terminées, le statut de la Phase Construction est établi en fonction des statuts des Constructions:

Si aucune Construction n’est définie pour la Requête de niveau, la Phase Construction ne fait rien et se termine avec le statut Réussi. Dans ce cas, vous pourriez supprimer la Phase Construction du flux de travail du Niveau.

La Phase Balisage associe une Balise aux codes Source récupérés du RCV sur la base de la Balise définie dans les Paramètres de la Requête de niveau. Si la Balise existe déjà dans le RCV, la Balise est modifiée.

La Phase Balisage n’associe une Balise qu’à condition que les codes Source récupérés soient les plus récents de la Branche RCV. Donc, elle n’associera pas de Balise s’il s’agit d’un Niveau de Construction d’une Branche basée sur une balise existante. Elle n’associera pas non plus de (nouvelle) Balise à une Requête de niveau pour délivrer une Construction. Dans ces deux cas, du code balisé a été récupéré et par conséquent un balisage n’était pas nécessaire. Vous pourriez donc supprimer la Phase Balisage du flux de travail du Niveau.

La Phase Déploiement démarre l’exécution des Déploiements de la Requête de niveau et en fait le suivi.

Elle active les Agents de déploiement sur les Machines Agents pour démarrer tous les Déploiements en attente de la Requête de niveau ayant le numéro de Séquence 0. Ensuite, elle attend la fin de tous ces Déploiements. Si tous ces Déploiements se sont terminés avec le statut Réussi ou Avertissement, elle active les Déploiements ayant le numéro de Séquence 1, et ainsi de suite jusqu’au moment où il n’y a plus de Déploiements ou qu’un Déploiement a échoué.

Entre-temps, si une Requête de niveau est annulée pendant la Phase de Déploiement, la Phase Déploiement notifie et arrête les Agents de déploiement.

Si tous les Déploiements sont terminés, le statut de la Phase Déploiement est établi en fonction des statuts des Déploiements:

Si aucun Déploiement n’est défini pour la Requête de niveau, la Phase Déploiement ne fait rien et se termine avec le statut Réussi. Dans ce cas, vous pourriez supprimer la Phase Déploiement du flux de travail du Niveau.

La Phase Suivi des Incidents relie les Incidents, gérés dans un Système de Suivi des Incidents externe, à une Requête de niveau en recherchant des références vers les Incidents dans les commentaires fournis lors des processus d’enregistrement (commit) dans le RCV.

S’il s’agit d’une Requête de niveau de construction, la Phase Suivi des Incidents analyse les commentaires fournis depuis la dernière Requête de niveau réussie pour ce Niveau. Elle cherchera des correspondances avec le modèle de recherche de Suivi d’incident (Créer un Système de Suivi des Incidents). Tous les Incidents trouvés seront reliés à la Requête de niveau.

Dans le cas d’un système de Suivi des Incidents Atlassian JIRA, MF ALM, GitHub ou TFS, la Phase Suivi des Incidents établira également la connexion avec JIRA, MF ALM, GitHub ou TFS et essaiera d’identifier les Incidents. Pour chaque Incident identifié, elle essaiera de récupérer des informations supplémentaires de JIRA, MF ALM, GitHub ou TFS telles que la description, le statut, le propriétaire et la priorité, et de sauvegarder ces informations dans IKAN ALM.

S’il s’agit d’une Requête de niveau pour délivrer une Construction, la Phase Suivi des Incidents énumère tous les Incidents associés aux Requêtes de niveau de Construction réussies depuis la dernière Requête de niveau pour délivrer une Construction sur ce Niveau réussie, et les ajoute tous à cette Requête de niveau.

Par exemple:

Supposons les Constructions suivantes: la Construction 3 reliée à l’Incident 3, la Construction 4 reliée à l’Incident 4, la Construction 5 reliée aux Incidents 5 et 6. Préalablement, la Construction 2 a été délivrée. Si nous délivrons la Construction 5, les Incidents 3, 4, 5 et 6 seront associés à la Requête de niveau pour délivrer la Construction.

Dans le cas d’un système de Suivi des Incidents Atlassian JIRA, MF ALM, GitHub ou TFS, la Phase Suivi des Incidents synchronisera tous les Incidents connectés à la Requête de niveau pour délivrer une Construction: elle comparera les informations de l’Incident dans IKAN ALM avec les informations actuelles dans JIRA, MF ALM, GitHub ou TFS et, si nécessaire, elle mettra à jour la description, le statut, le propriétaire et la priorité.

Si la Requête de niveau n’a pas réussi, la Phase Suivi des Incidents ne fait rien et se termine avec le statut Réussi rapportant qu’elle n’a traité aucun des Incidents.

Si aucun Système de Suivi des Incidents n’est attaché au Projet de cette Requête de niveau, la Phase Suivi des Incidents ne fait rien et se termine avec le statut Réussi.

La phase Jonction Révisions des Fichiers rattache les révisions des fichiers concernées à la Requête de niveau.

Pour une Requête de niveau de Construction, ceci est fait sur base des Révisions des Fichiers récupérées à partir du RCV lors de la Phase Récupération des Sources.

Pour une Requête de niveau à délivrer ou à restaurer, ceci est fait sur base des Révisions des Fichiers rattachées à la Requête de niveau (du Niveau précédent) qui sera délivrée ou restaurée. Même si ces Révisions des Fichiers sont également rattachées au Paquet, cette Phase est nécessaire pour fixer l’état du contenu du Paquet au moment de l’exécution de la Requête de niveau car il est probable que ce contenu sera modifié dans le temps.

Etant donné que cette Phase n’est applicable que pour les Requêtes de niveau de Paquets, elle ne s’affichera que pour les Niveaux des Projets de type Paquets.

La Phase Nettoyage Copies de travail libère l’Emplacement des Copies de travail à partir duquel les codes Source de la Requête de niveau ont été récupérés.

Cette Phase échoue si elle ne parvient pas à localiser ce répertoire. Typiquement, la valeur du champ Abandon si erreur de cette Phase est mise à Non, ce qui engendre la fin de la Requête de niveau avec le statut Avertissement au lieu de Échoué si la Phase rencontre une erreur.

Si l’option Débogage est activée pour le Niveau, la Phase Nettoyage Copies de travail ne fait rien et se termine avec le statut Erreur, rapportant que l’option Débogage est activée pour le Niveau.

La Phase Exécution script exécute un script sur la Machine du Serveur IKAN ALM en utilisant l’Outil de script spécifié et les Paramètres de niveau prédéfinis. Le script (alm.phase.mainScript) ainsi que l’Outil de script (alm.phase.builder) doivent être définis par un Paramètre de phase obligatoire après l’insertion de cette Phase dans un Niveau.

La Phase Exécution script a été introduite au niveau du Niveau à partir de la version 5.5 d’IKAN ALM, en même temps que les Phases personnalisées. Le journal généré par le script est sauvegardé dans la base de données d’IKAN ALM. Notez que cette Phase n’est jamais insérée dans le flux de travail par défaut d’un Niveau (par exemple, lors de la création d’un nouveau Niveau à partir de zéro).

Si le script réussit, la Phase Exécution script se termine avec le statut Réussi. Si non, il se termine avec le statut Erreur et affiche les erreurs sur l’onglet Journaux de Phase de l’écran Informations détaillées (Phases de niveau).

Outre les Phases de noyau, vous pouvez définir vos propres Phases dans l’Administration globale (Créer une définition de Phase) et spécifier qu’elles peuvent être utilisées sur un Niveau. Une fois insérée dans le flux de travail d’un Niveau, nous les appelons des Phases de niveau personnalisées.

La Phase de niveau personnalisée exécute un script sur la Machine du Serveur IKAN ALM en utilisant l’Outil de script spécifié et les Paramètres de niveau prédéfinis. Le nom d’affichage de cette Phase et le script exécuté (alm.phase.mainScript) sont spécifiés dans la définition de cette Phase personnalisée dans l’Administration globale. L’Outil de script (alm.phase.builder) qui exécute le script dépend du Type d’exécution spécifié dans la définition de la Phase et sa valeur doit être établie après l’insertion de cette Phase dans un Niveau.

La Phase de niveau personnalisée a été introduite à partir de la version 5.5 d’IKAN ALM, en même temps que la Phase Exécution script. Le journal généré par le script est sauvegardé dans la base de données d’IKAN ALM. Notez que cette Phase n’est jamais insérée dans le flux de travail par défaut d’un Niveau (par exemple, lors de la création d’un nouveau Niveau à partir de zéro).

Si le script réussit, la Phase de niveau personnalisée se termine avec le statut Réussi. Si non, il se termine avec le statut Erreur et affiche les erreurs sur l’onglet Journaux de Phase de l’écran Informations détaillées (Phases de niveau).

La Phase Transfert des Sources transfère les codes Source et, éventuellement, les résultats de construction des Projets dépendants à partir de l’Emplacement des Copies de travail sur la Machine Serveur IKAN ALM vers la Machine Agent IKAN ALM, utilisant le Transporteur associé à la Machine Agent IKAN ALM.

Dans le cas d’une Construction partielle, la Phase Transfert des Sources peut également transférer les résultats de construction de la Construction précédente à partir de l’Emplacement des Archives sur la Machine Serveur IKAN ALM vers l’Emplacement Source de l’Environnement sur la Machine Agent IKAN ALM. Pour obtenir ce résultat, établissez le Paramètre de phase (d’environnement) _alm.phase.transport.source.partialBuild.copyPreviousBuildResult _ à true/Oui. Notez que la valeur par défaut de ce Paramètre est établie à false/Non.

Voir également la section Récupération des Sources.

La Phase Vérification du script de construction essaie de localiser le Script de construction défini. La Phase échoue si elle n’y parvient pas.

D’abord, elle détermine le script de construction à utiliser. Si un script de construction a été défini au niveau de l’Environnement de Construction (Créer un Environnement de construction), elle essaiera de le localiser. Si ce n’est pas le cas, elle vérifiera si un script de construction a été défini au niveau du Projet (Modifier les paramètres d’un Projet).

Ensuite, elle essaiera de localiser le script de construction dans l’Emplacement Source de l’Environnement de Construction.

Si elle ne parvient pas à le localiser, elle essaiera de copier le script de construction de l’Emplacement des Scripts IKAN ALM tel que défini dans les Paramètres système (Paramètres du système).

Si le script n’est pas non plus trouvé à cet endroit, la Phase Vérification du script de construction se termine avec le statut Erreur.

Si le script est localisé, la Phase Vérification du script de construction se termine avec le statut Réussi rapportant où elle a localisé le script de construction.

La Phase Exécution script exécute le script de construction sur la Machine définie en utilisant l’Outil de script spécifié ainsi que les Paramètres de construction définis.

Un Journal de construction sera généré par le script de construction dans la base de données d’IKAN ALM.

Si le script de construction réussit, la Phase Exécution script se termine avec le statut Réussi. Si non, il se termine avec le statut Erreur et affiche les erreurs sur l’onglet Journaux de Phase de l’écran Informations détaillées (Actions de Construction).

La Phase Transfert du script de déploiement copie les scripts de déploiement définis au niveau des Environnements de Déploiement associés à l’Environnement de Construction de cette Construction à partir de l’Emplacement Source de l’Environnement de Construction vers l’Emplacement Cible.

Cette action sert à inclure les scripts de déploiement dans le fichier de construction compressé créé dans la Phase Compression de la construction.

Cette Phase n’est utile que pour les Constructions de Paquet,

si le Paquet fait partie d’un Groupe de Paquets de Construction, les derniers résultats de construction de certains Paquets dans le Groupe de Paquets de Construction (ou de tous les Paquets, en fonction de la configuration du Groupe de Paquets de Construction). Elle utilisera le Transporteur associé à l’Agent pour transférer les Résultats à partir des Archives de construction IKAN ALM sur le Serveur IKAN ALM vers le répertoire $/packages suivi du numéro de Paquet (OID) dans l’Environnement de Construction. Cette Phase crée également un fichier PackageBuildGroup.xml dans le répertoire ${sourceRoot}/packages dans l’Environnement de Construction que l’on peut utiliser comme données dans les Phases ultérieures, par exemple, pour le flux de travail "compilation pour le Mainframe", pour transférer ces résultats de construction et construire la structure PDS requise sur le Mainframe.

L’attribut Récupération de tous les Résultats de Construction pour le Groupe de Paquets de Construction et la définition du Niveau de dépendance des Paquets dans le Groupe de Paquets de Construction détermine quels résultats de construction seront récupérés: les derniers résultats de construction de tous les Paquets dans le Groupe de Paquets de Construction si le paramètre Récupération de tous les Résultats de Construction est établi à true/Oui, ou uniquement les derniers résultats de construction des Paquets ayant un Niveau de dépendance plus bas si le paramètre Récupération de tous les Résultats de Construction est établi à false/Non.

La Phase Compression de la construction compresse les fichiers de résultat de construction dans l’Emplacement Cible de l’Environnement de Construction.

Le format d’archive est déterminé par le paramètre de Phase d’Environnement alm.phases.compress.result.archiveFormat. S’il est défini sur zip, tgz ou 7z, le format d’archive choisi sera utilisé. S’il n’est pas défini ou défini sur auto, un format sera choisi en fonction du système d’exploitation de la Machine Agent. Si la Machine Agent exécute un système d’exploitation Windows, la phase de génération de compression crée un fichier .zip, sinon elle crée un fichier .tar.gz.

La Phase Archivage du résultat transfère le fichier de construction compressé à partir de l’Emplacement Cible de l’Environnement de Construction sur la Machine Agent IKAN ALM vers l’Emplacement des Archives de construction sur la Machine Serveur IKAN ALM, utilisant le Transporteur associé à la Machine Agent IKAN ALM.

La Phase Nettoyage de l’Emplacement Source libère tous les fichiers dans l’Emplacement Source de l’Environnement de Construction.

Si l’option Débogage est activée pour l’Environnement de Construction, la Phase Nettoyage de l’Emplacement Source ne fait rien et se termine avec le statut Erreur, rapportant que l’option Débogage est activée pour l’Environnement de Construction.

La Phase Nettoyage de l’Emplacement Cible libère tous les fichiers dans l’Emplacement Cible de l’Environnement de Construction.

Si l’option Débogage est activée pour l’Environnement de Construction, la Phase Nettoyage de l’Emplacement Cible ne fait rien et se termine avec le statut Erreur, rapportant que l’option Débogage est activée pour l’Environnement de Construction.

Outre les Phases de noyau, vous pouvez définir vos propres Phases dans l’Administration globale (Créer une définition de Phase) et spécifier qu’elles peuvent être utilisées sur un Environnement de construction. Une fois insérée dans le flux de travail d’un Environnement de construction, nous les appelons des Phases de construction personnalisées.

La Phase de construction personnalisée exécute un script sur la Machine de l’Agent IKAN ALM en utilisant l’Outil de script spécifié et les Paramètres de construction prédéfinis. Le nom d’affichage de cette Phase et le script exécuté (alm.phase.mainScript) sont spécifiés dans la définition de cette Phase personnalisée dans l’Administration globale. L’Outil de script (alm.phase.builder) qui exécute le script dépend du Type d’exécution spécifié dans la définition de la Phase. Si ce type d’exécution est différent de l’Outil de script associé à l’Environnement de construction, sa valeur doit être établie après l’insertion de cette Phase dans un Environnement de construction.

La Phase de construction personnalisée a été introduite à partir de la version 5.5 d’IKAN ALM. Le journal généré par le script est sauvegardé dans la base de données d’IKAN ALM. Notez que cette Phase n’est jamais insérée dans le flux de travail par défaut d’un Environnement de construction (par exemple, lors de la création d’un nouvel Environnement de construction à partir de zéro).

Si le script réussit, la Phase de Construction personnalisée se termine avec le statut Réussi. Si non, il se termine avec le statut Erreur et affiche les erreurs sur l’onglet Journaux de Phase de l’écran Informations détaillées (Actions de Construction).

La Phase Transfert du fichier de construction archivée transfère le résultat de construction à partir de l’Emplacement des Archives de construction sur la Machine Serveur IKAN ALM vers l’Emplacement Source de l’Environnement de Déploiement sur la Machine Agent IKAN ALM, utilisant le Transporteur associé.

Dans le cas d’un Déploiement partiel, uniquement les fichiers modifiés et ajoutés dans le résultat de construction seront transférés. Pour la description du champ Déploiement partiel, se référer à la section Créer un environnement de déploiement.

La Phase Décompression du fichier de construction décompresse le fichier du résultat de construction transféré vers l’Emplacement Source de l’Environnement de Déploiement par la Phase Transfert du résultat de construction. Ensuite, elle libère le fichier du résultat de construction.

La Phase Vérification du script de déploiement essaie de localiser le Script de déploiement défini. La Phase échoue si elle n’y parvient pas.

D’abord, elle détermine le script de déploiement à utiliser. Si un script de déploiement a été défini au niveau de l’Environnement de Déploiement (Créer un Environnement de déploiement), elle essaiera de le localiser. Si ce n’est pas le cas, elle vérifiera si un script de déploiement a été défini au niveau du Projet (Modifier les paramètres d’un Projet).

Ensuite, elle essaiera de localiser le script de déploiement dans le résultat de construction décompressé disponible dans l’Emplacement Source de l’Environnement de Déploiement.

Si elle ne parvient pas à le localiser pas, elle essaiera de copier le script de déploiement de l’Emplacement des Scripts IKAN ALM tel que défini dans les Paramètres système (Paramètres du système).

Si le script n’est pas non plus trouvé à cet endroit, la Phase Vérification du script de déploiement se termine avec le statut Erreur.

Si le script est localisé, la Phase Vérification du script de déploiement se termine avec le statut Réussi rapportant où elle a localisé le script de déploiement.

La Phase Exécution script exécute le script de déploiement sur la Machine définie en utilisant l’Outil de script spécifié ainsi que les Paramètres de déploiement définis.

Un Journal de déploiement sera généré par le script de déploiement dans la base de données d’IKAN ALM.

Si le script de déploiement réussit, la Phase Exécution script se termine avec le statut Réussi. Si non, il se termine avec le statut Erreur et affiche les erreurs sur l’onglet Journaux de Phase de l’écran Informations détaillées (Actions de Déploiement).

La Phase Nettoyage du fichier de construction archivée libère tous les fichiers dans l’Emplacement Source de l’Environnement de Déploiement.

Si l’option Débogage est activée pour l’Environnement de Déploiement, la Phase Nettoyage du fichier de construction archivée ne fait rien et se termine avec le statut Erreur, rapportant que l’option Débogage est activée pour l’Environnement de Déploiement.

Outre les Phases de noyau, vous pouvez définir vos propres Phases dans l’Administration globale (Phases) et spécifier qu’elles peuvent être utilisées sur un Environnement de déploiement. Une fois insérée dans le flux de travail d’un Environnement de déploiement, nous les appelons des Phases de déploiement personnalisées.

La Phase de déploiement personnalisée exécute un script sur la Machine de l’Agent IKAN ALM en utilisant l’Outil de script spécifié et les Paramètres de déploiement prédéfinis. Le nom d’affichage de cette Phase et le script exécuté (alm.phase.mainScript) sont spécifiés dans la définition de cette Phase personnalisée dans l’Administration globale. L’Outil de script (alm.phase.builder) qui exécute le script dépend du Type d’exécution spécifié dans la définition de la Phase. Si ce type d’exécution est différent de l’Outil de script associé à l’Environnement de déploiement, sa valeur doit être établie après l’insertion de cette Phase dans un Environnement de déploiement.

La Phase de déploiement personnalisée a été introduite à partir de la version 5.5 d’IKAN ALM. Le journal généré par le script est sauvegardé dans la base de données d’IKAN ALM. Notez que cette Phase n’est jamais insérée dans le flux de travail par défaut d’un Environnement de déploiement (par exemple, lors de la création d’un nouvel Environnement de déploiement à partir de zéro).

Si le script réussit, la Phase de déploiement personnalisée se termine avec le statut Réussi. Si non, il se termine avec le statut Erreur et affiche les erreurs sur l’onglet Journaux de Phase de l’écran Informations détaillées (Actions de Déploiement).