Configuration classique des pipelines

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Les pipelines classiques facilitent la conception par les développeurs de leurs flux de travail de pipeline à l’aide de l’interface utilisateur pour ajouter des tâches et des conditions adaptées à leur scénario. Cet article explique les options disponibles pour configurer votre travail d’agent et explorer les différentes propriétés de build de votre pipeline Classic.

Travail de l’agent

  1. Connectez-vous à votre organisation Azure DevOps, puis accédez à votre projet.

  2. Sélectionnez Pipelines, sélectionnez votre définition de pipeline, puis sélectionnez Modifier.

  3. Sélectionnez Tâches, puis sélectionnez Tâche de l’agent.

Pool d’agents par défaut :

Lorsque vous mettez en file d’attente une build, elle s’exécute sur un agent à partir de votre pool sélectionné. Vous pouvez choisir un pool hébergé par Microsoft ou un pool auto-hébergé que vous gérez. Sélectionnez le pool associé aux agents sur utilisant ce pipeline.

Parallélisme

Définit la façon dont les tâches du travail sont exécutées en parallèle :

  • Aucun : les tâches sont exécutées sur un seul agent.

  • Multiconfiguration : les tâches sont exécutées sur plusieurs configurations, comme spécifié dans les multiplicateurs. Les configurations s’exécutent en parallèle, chacune à l’aide d’un seul agent. Le nombre total d’agents dépend du nombre de configurations et peut être limité en définissant un nombre maximal d’agents.

  • Multi-agent : les tâches sont exécutées sur plusieurs agents à l’aide du nombre spécifié d’agents.

Délai d'expiration

Spécifie la durée maximale, en minutes, qu’un déploiement est autorisé à s’exécuter sur un agent avant d’être annulé par le serveur. La durée est mesurée une fois la préapprobation terminée et avant la demande de post-approbation. La valeur zéro entraîne l’utilisation du délai d’expiration du pipeline parent.

Délai d'expiration de l'annulation du travail

Spécifie le délai d’attente maximal pour qu’un travail de déploiement réponde à une demande d’annulation avant d’être arrêté par le serveur. La valeur zéro entraîne l’utilisation du délai d’expiration du pipeline parent.

Autoriser les scripts à accéder au jeton OAuth

Permet aux scripts et à d’autres processus d’accéder au jeton OAuth via la System.AccessToken variable. Pour plus d’informations, consultez l’exemple de script permettant d’accéder à l’API REST.

Capture d’écran montrant comment configurer le travail de l’agent dans un pipeline Classique.

Propriétés de la build

  1. Connectez-vous à votre organisation Azure DevOps, puis accédez à votre projet.

  2. Sélectionnez Pipelines, sélectionnez votre définition de pipeline, sélectionnez Modifier, puis sélectionnez l’onglet Options .

Format du numéro de build

Définissez le format pour donner des noms explicites aux builds terminées. Laissez-le vide pour donner un entier unique en tant que nom. Pour plus d’informations, consultez Configurer les numéros d’exécution de build.

Créer des éléments de travail en cas d’échec

En cas d’échec du pipeline, un élément de travail est automatiquement créé pour suivre le problème. Vous pouvez spécifier le type d’élément de travail et choisir s’il faut l’affecter au demandeur.

  • Champs supplémentaires : définissez des champs supplémentaires lors de la création de l’élément de travail.

Par exemple, « System.Title » = « Build $(build.buildNumber) a échoué » met en forme le titre de l’élément de travail et « System.Reason » = « Échec de build » définit la raison. Consultez l’index de champ d’élément de travail pour d’autres champs disponibles.

Générer la tâche

Définissez les paramètres d’autorisation et de délai d’expiration du travail de génération.

  • Étendue d’autorisation du travail de génération : spécifiez l’étendue d’autorisation d’un travail de génération. Sélectionnez :

    • Collection de projets : si le pipeline a besoin d’accéder à plusieurs projets.
    • Projet actuel : si vous souhaitez restreindre ce pipeline pour accéder uniquement aux ressources du projet actuel.

Pour plus d’informations, consultez Comprendre les jetons d’accès aux travaux.

  • Délai d’expiration du travail de génération en minutes : spécifie la durée maximale pendant laquelle un travail de génération est autorisé à s’exécuter sur un agent avant d’être annulé par le serveur. Une valeur vide ou nulle indique aucune limite de délai d’expiration.

  • Délai d’expiration du délai d’annulation du travail de génération en minutes : spécifie le délai d’attente maximal pour qu’un travail de build réponde à une demande d’annulation avant d’être arrêté par le serveur.

Demandes

Spécifiez les fonctionnalités que l’agent doit avoir à exécuter ce pipeline. Consultez les fonctionnalités de l’agent et les demandes pour plus d’informations.

Capture d’écran montrant comment configurer les différentes propriétés de build dans un pipeline Classique.