Mettre une build en file d'attente

Après avoir effectué definir vos processus de build 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 déclencheursautomatique.Si votre définition de build est associée à un déclencheur manuel ou automatique, vous pouvez mettre manuellement en file d'attente une génération dès que cela est nécessaire.

Tâches	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.	Builds publiques Start, commande (Team Foundation Build)
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 .	Builds privées Start, commande (Team Foundation Build)
Redémarrez une build terminée si vous souhaitez mettre en file d'attente une build privée ou publique à l'aide des mêmes options qu'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.

Autorisations requises

Pour suivre cette procédure, votre autorisation pour Mettre les builds en file d'attente doit être définie à Autoriser.Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Pour mettre en file d'attente une build publique dans Visual Studio

1. Dans l'Explorateur d'équipes :

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

   2. Sélectionnez Home, puis Builds.

   3. Dans la page Builds , sous Définitions de build favorites ou Toutes les définitions de build, ouvre le menu contextuel d'une définition de build, puis choisissez Queue New Build.

   La boîte de dialogue Mettre en file d'attente la buildNomProjetÉquipe s'affiche.

2. Dans la liste Définition de build , la définition de build est sélectionnée et sa description est affichée plus bas.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 ?, laissez l'option Sources les plus récentes 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) la zone Dossier cible pour cette build affiche l'emplacement où les sorties comme les fichiers binaires et des fichiers journaux sont stockés lorsque la génération est terminée.Si vous souhaitez stocker les sorties dans un autre emplacement, tapez dans le champ le chemin d'accès UNC (Universal Naming Convention) à cet emplacement.

   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 temporaire 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 Définir un processus de build basé sur le modèle par défaut ou Utiliser les processus de génération hérités pour plus d'informations sur ces paramètres.

8. Choisissez Mettre en file d'attente.

Builds privées

Vous mettez en file d'attente une build privée si vous souhaitez générer les changements que vous avez placé dans un shelveset.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 effectuant une build privée de vos modifications avant de les archiver, vous pouvez réduire le niveau de probabilité qu'elles risquent toutes les builds que votre équipe exécute régulièrement, telles que la génération 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 à une build d'archivage contrôlé Dans lequel vous écrivez du code qui inclus des changements 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é.

• On considère que les paramètres de processus de génération suivants ont la valeur False et par conséquent n'ont aucun effet, indépendamment du paramètre spécifié dans la définition de build :

  • Sources d'étiquettes

  • Créer un élément de travail en cas d'échec

  • Associer 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 :

• La build terminée est nommé à l'aide de le format BuildN où N est une seule valeur entière.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

Autorisations requises

Pour suivre cette procédure, votre autorisation pour Mettre les builds en file d'attente doit être définie à Autoriser.Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Pour mettre en file d'attente une build privée dans Visual Studio

1. Dans l'Explorateur d'équipes :

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

   2. Sélectionnez Home, puis Builds.

   3. Dans la page Builds , sous Définitions de build favorites ou Toutes les définitions de build, ouvre le menu contextuel d'une définition de build, puis choisissez Queue New Build.

   La boîte de dialogue Mettre en file d'attente la buildNomProjetÉquipe s'affiche.

2. Dans la liste Définition de build , la définition de build est sélectionnée et sa description est affichée plus bas.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 choisissez le bouton de sélection (…) pour rechercher le jeu de réservations.

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

5. Si vous souhaitez archiver les modifications dans le jeu de réservations si la génération est réussie, cochez la case Archiver les modifications après une build réussie (facultatif).

   Important

   Si vous cochez cette case, la génération 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 Définir 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. (Facultatif) suivez ces étapes pour spécifier le dossier dans lequel les résultats produits, comme les fichiers binaires, de la génération sont téléchargées :

   [!REMARQUE]

   Ignorez l'option Dossier de dépôt pour cette build car elle n'a aucun effet sur une build privée.

   1. Choisissez l'onglet Paramètres, puis développez le groupe Avancé.

   2. Dans la zone Emplacement de dépôt privé, entrez le chemin d'accès UNC au dossier dans lequel vous souhaitez stocker les résultats à l'issue de la génération.

      [!REMARQUE]

      • Si vous ne spécifiez pas ce dossier, la génération n'échouera pas, mais un message d'avertissement s'affichera dans le journal de génération.

      • 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.Pour plus d'informations, consultez Configurer des dossiers de dépôt.

9. 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 Définir un processus de build basé sur le modèle par défaut ou Utiliser les processus de génération hérités pour plus d'informations sur ces paramètres.

10. Choisissez Mettre en file d'attente.

Réessayer une build terminée

Lorsque vous testez des modifications potentielles à un processus de génération ou des essais avec les options, vous pouvez rapidement mettre en file d'attente une build privée ou publique à l'aide des mêmes options que vous avez spécifiée lorsque vous avez mis en file d'attente la build qui est maintenant terminée.

Pour redémarrer une build terminée depuis la page de builds

• Dans l'Explorateur d'équipes :

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

  2. Sélectionnez Home, puis Builds.

  3. Dans la page Builds , sous Mes builds, ouvrez le menu contextuel pour une build terminée, puis choisissez Génération de démarrage.