Déclencher une version à partir d'une build

Démarrez une version automatiquement quand vous générez votre application à l'aide de Team Foundation Build. Vous pouvez choisir la phase de votre processus de lancement par laquelle commencer. Pour déclencher une version à partir d'une build, vous devez configurer votre processus de génération et votre chemin d'accès à la version finale.

Si vous n'avez pas encore créé votre chemin d'accès de la version finale, cliquez sur le lien ici pour ce faire.

Également, si vous n'avez pas encore configuré votre système de génération, faites-le maintenant.

Configurer votre processus de génération

1. Si vous n'êtes pas autorisé à modifier des définitions de build, téléchargez-les maintenant.

2. À partir de Visual Studio, Team Explorer, connectez-vous au projet d'équipe que vous souhaitez utiliser (clavier : Ctrl + 0, C).

3. Sur la page Builds (clavier : Ctrl + 0, B), créez ou modifiez une définition de build.

4. Sous l'onglet Processus de la définition de build, choisissez la configuration que vous souhaitez utiliser pour cette version (par exemple : Debug ou Release). Affectez à Version Release la valeur True. Choisissez la phase spécifique à déclencher pour la version Release ou laissez ce champ vide si vous souhaitez démarrer par la première étape.

   

   Si la section Version finale section n'apparaît pas :

   • Q : J'utilise le modèle par défaut. Quel modèle de processus de génération dois-je utiliser pour Release Management et comment l'ajouter à TFS ?

   • Q : J'utilise le modèle de mise à niveau. Quel modèle de processus de génération dois-je utiliser pour Release Management ?

   • Q : J'utilise un modèle de processus de génération personnalisé. Comment l'ajouter la logique de workflow pour déclencher une version ?

   Si vous avez des composants avec des fichiers de configuration nécessitant des valeurs différentes en fonction de l'environnement cible, vous pouvez tokeniser le fichier de configuration.

5. Spécifiez les autres paramètres que requiert votre processus de génération, puis enregistrez votre définition de build.

Configurer votre modèle de version

1. Si vous n'avez pas installé Release Management Client pour Visual Studio 2013 sur le serveur de builds, faites-le maintenant. Configurez Release Management Client pour qu'il se connecte à Release Management Server.

   Après avoir installé le client sur le serveur de builds, redémarrez les services de build. Vous pouvez le faire à partir de la Console Administration Team Foundation Server.

2. À partir de votre modèle de version, sélectionnez la définition de build que vous avez définie pour déclencher une build, puis cochez la case pour permettre au processus de génération de déclencher une version.

   

   Si la sélection Définition de build ne s'affiche pas, vous devez ajouter votre connexion TFS à Release Management Client. (Ajoutez la connexion à partir de l'onglet Gérer TFS de la section Administration.)

   Après que la version est déclenchée, elle parcoure les étapes de la phase qui a été sélectionnée. Si vous ne définissez pas les options Étape d'acceptation et Étape de déploiement sur Automatique pour cette phase, la version ne sera pas démarrée. Vous devez marquer ces étapes comme automatique dans le chemin d'accès de la version.

Q et R

Q : J'utilise le modèle par défaut.Quel modèle de processus de génération dois-je utiliser pour Release Management et comment l'ajouter à TFS ?

R : Si vous utilisez le modèle par défaut, vous devez simplement le remplacer par le modèle de processus de gestion des versions correspondant.

1. Si vous n'avez pas l'autorisation de contribuer à des fichiers ou de modifier des définitions de build, obtenez-la maintenant.

2. À partir de Visual Studio, Team Explorer, connectez-vous au projet d'équipe que vous souhaitez utiliser (clavier : Ctrl + 0, C).

3. Dans le dossier Drive:\Program Files (x86)\ Microsoft Visual Studio 12.0\ReleaseManagement\bin, recherchez le modèle dont vous avez besoin. Ou téléchargez le modèle dans ce répertoire à partir du fichier zip qui est attaché à ce billet de blog.

   • TFS 2013

     • TFVC : ReleaseTfvcTemplate.12.xaml.

     • Git : ReleaseGitTemplate.12.xaml

   • TFS 2012 : ReleaseDefaultTemplate.11.1.xaml

   • TFS 2010 : ReleaseDefaultTemplate.xaml

4. Ajoutez le modèle dans le contrôle de version. Il est conseillé de placer le modèle dans le dossier BuildProcessTemplates de votre projet d'équipe.

   • TFVC : Ajouter des fichiers au serveur

   • Git : Gérer les fichiers sur votre ordinateur de développement

5. À partir de la page Builds (clavier : Ctrl + 0, B), créez ou modifiez une définition de build.

6. À partir de l'onglet Processus, choisissez Nouveau pour sélectionner le modèle à utiliser pour votre fichier de processus de génération. (Vous devez pouvoir naviguer pour sélectionner le modèle que vous venez d'ajouter.)

Q : J'utilise un modèle de processus de génération personnalisé.Comment l'ajouter la logique de workflow pour déclencher une version ?

R : Ajoutez des sections à votre modèle de processus de génération personnalisée pour fournir la logique de workflow. Téléchargez le fichier des extraits avec ces sections ici. Utilisez les extraits pour ajouter ces arguments à votre modèle de processus de génération : ConfigurationsToRelease, ReleaseBuild, ReleaseTargetStage, DropBuild.

Enregistrez le modèle de processus de génération. Si vous utilisez le contrôle de version Team Foundation, archivez-le. Si vous utilisez Git, validez et envoyez le modèle de processus de génération.

Q : J'utilise le modèle de mise à niveau.Quel modèle de processus de génération dois-je utiliser pour Release Management ?

R: Découvrez ce que vous devez faire ici.

Q : Puis-je déployer les composants de mon application sur des ordinateurs différents ?

R : Oui, créez des composants via Release Management Client et ajoutez-les à votre modèle de génération.

Vous pouvez ensuite ajouter ces composants à votre build.

Lorsque la fenêtre Composants s'affiche, double-cliquez sur le composant que vous souhaitez ajouter.

Chaque composant que vous ajoutez doit être configuré en tant que Builds avec application ou Builds externes.

Un ' \' dans le champ Emplacement cible de build indique que la build se trouve à la racine du dossier cible.

Q : Quels outils puis-je utiliser pour déployer un composant ?

R : Pour chaque composant que vous définissez, vous pouvez sélectionner l'outil à utiliser à partir de l'onglet Déploiement. Pour en savoir plus sur les paramètres d'autorisation, cliquez ici.

Remplacez les Arguments par des informations spécifiques au déploiement de ce composant.

Pour utiliser un outil personnalisé, ajoutez d'abord l'outil par le biais de la page Stock, puis sélectionnez-le dans l'onglet Déploiement.

Assurez-vous que les fichiers référencés par votre commande seront disponibles à l'emplacement de votre package au moment du déploiement.

Q: Pourquoi ma version n'a-t-elle pas démarré ?

Voici quelques problèmes possibles :

• Si vous configurez votre build pour déclencher une version (Version de Build = True), mais que vous n'activez pas la case à cocher Peut déclencher une version à partir d'une build ? pour votre modèle de version, cela entraîne en fait l'échec de la build et, par conséquent, la version n'est pas démarrée non plus.

• Si vous configurez votre modèle de version pour utiliser une définition de build qui n'est pas configurée pour déclencher une version (Version Release = False) ou qui ne contient pas la logique de version appropriée.

• Si un modèle de version contient un composant qui est configuré pour générer une build de manière indépendante.

• Si vous ne définissez pas les options Étape d'acceptation et Étape de déploiement sur Automatique pour la phase que vous avez sélectionnée pour le déclenchement à partir de la version, la version ne démarrera pas. Vous devez définir ces étapes pour qu'elles soient automatiques pour ce chemin d'accès à la version finale.

• Si vous n'avez pas installé Release Management Client sur l'ordinateur qui exécute votre serveur Team Foundation Build.

• Si le temps nécessaire pour l'exécution d'un déploiement est supérieur à 10 minutes. Vous pouvez modifier la valeur assignée au Délai d'attente du déploiement déclenché par TFS à partir de l'onglet Administration, page Paramètres.

Q : Comment puis-je gérer des fichiers de configuration qui nécessitent des valeurs différentes en fonction de l'environnement cible ?

R : Utilisez des fichiers de configuration tokenisés.

Pour chaque fichier de configuration de votre solution qui requiert des valeurs différentes dans des environnements différents, créez une version tokenisée de ce fichier.

Par exemple, si votre solution contient un fichier nommé web.config, effectuez une copie de ce fichier et étiquetez-la web.config.token. Votre fichier web.config ne change pas et est utilisé lorsque vous exécutez l'application localement. Le fichier web.config.token contient des jetons au lieu des valeurs réelles.

Par exemple, si votre fichier web.config contient la ligne :

<add key="SMTPHostServer" value="mysmtp.myserver.domain"/>

alors votre fichier web.config.token contiendra la ligne suivante, où SMTPHostServer est le jeton :

<add key="SMTPHostServer" value="SMTPHostServer"/>

Assurez la synchronisation entre vos fichiers locaux et les fichiers tokenisés.

Q : Comment définir quels fichiers doivent être analysés pour remplacer les jetons par des variables ?

R : Pour chaque composant que vous définissez, vous pouvez spécifier le filtre d'extension de fichier dans l'onglet Variables de Configuration.

L'agent de déploiement que vous avez spécifié pour le composant utilise les critères spéciaux pour analyser l'ensemble des fichiers qui ont besoin que les jetons soient remplacés par des variables. Séparez deux ou plusieurs extensions de fichier à l'aide d'un point-virgule (;).