Share via

Mettre une build en file d'attente

  • Article

Après avoir défini vos processus de génération en créant une ou plusieurs définitions de build, vous pouvez commencer à profiter des avantages de votre système de génération. La plupart des processus de génération sont définis avec des déclencheurs automatiques. Si votre définition de build est associée à un déclencheur manuel ou automatique, vous pouvez mettre manuellement en file d'attente une build dès que cela est nécessaire.

Important

Si vous utilisez Visual Studio 2013 avec Visual Studio Team Foundation Server 2013, vous pouvez rencontrer des problèmes au moment de modifier les paramètres du processus de génération lorsque vous mettez une build en file d'attente.Procurez-vous le correctif logiciel KB 2898341.

Tâches courantes

Contenu de support

Mettez en file d'attente une build publique si vous souhaitez générer la version la plus récente du code source sur le serveur de contrôle de version.

Pour mettre en file d'attente une build publique à partir d'une invite de commandes, utilisez la commande TFSBuild start.

Mettez en file d'attente une build privée si vous souhaitez générer les modifications que vous avez placées dans un jeu de réservations. Vous pouvez utiliser une build privée (également appelée « génération associée ») pour valider les modifications apportées à votre code avant de l'archiver.

Pour mettre en file d'attente une build privée à partir d'une invite de commandes, utilisez la commande TFSBuild start avec l'option /shelveset.

Réessayer une build terminée si vous souhaitez mettre en file d'attente une build privée ou publique à l'aide des mêmes options que celles d'une build terminée.

Réessayer une build terminée

Builds publiques

Indépendamment du fait qu'un déclencheur automatique est spécifié dans une définition de build, vous pouvez manuellement mettre la build en file d'attente.

  1. Dans l'Explorateur d'équipes :

    1. Si vous n'êtes pas déjà connecté au projet d'équipe auquel vous souhaitez participer, connectez-vous au projet d'équipe.

    2. Sélectionnez Icône Accueil Accueil, puis Icône des builds Builds (raccourci clavier : Ctrl + 0, B).

    3. Dans la page Builds, sous Définitions de build favorites ou Toutes les définitions de build, ouvrez le menu contextuel d'une définition de build, puis choisissez Mettre en file d'attente une nouvelle build.

    La boîte de dialogue Mettre la build en file d'attente TeamProjectName s'ouvre.

  2. Dans la liste Définition de build, la définition de build est sélectionnée et sa description est affichée en dessous. Si vous souhaitez mettre en file d'attente une définition de build différente, vous pouvez en sélectionner une dans la liste.

  3. Dans la liste Que voulez-vous générer ?, vérifiez que l'option Sources les plus récentes est sélectionnée.

  4. Dans la liste Contrôleur de build, sélectionnez un contrôleur de build autre que le contrôleur de build par défaut (facultatif).

  5. (Facultatif) Dans la liste Priorité dans la file d'attente, sélectionnez l'une des valeurs suivantes : Haute, Supérieure à la normale, Normale, Inférieure à la normale ou Basse.

    Le champ Position affiche la position estimée de la build dans la file d'attente.

  6. (Facultatif) Le champ Dossier cible pour cette build affiche l'emplacement où les résultats produits, comme les fichiers binaires et les fichiers journaux, sont enregistrés à l'issue de la build. Si vous souhaitez stocker les sorties dans un autre emplacement, tapez le chemin d'accès à celui-ci dans ce champ.

    Important

    Si vous modifiez cette valeur, vous devez spécifier le dossier qui a été préparé pour une utilisation comme dossier de dépôt.Vous ne pouvez pas modifier cette valeur si vous avez spécifié Copier sur le serveur la sortie de la génération comme emplacement intermédiaire pour la définition de build.

    Consultez Configurer des dossiers de dépôt.

  7. Sous l'onglet Paramètres, affichez et remplacez d'autres paramètres de la définition de build pour cette exécution uniquement (facultatif).

    Si la définition de build est basée sur le Modèle par défaut ou le Modèle de mise à niveau, consultez Utiliser le modèle par défaut pour un processus de build ou Résoudre des problèmes pouvant se produire lors de la mise à niveau pour plus d'informations sur ces paramètres.

  8. Choisissez Mettre en file d'attente.

Builds privées

Mettez en file d'attente une build privée si vous souhaitez générer les modifications que vous avez placées dans un jeu de réservations. Vous pouvez utiliser une build privée (également appelée « génération associée ») pour valider les modifications apportées à votre code avant de l'archiver. En exécutant une build privée à laquelle vous avez apporté des modifications avant d'archiver celles-ci, vous pouvez réduire le risque qu'elles ne causent l'arrêt des builds que votre équipe exécute régulièrement (comme la build nocturne).

Différences entre les builds privées et les builds publiques

Les différences entre les résultats d'une build privée terminée et ceux d'une build publique terminée sont les suivantes :

  • Une build privée s'apparente à unebuild d'archivage contrôlé parce que votre code inclut les modifications dans un jeu de réservations. Cependant, les modifications ne sont pas automatiquement archivées à l'issue de l'exécution d'une build privée, ce qui est le cas pour une build d'archivage contrôlé.

  • La build n'étiquette pas vos sources, ne crée pas d'éléments de travail en cas d'échec, ni n'associe des ensembles de modifications et des éléments de travail.

  • Dans l'Explorateur de builds, la build terminée s'affiche en regard de l'icône suivante : Icon_BldPrivateBuild

  • La build terminée est nommée selon le format Build N où N est un entier unique. Ce format est différent de celui des builds publiques qui est spécifié avec le paramètre Format du numéro de build.

  • Pour chaque définition de build, spécifiez une stratégie de rétention séparée (et éventuellement différente) pour limiter le nombre de builds privées remplies terminées stockées dans le système.

Mettre en file d'attente une build privée

  1. Dans l'Explorateur d'équipes :

    1. Si vous n'êtes pas déjà connecté au projet d'équipe auquel vous souhaitez participer, connectez-vous au projet d'équipe.

    2. Sélectionnez Icône Accueil Accueil, puis Icône des builds Builds (raccourci clavier : Ctrl + 0, B).

    3. Dans la page Builds, sous Définitions de build favorites ou Toutes les définitions de build, ouvrez le menu contextuel d'une définition de build, puis choisissez Mettre en file d'attente une nouvelle build.

    La boîte de dialogue Mettre la build en file d'attente TeamProjectName s'ouvre.

  2. Dans la liste Définition de build, la définition de build est sélectionnée et sa description est affichée en dessous. Si vous souhaitez mettre en file d'attente une définition de build différente, vous pouvez en sélectionner une dans la liste.

  3. Dans la liste Que voulez-vous générer ?, sélectionnez l'option Sources les plus récentes avec jeu de réservations.

    Le champ Nom du jeu de réservations s'affiche.

  4. Effectuez l'une des étapes suivantes :

    • Si vous possédez déjà un jeu de réservations, tapez son nom dans la zone Nom du jeu de réservations ou cliquez sur le bouton de sélection (…) pour rechercher le jeu de réservations.

    • Si vous voulez placer certaines modifications en attente issues de votre espace de travail dans un jeu de réservations, puis générer ces modifications, cliquez sur Créer.

  5. (Facultatif) Si la build est réussie et que vous souhaitez archiver les modifications dans le jeu de réservations, cochez la case Archiver les modifications après une build réussie.

    Important

    Si vous cochez cette case, la build est exécutée comme build d'archivage contrôlé, au lieu de build privée.Pour plus d'informations sur les builds d'archivage contrôlé, consultez Utiliser un processus de génération d'archivage contrôlé pour la validation des modifications.

  6. Dans la liste Contrôleur de build, sélectionnez un contrôleur de build autre que le contrôleur de build par défaut (facultatif).

  7. (Facultatif) Dans la liste Priorité dans la file d'attente, sélectionnez l'une des valeurs suivantes : Haute, Supérieure à la normale, Normale, Inférieure à la normale ou Basse.

    Le champ Position affiche la position estimée de la build dans la file d'attente.

  8. Sous l'onglet Paramètres, affichez et remplacez d'autres paramètres de la définition de build pour cette exécution uniquement (facultatif).

    Si la définition de build est basée sur le Modèle par défaut ou le Modèle de mise à niveau, consultez Utiliser le modèle par défaut pour un processus de build ou Résoudre des problèmes pouvant se produire lors de la mise à niveau pour plus d'informations sur ces paramètres.

  9. Choisissez Mettre en file d'attente.

Réessayer une build terminée

Lorsque vous testez d'éventuelles modifications d'un processus de génération, ou lorsque vous faites des essais avec des options, vous pouvez rapidement mettre en file d'attente une build privée ou publique à l'aide des mêmes options que vous aviez spécifiées lorsque vous avez mis en file d'attente une build à présent terminée.

  • Dans l'Explorateur d'équipes :

    1. Si vous n'êtes pas déjà connecté au projet d'équipe auquel vous souhaitez participer, connectez-vous au projet d'équipe.

    2. Sélectionnez Icône Accueil Accueil, puis Icône des builds Builds.

    3. Dans la page Builds, sous Mes builds, ouvrez le menu contextuel d'une build terminée, puis choisissez Recommencer la build.