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. Pour plus d'informations, consultez Spécifier les raisons et les déclencheurs de build.

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 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.

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 que vous puissiez effectuer cette procédure, votre autorisation Mettre les builds en file d'attente doit être définie sur 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 Team Explorer, cliquez sur le projet d'équipe approprié.

  2. Dans le menu Générer, cliquez sur Mettre en file d'attente une nouvelle build.

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

  3. Dans la liste Définition de build, sélectionnez une définition de build.

    Si la définition de build sélectionnée comporte une description, celle-ci apparaît dans la liste Définition de build.

  4. Dans la liste Que voulez-vous générer ?, laissez l'option Sources les plus récentes sélectionnée.

  5. 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).

  6. (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.

  7. Le champ Dossier de dépôt pour cette build affiche le dossier dans lequel les résultats produits, comme les fichiers binaires, sont enregistrés à l'issue de la génération (facultatif). 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. Pour plus d'informations, consultez Configurer des dossiers de dépôt.

  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 Define Workflow Builds Using the Default Template ou Utiliser des builds MSBuild héritées à l'aide du modèle de mise à niveau pour plus d'informations sur ces paramètres.

  9. Cliquez sur File d'attente.

    L'Explorateur de builds s'ouvre avec l'onglet En attente affiché. Pour plus d'informations, consultez Gérer et afficher des builds terminées.

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 pour vos modifications avant des archiver, vous pouvez réduire le risque d'erreurs des builds que votre équipe exécute régulièrement (comme 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é parce que le code de génération inclut les modifications d'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 : ms181722.Icon_BldPrivateBuild(fr-fr,VS.100).gif

  • Le nom attribué à la build terminée est nommée respecte le format Build N, N étant 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

Autorisations requises

Pour que vous puissiez effectuer cette procédure, votre autorisation Mettre les builds en file d'attente doit être définie sur 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 Team Explorer, cliquez sur le projet d'équipe approprié.

  2. Dans le menu Générer, cliquez sur Mettre en file d'attente une nouvelle build.

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

  3. Dans la liste Définition de build, sélectionnez une définition de build.

    Si la définition de build sélectionnée comporte une description, celle-ci apparaît dans la liste Définition de build.

  4. 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.

  5. Effectuez l'une des opérations 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 de votre espace de travail dans un jeu de réservations, puis générer ces modifications, cliquez sur Créer.

  6. 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 une build d'archivage contrôlé pour la validation des modifications.

  7. 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).

  8. (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.

  9. Effectuez les étapes suivantes pour spécifier le dossier dans lequel les résultats produits, comme les fichiers binaires, de la génération seront téléchargés (facultatif) :

    Notes

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

    1. Cliquez sur 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.

      Notes

      • 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.

  10. 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 Define Workflow Builds Using the Default Template ou Utiliser des builds MSBuild héritées à l'aide du modèle de mise à niveau pour plus d'informations sur ces paramètres.

  11. Cliquez sur File d'attente.

    L'Explorateur de builds s'ouvre avec l'onglet En attente affiché. Pour plus d'informations, consultez Gérer et afficher des builds terminées.

Voir aussi

Tâches

Créer une définition de build de base

Concepts

Définir une build à l'aide du modèle par défaut

Utilisation de jeux de réservations

Définir une build d'archivage contrôlé pour la validation des modifications