Vous pouvez exécuter un pipeline à partir de la fiche de pipeline, en mode d'édition de pipeline et à partir de l'exécution de pipeline. Vous pouvez également utiliser les déclencheurs disponibles pour que Code Stream exécute un pipeline lorsque certains événements se produisent.

Lorsque toutes les étapes et tâches du pipeline sont valides, le pipeline est prêt à être publié, exécuté ou déclenché.

Pour exécuter ou déclencher votre pipeline à l'aide de Code Stream, vous pouvez activer et exécuter le pipeline à partir de la fiche de pipeline ou pendant que vous vous trouvez dans le pipeline. Ensuite, vous pouvez afficher l'exécution du pipeline pour confirmer que le pipeline a créé, testé et déployé votre code.

Lorsqu'une exécution de pipeline est en cours, vous pouvez supprimer l'exécution si vous êtes un administrateur ou un utilisateur non-administrateur.

  • Administrateur : pour supprimer l'exécution d'un pipeline en cours d'exécution, cliquez sur Exécutions. Sur l'exécution à supprimer, cliquez sur Actions > Supprimer.
  • Utilisateur non-administrateur : pour supprimer l'exécution d'un pipeline en cours d'exécution, cliquez sur Exécutions, puis cliquez sur Alt Maj d.

Lorsqu'une exécution de pipeline est en cours et semble bloquée, un administrateur peut actualiser l'exécution à partir de la page Exécutions ou de la page Détails de l'exécution.

  • Page Exécutions : cliquez sur Exécutions. Sur l'exécution à actualiser, cliquez sur Actions > Synchroniser.
  • Page Détails de l'exécution : cliquez sur Exécutions, cliquez sur le lien vers les détails de l'exécution, puis sur Actions > Synchroniser.

Pour exécuter un pipeline lorsque des événements spécifiques se produisent, utilisez les déclencheurs.

  • Le déclencheur Git peut exécuter un pipeline lorsque les développeurs mettent à jour le code.
  • Le déclencheur Gerrit peut exécuter un pipeline lors de révisions de code.
  • Le déclencheur Docker peut exécuter un pipeline lorsqu'un artefact est créé dans un registre Docker.
  • La commande curl ou la commande wget peut demander à Jenkins d'exécuter un pipeline à la fin d'une génération Jenkins.

Pour plus d'informations sur l'utilisation de déclencheurs, reportez-vous à la section Déclenchement des pipelines dans Code Stream.

La procédure suivante indique comment exécuter un pipeline à partir de la fiche de pipeline, afficher les exécutions, afficher les détails de l'exécution et utiliser les actions. Elle indique également comment libérer un pipeline afin de pouvoir l'ajouter à vRealize Automation Service Broker.

Conditions préalables

Procédure

  1. Activez votre pipeline.
    Pour pouvoir exécuter ou libérer un pipeline, vous devez d'abord l'activer.
    1. Cliquez sur Pipelines.
    2. Sur votre fiche de pipeline, cliquez sur Actions > Activer.
      Dans le menu Actions sur la fiche de pipeline, vous devez activer le pipeline avant de pouvoir l'exécuter.

      Vous pouvez également activer le pipeline lorsque vous vous trouvez dans celui-ci. Si le pipeline est déjà activé, l'option Exécuter est active et le menu Actions affiche Désactiver.

  2. (Facultatif) Publiez votre pipeline.
    Si vous souhaitez mettre à disposition votre pipeline en tant qu'élément du catalogue dans vRealize Automation Service Broker, vous devez le publier dans Code Stream.
    1. Cliquez sur Pipelines.
    2. Sur votre fiche de pipeline, cliquez sur Actions > Publier.
      Vous pouvez également publier le pipeline lorsque vous vous trouvez dans celui-ci.
      Dans le menu Actions de la configuration du modèle de pipeline, vous pouvez publier le pipeline.

      Après avoir publié le pipeline, vous ouvrez Service Broker pour ajouter le pipeline en tant qu'élément du catalogue et l'exécuter. Reportez-vous à la section Ajouter des pipelines Code Stream au catalogue Service Broker dans Utilisation et gestion de Service Broker.

      Note : Si le pipeline nécessite plus de 120 minutes pour s'exécuter, fournissez un temps d'exécution approximatif en tant que valeur de délai d'expiration de la demande. Pour définir ou vérifier le délai d'expiration de la demande d'un projet, ouvrez Service Broker en tant qu'administrateur et sélectionnez Infrastructure > Projets. Cliquez sur le nom de votre projet, puis cliquez sur Provisionnement.

      Si la valeur de délai d'expiration de la demande n'est pas définie, une exécution qui nécessite plus de 120 minutes pour s'exécuter apparaît comme ayant échoué avec une erreur d'expiration de la demande de rappel. Toutefois, l'exécution du pipeline n'est pas affectée.

  3. Sur la fiche de pipeline, cliquez sur Exécuter.
  4. Pour afficher le pipeline au fil de son exécution, cliquez sur Exécutions.
    Le pipeline exécute chaque étape dans l'ordre, et l'exécution du pipeline affiche une icône d'état pour chaque étape. Si le pipeline inclut une tâche d'opération utilisateur, un utilisateur doit approuver la tâche pour que le pipeline continue de s'exécuter. Lorsqu'une tâche d'opération utilisateur est utilisée, l'exécution du pipeline s'interrompt jusqu'à ce que l'utilisateur requis approuve la tâche.
    Par exemple, vous pouvez utiliser la tâche d'opération utilisateur pour approuver le déploiement de code dans un environnement de production.
    Si le délai d'expiration de la tâche Opération de l'utilisateur est défini en jours, heures ou minutes, l'utilisateur requis doit approuver le pipeline avant l'expiration de la tâche. Sinon, le pipeline échoue comme prévu.
    Un pipeline qui a été exécuté et qui attend une approbation affiche l'état d'attente en regard des étapes.
  5. Pour savoir quelle étape du pipeline est en attente d'approbation de l'utilisateur, cliquez sur l'icône d'état de l'étape.
    L'étape de pipeline en attente d'approbation affiche les tâches de l'étape.
  6. Pour afficher les détails de la tâche, cliquez sur celle-ci.
    Une fois que l'utilisateur requis a approuvé la tâche, un utilisateur disposant du rôle approprié doit reprendre le pipeline. Pour connaître les rôles requis, reportez-vous à Gestion de l'accès et des approbations utilisateur dans Code Stream.
    Si une exécution échoue, vous devez identifier et corriger la cause de l'échec. Ensuite, accédez à l'exécution, puis cliquez sur Actions > Exécuter à nouveau.
    Vous pouvez reprendre les exécutions de pipeline principal et les exécutions imbriquées.
    Une tâche de pipeline en attente d'approbation affiche un lien qui ouvre la tâche.
  7. À partir de l'exécution du pipeline, vous pouvez cliquer sur Actions pour afficher le pipeline et sélectionner une action telle que Pause, Annuler et plus encore. Lorsqu'une exécution de pipeline est en cours, si vous êtes administrateur vous pouvez supprimer ou synchroniser l'exécution du pipeline. Si vous êtes un utilisateur non-administrateur, vous pouvez supprimer un pipeline en cours d'exécution.
  8. Pour naviguer facilement entre les exécutions et afficher les détails d'une tâche, cliquez sur Exécutions, puis cliquez sur une exécution de pipeline. Cliquez ensuite sur l'onglet en haut et sélectionnez l'exécution du pipeline.
    Pour examiner une exécution de pipeline spécifique, cliquez sur l'un des numéros d'exécution du pipeline en haut.

Résultats

Félicitations ! Vous avez exécuté un pipeline, examiné l'exécution du pipeline et affiché une tâche d'opération utilisateur qui exigeait une approbation pour que le pipeline continue de s'exécuter. Vous avez également utilisé le menu Actions dans l'exécution du pipeline pour revenir au modèle de pipeline afin d'y apporter toute modification requise.

Que faire ensuite

Pour plus d'informations sur l'utilisation de Code Stream pour automatiser votre cycle de publication logicielle, reportez-vous à la section Didacticiels d'utilisation de Code Stream.