With the TFS 2015.2 update we now have the ability to use Release Manager in TFS on premise. This is how I have setup our branching structure, gated check-in and release manager to control the deployment (with approvals at some stages) of an MVC5 web site with Entity Framework into multiple Azure Web Application environments.
We have our branching structure set as:
Dev\developer name 1
Dev\developer name 2 etc
Developers take a branch from main into the dev folder under their name and work on changes. When development is complete they check-in to their dev branch and then merge the changes into the Main branch. This allows the developer to pull in other changes from main into their dev branch, and be able to check-in at least daily into their dev branch so their code is backed up overnight.
We are using the new TFS build tasks; and setup against the Main branch is:
- A gated check-in.
- And a number of build tasks that compile the code in Release mode, run some unit tests and finally copy the files/build artifacts we need to deploy the web site into the drop folder (essentially a web deploy zip file is created).
The key to creating a web deploy zip file is the MS Build Arguments:
/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true
In the copy and Publish build artifacts task we have:
This automatically builds all changes checked into the Main branch with the final step it produces the web deploy files. Assuming the build passes then Release Manager will take over to deploy the web site into an Azure Web Application.
We have 4 environments in Azure that we need to deploy to ‘UAT Staging’, ‘UAT’, ‘Production Staging’ and ‘Production’. For us these are split into 2 Azure subscriptions, one for UAT one for Production. Within each subscription is 1 web application e.g. UAT and against that 1 slot ‘staging’ and each has its own Azure SQL database. This gives us 2 websites and 2 databases. We make use of sticky slot settings as well so the connection string / app settings stay against its environment because in production we make use of the Azure web application swap slot functionality.
So we configure release manager to deploy the code to UAT staging, UAT and Production staging. But for production release manager just initiates a swap slot PowerShell command.
So in Release manager we will need to setup the deployment process or tasks for each of these environments.
But first Release manager is setup to watch the main branch for a new build artifact which is done by setting the release trigger to Continuous Deployment.
As soon as a new version is checked in setting the UAT Staging environment trigger to ‘Automated after release creation’ will initiate a deployment into that environment automatically (and for us with no approvals required because that is the first server in Azure which our developers can test against).
On the environments tab we define the deployment steps for each environment so for UAT Staging we have:
- Stop the Azure web application
- Deploy the new code/web site
- Start the Azure web application
We are making use of the new TFS Market Place extension ‘Run Inline Azure Powershell’ task which allows us to stop the Azure web application with:
Stop-AzureWebsite -Name $(WebAppName) -Slot stage
And below are the properties of the Azure Web App Deployment task, with the main one being the path to the Web Deploy Package.
Note: Our web applications are always running in Azure we are not creating them on demand.
The UAT and Production Staging environments all have the same 3 tasks. Deployment into an environment takes about 1 minute 20 seconds.
The Production environment has 1 task which swaps Production Staging with Production by executing this powershell script:
Switch-AzureWebsiteSlot -Name $(WebAppName) -Slot1 stage -Slot2 production -Force -Verbose
That allows us to do a quick production deployment (saving us that 1 minute 20).
UAT, Production Staging and Production all have Pre-Deployment approvers setup.
So deployment to the 1st Azure environment ‘UAT Staging’ happens automatically upon a successful check-in to the Main branch.
The developer has the chance now to manually test the site. When they want to deploy to the next environment ‘UAT’ they would open the release in release manager and start the deployment:
By using the ‘Deploy’ button to request the code is deployed into the UAT environment this will send an email to the approvers who will ‘hopefully’ approve the release and if they do release manager will execute the 3 deployment tasks setup for the UAT environment.
The same process would be followed for the remaining environments, the developer tests then uses the deploy button to move the same web application code to the next environment.
At any point we can check what release is in what environment by looking at the overview tab.
Database changes are done via Entity Framework Code First Migrations which are executed upon web site start up by running this code added to the MVC site startup.cs class:
var efConfiguration = new Configuration();
var dbMigrator = new System.Data.Entity.Migrations.DbMigrator(efConfiguration);
This will execute any schema changes and then run the seed data method. The key to keeping the seed data updated is using the extension method ‘AddOrUpdate’.