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. Les utilisateurs Service Broker peuvent ajouter et exécuter un pipeline qui a été publié dans Code Stream.

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 peut demander à Jenkins d'exécuter un pipeline à la fin d'une build Jenkins.

Pour plus d'informations sur l'utilisation de déclencheurs, reportez-vous à la section Déclenchement des pipelines dans VMware 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 à VMware 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.
      Activez un pipeline dans le menu Actions pour 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 VMware 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.
      Publier le pipeline à partir de la configuration du modèle

      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.

      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.
    Exemple d'exécution d'un pipeline en attente d'approbation.
  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.
    Exemple d'étape de pipeline en attente d'approbation.
  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 uniquement reprendre les exécutions de pipeline maître. Vous ne pouvez pas reprendre les exécutions imbriquées.
    Exemple de tâche de pipeline en attente d'approbation.
  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.

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 VMware Code Stream.