Partager via


Groupes de tâches dans les pipelines Classiques

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

Dans les pipelines classiques, un groupe de tâches encapsule une séquence de tâches déjà définies dans un pipeline dans une tâche unique réutilisable. Le nouveau groupe de tâches est automatiquement ajouté au catalogue de tâches et peut être ajouté aux pipelines du projet de la même façon que d’autres tâches. Les groupes de tâches sont stockés au niveau du projet et ne sont pas accessibles en dehors de l’étendue du projet.

Les groupes de tâches offrent un moyen de standardiser et de gérer de manière centralisée les étapes de déploiement pour toutes vos applications. Lorsque vous apportez une modification de manière centralisée à un groupe de tâches, la modification est automatiquement répercutée dans toutes les définitions de pipeline qui utilisent le groupe de tâches. Vous n’avez pas besoin de modifier chaque définition individuellement.

Remarque

Les groupes de tâches ne sont pas pris en charge dans les pipelines YAML. En remplacement, vous pouvez utiliser des modèles.

Prérequis

  • Une organisation et un projet Azure DevOps dans lesquels vous êtes autorisé à créer des pipelines.
  • Un pipeline classique créé dans le projet.

Extraire les paramètres de tâche en tant que variables

Lorsque vous créez un groupe de tâches, vous pouvez choisir d’extraire les paramètres des tâches encapsulées en tant que variables de configuration et de faire abstraction du reste des informations de tâches. Les variables utilisées dans les tâches sont automatiquement extraites et converties en paramètres pour le groupe de tâches, et les valeurs de ces variables de configuration sont converties en valeurs par défaut pour le groupe de tâches.

Vous pouvez également modifier les valeurs par défaut des paramètres lorsque vous enregistrez le nouveau groupe de tâches. Lorsque vous mettez en file d’attente une exécution de pipeline ou une mise en production, les tâches encapsulées sont extraites et les valeurs que vous avez entrées pour les paramètres du groupe de tâches sont appliquées aux tâches.

Avant de créer un groupe de tâches, veillez à définir les paramètres que vous souhaitez pouvoir configurer dans vos exécutions de pipeline en tant que variables, telles que $(MaVariable). Tous les paramètres de tâche qui n’ont aucune valeur ou qui possèdent des valeurs spécifiées au lieu de variables deviennent des paramètres fixes et ne sont pas exposés au groupe de tâches en tant que paramètres configurables.

Vous pouvez également configurer des conditions de tâches dans un groupe de tâches, telles que Exécuter cette tâche uniquement en cas d’échec d’une tâche précédente pour une tâche PowerShell Script, et ces conditions sont persistantes dans le groupe de tâches.

Remarque

Les groupes de tâches sont pris en charge dans les pipelines classiques et les pipelines de mise en production classiques.

Créer un groupe de tâches

Lorsque vous enregistrez un nouveau groupe de tâches, vous lui attribuez un nom et une description, puis vous sélectionnez une catégorie pour votre groupe de tâches dans le catalogue de tâches.

  1. Ouvrez le pipeline dans lequel vous souhaitez créer un groupe de tâches.

  2. Pour vous assurer qu’aucune des tâches que vous envisagez d’inclure ne contient de paramètres liés, sélectionnez Tout dissocier dans le panneau des paramètres du pipeline, puis sélectionnez Confirmer.

    Capture d’écran montrant comment dissocier les paramètres pour toutes les tâches.

  3. Sélectionnez une séquence de tâches de pipeline que vous souhaitez transformer en groupe de tâches, cliquez avec le bouton droit pour ouvrir le menu contextuel, puis choisissez Créer un groupe de tâches.

    Capture d'écran montrant comment créer un groupe de tâches à partir d’une liste de tâches de pipeline de mise en production.

  4. Spécifiez un nom et une description pour le nouveau groupe de tâches, ainsi que la catégorie dans le panneau Ajouter des tâches à laquelle vous souhaitez l’ajouter.

  5. Sélectionnez Créer. Le nouveau groupe de tâches est créé et remplace les tâches sélectionnées dans votre pipeline.

  6. Toutes les '$(vars)' des tâches sous-jacentes, à l’exception des variables prédéfinies, apparaissent en tant que paramètres obligatoires pour le nouveau groupe de tâches créé.

    Par exemple, si vous avez une entrée de tâche foobar que vous n’avez pas l’intention de paramétriser, l’entrée de tâche sera convertie en paramètre de groupe de tâches 'foobar'. Vous pouvez définir la valeur par défaut du paramètre de groupe de tâches 'foobar' sur $(foobar) de manière à ce qu’au moment de l’exécution, la tâche développée obtienne l’entrée que vous souhaitez.

  7. Enregistrez votre pipeline mis à jour.

Gérer un groupe de tâches

Tous les groupes de tâches du projet actif sont répertoriés sous Pipelines sur la page Groupes de tâches.

Capture d’écran montrant la liste des groupes de tâches.

En haut de la page Groupes de tâches, vous pouvez sélectionner Importer pour importer des définitions de groupe de tâches précédemment enregistrées. Vous pouvez utiliser cette fonctionnalité pour transférer des groupes de tâches entre des projets et des entreprises, ou répliquer et enregistrer des copies de vos groupes de tâches.

Vous pouvez également sélectionner Sécurité en haut de la page pour définir qui peut utiliser, modifier, supprimer ou définir des autorisations pour tous les groupes de tâches du projet.

Pour gérer un groupe de tâches, cliquez avec le bouton droit ou sélectionnez l’icône Autres actions pour le groupe, puis choisissez l’une des options suivantes dans le menu contextuel :

  • Choisissez Supprimer pour supprimer le groupe de tâches, puis sélectionnez à nouveau Supprimer dans l’écran de confirmation.
  • Sélectionnez Exporter pour enregistrer une copie du groupe de tâches en tant que pipeline JSON.
  • Sélectionnez Sécurité pour définir qui peut utiliser, modifier, supprimer ou définir des autorisations pour le groupe de tâches.

Pour ouvrir la page des détails du groupe de tâches pour modification, sélectionnez le nom du groupe de tâches sur la page Groupes de tâches .

Capture d’écran montrant la gestion d’un groupe de tâches.

  • Dans l'onglet Tâches , vous pouvez modifier les tâches qui composent le groupe de tâches. Pour chaque tâche encapsulée, vous pouvez modifier les valeurs des paramètres qui ne sont pas des variables, modifier les variables de paramètres existantes ou convertir des valeurs de paramètres vers et à partir de variables. Lorsque vous enregistrez les modifications, toutes les définitions qui utilisent le groupe de tâches récupèrent les modifications.

    Tous les paramètres variables du groupe de tâches s’affichent en tant que paramètres obligatoires dans la définition du pipeline. Vous pouvez également définir les valeurs par défaut des paramètres du groupe de tâches.

  • Dans l’onglet Historique , vous pouvez visualiser l’historique des modifications apportées au groupe.

  • Dans l’onglet Références , vous pouvez consulter la liste de tous les pipelines et celle des autres groupes de tâches qui référencent ce groupe de tâches. Cette listes vous aident à vous assurer que les modifications n'aient pas d’effets inattendus sur d’autres processus.

Créer une préversion et des versions mises à jour de groupes de tâches

Toutes les tâches Azure Pipelines intégrées sont versionnées. Ceci permet aux pipelines de continuer à utiliser la version existante d’une tâche pendant que de nouvelles versions sont développées, testées et publiées. Vous pouvez versionner vos groupes de tâches personnalisés de la même façon afin qu'ils offrent les mêmes avantages.

  1. Pour versionner un groupe de tâches, une fois que vous avez fini de le modifier, sélectionnez >Enregistrer comme brouillon en lieu et place de Enregistrer.

    Capture d’écran montrant comment enregistrer une version provisoire d'un groupe de tâches.

  2. La chaîne test est ajoutée au numéro de version du groupe de tâches. Lorsque vous êtes satisfait des modifications, choisissez Publier le brouillon. Dans l’écran Publier un groupe de tâches brouillon , sélectionnez Publier la préversion si vous souhaitez publier la nouvelle version en préversion, puis sélectionnez Publier.

    Capture d’écran montrant comment publier une version provisoire d’un groupe de tâches.

  3. Vous pouvez à présent utiliser le groupe de tâches mis à jour dans vos processus de mise en production. Vous pouvez soit modifier le numéro de version dans les pipelines qui utilisent déjà le groupe de tâches, soit sélectionner le groupe de tâches versionné dans le volet Ajouter des tâches. Comme pour les tâches intégrées, la valeur par défaut lorsque vous ajoutez un groupe de tâches est la version hors préversion la plus élevée.

    Capture d’écran montrant comment utiliser une version provisoire d’un groupe de tâches.

  4. Une fois vos tests du groupe de tâches mis à jour terminés, choisissez Publier la préversion, puis sélectionnez Publier. La chaîne Preview est supprimée du numéro de version, et la version apparaît désormais dans les définitions en tant que version prête pour la production.

    Capture d’écran montrant comment publier une préversion d’un groupe de tâches.

  5. Vous pouvez à présent sélectionner la nouvelle version prête pour la production dans un pipeline qui contient déjà le groupe de tâches. Lorsque vous ajoutez le groupe de tâches à partir du panneau Ajouter des tâches , il sélectionne automatiquement la nouvelle version prête pour la production. Vous pouvez modifier le pipeline pour qu'il utilise une version antérieure.

    Capture d’écran montrant comment utiliser une version mise à jour d’un groupe de tâches.

Utilisation des versions d'un groupe de tâches

Les mises à jour des groupes de tâches peuvent être des mises à jour de version mineure ou majeure.

Créer une mise à jour de version mineure

Pour créer une mise à jour de version mineure, vous enregistrez directement le groupe de tâches après l’avoir modifié au lieu de l’enregistrer comme brouillon.

Le numéro de version ne change pas et les dernières modifications s’affichent automatiquement dans la définition du pipeline. Par exemple, si votre groupe de tâches est une version 1, vous pouvez avoir n’importe quel nombre de mises à jour de version mineures, telles que 1.1, 1.2 et 1.3. Dans votre pipeline, la version du groupe de tâches s’affiche sous la forme 1.*.

Utilisez des mises à jour de version mineure pour les petites modifications apportées au groupe de tâches, lorsque vous souhaitez que les pipelines utilisent ces modifications sans modifier le numéro de version dans la définition du pipeline.

Créer une mise à jour de version majeure

Pour créer une nouvelle version majeure, vous enregistrez votre mise à jour du groupe de travail en tant que brouillon et créez une préversion, vous validez les modifications, puis vous publiez votre préversion.

Ce processus attribue une nouvelle version au groupe de tâches. Si vous aviez un groupe de tâches de version 1.*, les nouvelles versions seront publiées en tant que 2.*, 3.*, 4.*, et ainsi de suite.

Une notification sur la disponibilité de la nouvelle version s’affichera dans toutes les définitions de pipeline utilisant le groupe de tâches. Les utilisateurs devront explicitement demander une mise à jour vers la nouvelle version du groupe de tâches s’ils souhaitent l’utiliser dans leurs pipelines.

Lorsque vous apportez des modifications substantielles susceptibles d’interrompre les pipelines existants, vous pouvez les tester et les déployer sous la forme d'une nouvelle version majeure. Les utilisateurs peuvent choisir de passer à la nouvelle version ou de rester sur la même. Cette fonctionnalité est la même que pour une mise à jour de version de tâche ordinaire.

Tester une mise à jour de version mineure

Si la mise à jour de votre groupe de tâches n’est pas une modification substantielle, mais que vous souhaitez d’abord la tester avant de forcer tous les pipelines à l'utiliser, procédez comme suit :

  1. Enregistrez les modifications apportées au groupe de tâches en tant que brouillon. Un nouveau groupe de tâches brouillon nommé <Nomgroupetâche> (Brouillon) est créé avec vos modifications.
  2. Ajoutez ce groupe de tâches brouillon directement à votre pipeline de test.
  3. Validez les modifications dans votre pipeline de test. Une fois vos modifications validées, revenez à votre groupe de tâches principal, effectuez les mêmes modifications et enregistrez-les directement. Les modifications sont enregistrées sous forme de mise à jour de version mineure.
  4. Les nouvelles modifications s’affichent désormais dans tous les pipelines qui utilisent ce groupe de tâches. Vous pouvez maintenant supprimer votre groupe de tâches brouillon.

Aide et support