Guidance and Tooling
Library of guidance and gap-filling solutions.
AAD OAuth2 provider for SonarQube
This plug-in enables Azure Active Directory (AAD) users to automatically be sign up (a login is created if they don’t have one already) and authenticated on a SonarQube server.
Automatically generate breakpoints for all the public entry points in your solution.
Config as Code for DevOps and ALM practitioners
This guidance delivers practical, scenario-based guidance for the use of PowerShell desired state configuration (DSC) to design, develop and deploy custom configuration as code resources. We guide you through the basics and practical walkthroughs, based on a real-world proof-of-concept deployments and experience from the ALM Rangers.
2014.09 v1.BETA | 2014.10 v1 | 2014.12 v1.1
Extracting effective permissions from TFS
This practical guidance and sample code is based on extensive research to address two of the commonly heard requests on Team Foundation Server security:
(1) Report on the effective permissions of a TFS user/group.
(2) Report on security auditing for TFS.
The Extracting effective permissions whitepaper and sample code been released. The Security auditing whitepaper and sample code is available, but will not be released publically as the sample may have performance implications and is not supported by Microsoft. If you need information on the auditing research, please contact the ALM Rangers.
2014.12 v1 | 2015.02 v1.1 | 2015.04 v1.2 | 2015.05 GitHub
Migration of release management assets from RM server to VSTS
Migrate assets from 2015 or 2013 U4 RM server to 2015 TFS server, and start using the Release hub in Team Web Access.
Technical Debt Management / SonarQube (aka.ms/vsartdsq)
SonarQube Installation Guide, which explains how to set up a production ready SonarQube installation to be used in conjunction with Team Foundation Server 2013 to analyse .Net apps.
2015.04.28 v1 | 2015.06 Moved to GitHub
Supporting blog posts:and articles:
– Integrating SonarQube and Reporting Services, by Vinicius Moura
– Manage Technical Debt with SonarQube and TFS, by Cesar Brito and Hosam Kamel
Continuous Testing – A practical guide with concepts and approaches
In the new DevOps Culture, it is becoming increasingly important to react to the customer feedback quickly and ship quality product – quality is the key. One of the best practices to achieve or maintain quality is thru “Test Automation”. There are many benefits of test automation measuring quality, avoid regressions in a timely fashion and in turn help ship a high quality product that can keep happy customers. Automation has to be done in the right way and right time or else it can negatively impact productivity or quality. .
Test Planning and Management Guide
Scenario based and practical guidance for test planning and management of test plans, test cases and shared steps when going to the next sprint, next release and when working with multiple code branches.
2012.2 v1 | 2013.2 v1.1 | 2015.7 v2
TFS Planning, Disaster Avoidance and Recovery, and TFS on Azure Iaas Guide
Practical guidance for the implementation and disaster recovery planning for Team Foundation Server. v1.4 and higher also include practical guidance on TFS on Azure IaaS planning and implementation.
2012.02 v1.0 | 2013.09 v1.3 | 2014.05 v1.4.BETA | 2014.06 v1.4 | 2014.08 v1.4.1
Version Control (ex Branching and Merging) Guide
Practical guidance for branching and merging strategies on Team Foundation Server. Also refer to the Ranger Quick Response Sample Solutions if you have a need to implement a consistent branching model as part of team project or team creation process, which complies with this guidance.
– Branching strategies with TFVC
– Map TFVC actions to Git
– Move Git repositories between team projects
– OMG, I just checked in a huge binary. Now what?
– Alternative Branching Strategies
– Version Control Guidance – Frequently Asked Questions
– Walkthrough (Branching Strategies)
– Part 1 – MAIN Only and Simplicity Rules
– Part 2 – Development Isolation
– Part 3 – Feature Isolation
– Part 4 – Release Isolation … audit alarm
– Part 5 – Servicing & Release Isolation
– Walkthrough (TFVC)
– Part 1 – Create a new local workspace
– Part 2 – Use the local workspace in online mode
– Part 3 – Use the local workspace in offline mode
– Part 4 – Explore the diff and merge tools
– Git for the TFVC User – Workflows
– Part 1: Making Changes
– Part 2: Reviewing Changes (No Conflicts)
– Part 3: Reviewing Changes (With Conflicts)
– Part 4: Converting a TFVC repository
2010.06 v1.0 | 2012.10 v2.0 | 2014.04 v3 | 2015.02 v3.1 | 2015.03 v3.2
Retired Guidance and Tooling
Shared “as is”. No bug fixes, new features or updates planned.
ALM Assessment Guidance
Although the pace of new development technologies, processes and tools present a big challenge to keep up with, software quality has its roots in Application Lifecycle Best Practices, which is usually independent from the latter. Are you consulting or part of an organization which is constantly under release stress? Are you experiencing issues that make you and your developers less productive? You know that there are issues and potential for improvement but you don’t know where to start? Then Rangers ALM Assessment is exactly for you.
2012.08 v1 | Also see DevOps Self Assessment and ALM Catalyst Assessment.
ALM Rangers Personas and Customer Types
Common definition of personas and scenarios used in Visual Studio ALM Rangers guidance.
ALM Rangers DevOps Workbench
DevOps Deployment guidance is based around build once, and deploy to multiple environments. The ALM Rangers introduced the DevOps Workbench sample companion solution and practical guidance in collaboration with the Patterns & Practices book Building a Release Pipeline with TFS , as a great way to start learning the concepts of DevOps & Release Management for TFS 2012 and to kick the tires.
ALM Readiness Treasure Map
Provides a master catalogue (treasure map) of the available ALM Readiness content to guide us through the process of becoming proficient in ALM practices. Get the paper based map and sample source code from CodePlex and the application from the Store. See https://aka.ms/vsartmaptoc for more information.
2013.02 v1.0 | 2013.08 v2.0 | 2013.12 v2.1 | 2014.08 v3.0
BRDLite Reference Templates
The Build Release and Deploy (BRD) Lite is a set of build process reference templates that allows you to quickly setup a real-world build process in your environment. Also see Team Foundation Build Customization Guide and ALM Rangers DevOps for guidance.
2011.05 v1.0 | 2013.02 v2.0
Building a Release Pipeline with Team Foundation Server
Demonstrates how to build a release pipeline with Team Foundation Server. It uses an iterative approach that begins with a flawed pipeline and ends with one that has automation, parallel stages, and monitoring. A collaboration between p&p and the ALM Rangers.
Perfecto Mobile’s unique cloud-based approach to mobile quality enablement, based on real devices and powerful ScriptOnce automation capabilities, complements Microsoft’s vision for and end-to-end mobile ALM. This project contains an overview poster, a practical guidance document, and a hands on lab that will enable understanding of the integration of the Perfecto MobileCloud for TFS and Visual Studio 2012 and Team Foundation Server.
2013.09 v1.0 | 2013.12 v2.0
Lab Management Guide
Practical guidance for VS Lab Management .
2011.06 v1.0 | 2012.08 v2.0 | 2014.02 v3.0 | 2014.02 v3.1
Operations Guidance for Team Foundation Server
You can manage your deployment of Microsoft Visual Studio 2005 Team Foundation Server more effectively if you create your own operations plan. As you create your plan, you should understand key elements of the architecture of Team Foundation Server and how your deployment topology affects operations. This white paper explains those elements in detail, so that you can avoid common problems with your deployment.
Practical Kanban Guide
Offers teams that are new to Kanban and teams that are using a manual, paper-based Kanban board, guidance and tool support for Kanban in Team Foundation Server 2010 and Team Foundation Server 2012.
2012.08 v1.0 | 2013.03 v1.2
NOTE – The kanban board has been added as a feature to TFS 2012 Update 2 which is available for download as a preview. The feature provides all the same functionality that was provided by this CodePlex project, including several additional advantages.
Practical Ruck Guide
The Visual Studio ALM Rangers Ruck process evolved and used by the geographically dispersed and virtual ALM Rangers project teams.
Project Server 2007 VSTS Connector
The Visual Studio Team System Project Server 2007 Connector is designed to integrate the project management capabilities of VSTS with Project Server 2007. It’s been developed by the Visual Studio Team System Rangers in response to significant customer demand for a connector solution.
2007.06 v1.0 | 2007.07 v1.1 | 2008.03 v2.0
The 2008 version was about general requirements management best practices and the best you can do with our current tooling to support these best practices. The 2010 is part 2 of this Ranger guidance focusing on new features of 2010 and how these features deliver better support for our RM best practices.
SharePoint Server Custom Application Development: Document Workflow Management Project
Read about the real-world design, construction, and deployment of a custom SharePoint Server 2007 application to a mid-market enterprise customer using Team Foundation Server as an ALM platform.
SQL Load Test
This tool takes a SQL Profiler trace file and generates a unit test that replays the same sequence of database calls found in the trace file. The unit test is designed to be used in a Visual Studio Load Test. The code generated is easily modifiable so that data variation can be introduced for the purpose of doing performance testing.
Team Foundation Build Guidance
Includes hands-on lab guidance for the customization, deployment of Team Foundation Build.
Also see BRDLite Reference Templates for reference templates.
2011.06 v1.0 | 2012.08 v1.2 | 2012.08 v2.0
TFS 2010 Monitoring Management Pack
The Team Foundation Server 2010 Monitoring Management Pack delivers the capabilities for professional monitoring and management of Team Foundation Server 2010 infrastructure components.
TFS Branch Tool
Implement a consistent branching model as part of team project or team creation process, that complies with the Branching and Merging Guide .
TFS Integration Platform
The TFS Integration Platform is a project that facilitates the development of tools that integrate TFS with other systems. Also see TOC blog.
TFS Process Template Customisation Guide
Practical guidance for Work Item Tracking (WIT) and Process Template customizations.
TFS Teams Tool
Command line utility, such as TFSSecurity .exe , to add Teams and Team members to a Team Project.
TFS Reporting Guide
Focused on providing practical guidance and a reference solution to enable Team Foundation Service users to create a tabular store model and generate reports based on WIT data, and to enable TFS users to create valuable reports using the TFS Data Warehouse, based on real-world scenarios.
NOTE – Trend Charts have been added as a feature to Visual Studio Team Services Update on 21 July 2014 and Microsoft Visual Studio Team Foundation Server 2013 with Update 4. The feature provides all the same functionality that was provided by this CodePlex project, including several additional advantages.
TFS Upgrade Guide
Upgrade scenarios and post-upgrade issues for Team Foundation Server and associated technologies. With the v4 release for TFS 2015, the main-stream guidance has been merged with product documentation and out-of-band, field-experience guidance moved to the Rangers team blog.
– Upgrade your deployment to the latest version of TFS
– New Elements of TFS 2015 that influence an upgrade
– Short Lead Checklist
– Long Lead Preparations
– Long Lead Checklist
– Post Upgrade Checklist
2010.04 v1.14 | 2013.08 v2.3 | 2013.12 v3.0 | 2014.03 v3.1 | 2014.09 v3.3 | 2015.08 v4 | 2015.10 (migrated to team blog and MSDN.com)
TFS Word Add-In
The Team Foundation Server Word Add-in sample allows you to import work items from a Team Foundation Server Team Project and generate professional-looking Word document from TFS Work items.
2012.10 v1.0 | 2013.03 v1.1.13 | 2014.06 v1.2.14 | 2014.12 v1.2.OSS
Understanding TFS migrations from on-premises to VSTS
In these guides we discuss guidance for understanding, planning, and implementing migrations from TFS to Visual Studio Team Services.
– Understanding TFS migrations from on-premises to VSTS– Part 1: Concepts
– Understanding TFS migrations from on-premises to VSTS – Part 2: Walkthrough
2014.12 v1.0 | 2015.02 v1.1
Unit Test Generator
Once you’ve moved to Visual Studio 2012, what’s a dev to do without the Create Unit Tests feature? Based on the high demand on User Voice for this feature to be restored, the Visual Studio ALM Rangers have introduced the Unit Test Generator Visual Studio Extension. The extension adds the “create unit test” feature back, with a focus on automating project creation, adding references and generating stubs, extensibility, and targeting of multiple test frameworks.We envision the following benefits for the Visual Studio community:
– Quickly get to writing test code, not having to worry about setting up projects
– Customize the unit test code generation using a context menu, ensuring that
generated tests better match your naming schemes.
– Generate unit test stubs against multiple frameworks so that you can use
any framework you like.
2013.07 v1.0 | 2013.10 v1.1 | 2013.11 v1.2 | 2014.05 v1.3
Using TFS to Develop Custom SharePoint Products and Technologies Applications
Use Microsoft Visual Studio 2008 Team Foundation Server to support SharePoint application development, and provide an integrated development environment and single source code repository for process activities, integrated progress reporting, and team role.
Visual Studio and TFS VM Factory Guide
Guidance and a reference implementation of a software solution that automates the creation of Microsoft environments, in particular Visual Studio and Team Foundation Server. Transferred to the VmFactory Visual Studio Community project.
2010.06 v1.0 | 2011.06 v2.0 | 2012.08 v3.0
Visual Studio Architecture Tooling Guide
Focuses on modeling tools and includes understanding and reverse engineering an existing application or starting a new application from scratch.
2011.03 v2.1 | 2012.08 v3.0
Visual Studio Coded UI Microsoft Word Add-in
Practical guidance and tooling for the Visual Studio Coded UI Microsoft Word Plug-in, which extends the Coded UI feature support to Microsoft Word documents. 2012.03 v1.0 | 2012.07 v2.0
Visual Studio Database Guide
Practical guidance for Visual Studio 2010 database projects.
Visual Studio Performance Quick Reference Guide
The purpose of this project is to build some insightful and practical guidance around Visual Studio Team Test.
2009.03 v1.0 | 2011.06 v3.6
Visual Studio Test Tooling Guides
A range of test tooling practical and scenario based guidance for:
Microsoft Test Manager (MTM)
2013.03 v1.0 | 2013.08 v1.1 | 2014.01 v1.2
Visual Studio Quick Reference Guide
An overview of Visual Studio and Team Foundation Server in the form of compact, quick reference sheets. Users who are unfamiliar with Visual Studio get a “quick” overview of features, value and associated Rangers guidance.
2010.09 v2.0 | 2012.08 v3.0
WCF Load Test
This tool takes a WCF trace file and a WCF client proxy, or a WCF interface contract, and generates a unit test that replays the same sequence of calls found in the trace file. The code generated is easily modifiable so that data variation can be introduced for the purpose of doing performance testing.
2010.11 v3.0 | 2013.06 v4.0
Library of Visual Studio and Visual Studio Team Services Extensions.
Allows you to visualize your Team Foundation Version Control (TFVC) branches for your current project..
Build Usage NEW
See how many build minutes are being used by users, build definitions, team projects and more.
Counts down to a configurable moment in time.
Simplifies the process of determining ownership of a file.
Create new folders from the code explorer within the Team Web Access.
Print cards from your backlog for use on a physical scrum board.
2015.11 v1, 2016.02 v2
Roll-up Board Widget
Displays an aggregated view of your backlog boards on your dashboards.
Ever needed to have sample data to try things out on? Want to explore what Visual Studio Team Services can do? This extension lets you create and remove sample work item data in your project.
Show area path dependencies extension
Show area path dependencies a team has with other teams.
Test Case Explorer
An extension to explore test cases.
Work Item Visualization
Visualize relationships between work items from within the work item form.
Delivered by the ALM community with collaboration and support from the ALM Rangers. They are not required to meet ALM Rangers quality standards, allowing the community project team to also be creative, agile, and responsive to community needs.
Visual Studio Team Services
Export work item queries and test plans to word direct from the web, without client installs and moving templates files between computers.
Export as PDF
Export build definition as neatly formatted PDF. View all your build defintion details at once instead of navigating between steps or tabs.
A requirements management and integration tool for Visual Studio Team Services.
State visualization of work items
Add the ability to view the state model for a selected work item type.
Scrum report for your daily scrums.
Team Rooms Summary
Shows a summary of the activity in all the team rooms that you are a part of.
VSTS and toggl.com integration.
Send a welcome email to an individual or the entire team.
This is the MyHistory Team Explorer extension originally provided as a sample in the June 2013 MSDN Magazine article – Extending Visual Studio Team Explorer 2012
VS Online news and updates inside Visual Studio.
TFS Community Branch Tool
The TFS Community Branch Tool Visual Studio Extension is based on the ALM Rangers Quick Response Sample ALM Rangers Branch Tool vs extension. The goal is to provide a tool to automate branching task in the ALM Rangers branching guidance.
TFS Team Rooms
Access Team Rooms inside Visual Studio.
Work Item Field History
This package audits a specific field of a work item, showing only the revisions in which its value has changed.
Flight Plan Board
An innovative visualisation project, started by Robert and Gordon as part of the ALM Rangers Community and their continuous visualisation and technology research and collaboration initiative. Store.
TFS 2012 Community Tfs Team Tools
Community TFS Team Tools is a community project based on the example code from ALM Rangers – Quick Response Sample Command line utility to manage TFS Teams Quick Response Sample – Command line utility to manage Team Foundation Server Teams and Users
TFS Work Item Morphing
In Team Foundation Server (TFS) it is not possible to change Process Template on an active project which contains many WorkItems data. To address this specific issue, we have developed an application called TFS Morphing. Purpose of this tool is to perform “In Place Conversion” of data from one format to another.
VmFactory Visual Studio Community
Solution that automates the creation of Microsoft environments, in particular Visual Studio and Team Foundation Server. Transferred from the Visual Studio and TFS VM Factory Guide project.