Auteur original, de notre ancien blog : Laurent Jacques
Aujourd’hui nous allons discuter de la customisation des activités de build avec TFS 2015. En effet, alors que dans un prochain billet j’aborderai le tout nouveau système de buildvNext ; il me semblait important de souligner une des (nombreuses) possibilités de customisation du mécanisme existant. Etant donné le volume d’étapes je présenterai la customatisation en 2 parties :
Auteur original, de notre ancien blog : Laurent Jacques
Aujourd’hui nous étudierons un cas pratique d’utilisation avancée de TFS (2012,2013 et 2015) et de ses mécanismes de build.
Nous chercherons à automatiser la création et la suppression des définitions de builds avec l’utilisation de l’API de Team Foundation Server avec Visual Studio 2013.
Pour le cas d’étude de ce billet, l’organisation du code source se présente ainsi :
une branche dev : le travail courant des développeurs, tous check-in leurs modificationdedans au jour le jour.
plusieurs branches uat : en fin de cycle de développement, une nouvelle branche uat_X.Y.Z est créée à partir du dev pour partir en validation (test d’intégration)
une branche master : une fois validée la branche uat_X.Y.Z devient la nouvelle branche master : version référence pour les développements.
Ce qui donne par exemple l’arborescence suivante :
L’équipe de développement a mis au point deux définitions de build basées sur la branche DEV :
une intégration continue, tournant les tests unitaires automatiques, générant la doc, fournissant les livrables dans un répertoire dépôt;
une nightly : déployant les applications sur l’environnement de test tous les jours à 23h.
Problématique
Une fois validée en interne, le DEV est branché en UAT_X.Y.Z : les définitions de builds ne fonctionnent donc pas sur cette branche.
Actuellement : pour chaque nouvelle branche UAT le lead technique vient créer une nouvelle définition de build UAT et ajouter les différents paramètres.
Besoin
Automatiser le processus.
Mise en oeuvre
Pour cette première version nous visons la mise en place d’une app console en c# qui ira, à intervalles réguliers, vérifier l’état des branches et gérer les définitions de builds.[…]
Avant toute chose: ajouter les références (v12) dans le projet :
1ière étape: récupérer la listes des branches UAT existantes.:
[code language= »csharp »]
List<Branch> branchList = new List<Branch>();
using (var tfs = new TfsTeamProjectCollection(_TFSserver))
{
VersionControlServer vcs = (VersionControlServer)tfs.GetService(typeof(VersionControlServer));
var items = vcs.GetItems(sourceCodeArea, VersionSpec.Latest, RecursionType.OneLevel,
DeletedState.NonDeleted, ItemType.Folder).Items;
foreach (Item item in items)
{
// skip self
if (!item.ServerItem.Equals(sourceCodeArea))
{
if (item.ServerItem.ToLower().Contains(filter.ToLower()))
branchList.Add(new Branch(item.ServerItem, item.CheckinDate, project));
}
}
}
[/code]
Dans le code présent la logique est la suivante:
on fournit comme paramètres :
l’url d’accès au serveur TFS ,
la zone de départ dans le source (sourceCodeArea) ,
un fitre est indiqué qui va permettre de ne ressortir que les branches qui nous intéressent (filter)
3. pour chacun de ses folders, on vérifie la cohérence du nom par rapport au filtre précisé :
[code language= »csharp » light= »true »]
if (item.ServerItem.ToLower().Contains(filter.ToLower()))
[/code]
4. une fois récupérées, les branches seront ajoutées dans une liste d’objets maisons pour être gérées plus tard.
2ième étape: récupérer les définitions de build existantes:
[code language= »csharp »]
var tfs = new TfsTeamProjectCollection(_TFSserver);
tfs.Authenticate();
var buildServer = (IBuildServer)tfs.GetService(typeof(IBuildServer));
var buildDefinitionList = new List<IBuildDefinition>(buildServer.QueryBuildDefinitions(TEAM_PROJECT));
[/code]
Afin de déterminer si les builds n’existent pas déjà, il faut en premier lieu récupérer la liste des builds existantes.
Les instructions ci-dessus permettent d’interroger le serveur TFS pour cela.
Ici, le TEAM_PROJECT est simplement une constante représentant le nom du projet d’équipe.
L’appel à buildServer.QueryBuildDefinitions va fournir l’ensemble des builds existantes pour le projet.
3ème étape: parcourir la liste des branches et créer les builds inexistantes:
[code language= »csharp »]
if (!buildDefinitionList.Exists(x => x.Name == TfsBuildServices.BuildName(projectName, branch)))
{
IBuildDefinition CIBuild = buildDefinitionList.Where(x => x.Name == projectName + "_CI").First();
if (CIBuild != null)
{
var newbuild = buildServer.CreateBuildDefinition(TEAM_PROJECT);
newbuild.CopyFrom(CIBuild);
newbuild.Name = TfsBuildServices.BuildName(projectName, branch);
BuildSettings settings = new BuildSettings();
var process = WorkflowHelpers.DeserializeProcessParameters(newbuild.ProcessParameters);
settings.ProjectsToBuild = new StringList(((BuildSettings)process["BuildSettings"]).ProjectsToBuild.ToString().Replace("DEV",branch));
process.Remove("BuildSettings");
process.Remove("ProjectsToBuild");
process.Add("BuildSettings", settings);
process.Add("ProjectsToBuild", new string[] { settings.ProjectsToBuild.ToString() });
newbuild.ProcessParameters = WorkflowHelpers.SerializeProcessParameters(process);
newbuild.DefaultDropLocation += @"" + projectName;
newbuild.Workspace.Mappings[0].ServerItem = newbuild.Workspace.Mappings[0].ServerItem.Replace("DEV", branch);
newbuild.Save();
}
}
[/code]
1. une simple requête linq sur le nom de la build permet de passer la création si la build existe déjà
La build definition utilise des BuildSettings pour enregistrer ses paramètres :
[code language= »csharp »]
BuildSettings settings = new BuildSettings();
var process = WorkflowHelpers.DeserializeProcessParameters(newbuild.ProcessParameters);
settings.ProjectsToBuild = new StringList(((BuildSettings)process["BuildSettings"]).ProjectsToBuild.ToString().Replace("DEV",branch));
process.Remove("BuildSettings");
process.Remove("ProjectsToBuild");
process.Add("BuildSettings", settings);
process.Add("ProjectsToBuild", new string[] { settings.ProjectsToBuild.ToString() });
newbuild.ProcessParameters = WorkflowHelpers.SerializeProcessParameters(process);
newbuild.DefaultDropLocation += @"" + projectName;
newbuild.Workspace.Mappings[0].ServerItem = newbuild.Workspace.Mappings[0].ServerItem.Replace("DEV", branch);
[/code]
Ces settings sont sérialisés sous forme de dictionnaires et doivent donc être réédités pour cadrer avec le besoin spécifique UAT:
la copie de la build CI pointe par exemple vers la solution à compiler $/Project/dev/Appli1/Appli1.sln . il faut donc modifier ce répertoire pour celui UAT :
et enfin le modèle objet de la définition de build contient aussi le mapping vers le répertoire source controle mappé qui doit lui aussi être remplacé :
A noter: pour pouvoir supprimer une définition de builds il faut que les historiques de run soient eux-aussi supprimés, c’est pourquoi l’appel buildServer.DeleteBuilds(UAT_CIBuild.QueryBuilds()); est fait ainsi : cela supprime l’ensemble.
5ième étape: emballer dans une petite application :
Je ne rentrerai pas dans les détails sur ce point, mais avec les éléments fournis rien de plus simple que de réunir tout cela dans une application qui tourne à intervalle régulier et exécute ces appels afin de synchroniser les définitions de builds et les branches.
Dans le prochain billet j’expliquerai comment se passer de l’application console en intégrant ce code au sein d’activités de build maisons et comment créer notre propre template de build avec tout ceci.
Récemment, lors du développement d’un site ASP.NET MVC 5 interrogeant une Web API 2.2 OData, nous avons constaté que nos processeurs tournaient à 100% lorsque nous exécutions le site en local. Le problème ne se posait pas en debug, ni sur les plateformes d’intégration mais uniquement sur des sites IIS locaux.
Il s’avère que « arterySignalR » n’est autre que l’appel à Browser Link. C’est une fonctionnalité de Visual Studio 2013 permettant d’établir une connexion temps-réelle avec l’ensemble des navigateurs exécutant une application actuellement ouverte dans VS. Toutes les interactions que vous faites dans votre code peuvent être répercutées via Visual Studio sur tous les navigateurs ouverts sur l’application en question. Cela vous permet aussi de rafraîchir automatiquement vos feuilles de styles par exemple, sans avoir à faire un F5 sur votre navigateur.
Il s’avère que dans notre cas, l’appel à notre Web API derrière le site MVC plombait les perfs. Il a été plus judicieux de le désactiver en attendant de trouver une solution de contournement.
Si vous désirez faire de même, il vous suffit dans Visual Studio de cliquer sur le bouton de rafraîchissement à côté du bouton de Debug en navigateur, puis de décocher « Activer le lien de navigateur » :
Voilà !
En espérant que ça puisse vous aider autant que nous.
En
attendant la nouvelle version de Visual Studio (Visual Studio 14), Microsoft vient de publier
la RC (« Release Candidate ») de Visual Studio 2013 Update 4 ainsi que de Team
Foundation Server 2013 Update 4.
Concrètement,
beaucoup d’améliorations ont été faites notamment sur la prise en charge du
cycle de développement ou encore sur l’éditeur de code JavaScript. Vous noterez également que VS 2013.4 intègre des améliorations
concernant les outils de suivi et de gestion des projets agiles.
Pour
plus de détails sur les nouvelles fonctionnalités, je vous
invite à consulter les articles suivants :
Lorsque l’on parle de sprint, on fait souvent référence à un numéro pour les identifier. On commence avec le sprint zéro pour aller vers des sprints où la vélocité devient de plus en plus précise. En maintenance logicielle, le développement d’une application peut s’étaler sur plusieurs années et comprendre de multiples versions. Dans ce contexte, donner un nom de version à chaque itération du cycle de développement présente certains avantages. Lire la suite →
Microsoft vient de reconnaitre, de fait, la pertinence de Scrum (la méthode de gestion de projet que nous avons adoptée pour nos forfaits) en l’intégrant dans Visual Studio Team System. Une autre manière de dire que la fond prévaut sur la forme (ou, ici, la méthode sur l’outil).
A noter toutefois que eScrum n’est pas terriblement simple a installer et configurer et que la plus value de l’outil est ici assez discutable. Mais il parait que Microsoft a pris bonne note des remarques des premiers utilisateurs et travaille a un sp1.