In this post I will show you how you can implement Continuous Delivery for your Dynamics CRM solutions. Using the latest version of Team Foundation Server (TFS), Visual Studio Release Management and xRM CI Framework you will be able to implement one-click automated deployments across all your environments including production. This will enable you provide continuous business value to your stakeholders by releasing small changes more frequently, consistently and reliably. This is very much inline with Agile methodologies of software delivery.
Stage 1: Automate your Builds
Before you can automate your deployment and release processes you need to have an automated consistent way of building your Dynamics CRM components. In terms of deployment your components will be artifacts like CRM Solutions, Configuration Data, CRM Deployment Packages and others. Team Foundation Server provides an excellent Build Automation and Continuous Integration Engine that you can use for this.
Using xRM CI Framework you can easily create automated builds for your Dynamics CRM solutions with a few clicks. Follow the documentation on codeplex to create your build. The build will generate your CRM components and place them in the designated drop location. This can now be picked up by your Release Automation tool which in this case will be Visual Studio Release Management.
Stage 2: Automate your Deployments
Having a consistent build process in place, you can now move into automating the deployment of the components produced above. You will use PowerShell scripts to automate the deployment process. The latest Sdk for Dynamics CRM 2013 comes with PowerShell extensions that allow you deploy CRM Deployment Packages.
The xRM CI Framework comes with two generic PowerShell Scripts. The first one allows you to import CRM Solutions and the second one allows you to deploy a CRM Deployment Package. Depending your scenario you can get started by using either of these scripts and tweak them to your needs. Note the xRM CI Framework also contains many custom PowerShell Cmdlets (Commands) that you can use in your scripts. Check out the documentation on codeplex for more information.
Now you should have some scripts that you can run on to deploy your automated Build outputs.
Stage 3: Automate your Testing
You should be really thinking about this from the start and writing automated tests as requirements come in. The reason I put this at this stage is because as far as Continuous Delivery is concerned you can’t execute your automated tests without having first build and deployed your application to your stage or testing environment. Ideally you want to run Unit Tests during each Check-In and Integration and functional tests in your Continuous Integration and Nightly builds. Finally sanity tests can be run after deployment to your UAT & Production environments.
The xRM Test Framework contains lots of utility classes and productivity tools to allow to easily create Unit and Integration Test for your Dynamics CRM deployments. Check out the detailed documentation and webinars on codeplex. These tests can then be executed during your builds and post your release using Visual Studio Release Management.
Stage 4: Automate your Releases
Once you have your automated builds and deployment scripts ready, you can start thinking about release automation. Release automation allows you to do one click deployments across all your environments. Visual Studio also includes cool features such as security, audit, configuration and environment management and most importantly an easy visual tool to allow you to model your release process using workflows.
In the following post I will show you on how to use Release Management with Dynamics CRM.
Hope you found this post useful.
The xRM Continuous Integration (CI) Framework is a set of tools that makes it easy and quick to automate the builds and deployment of your CRM components.
Implementing continuous integration is always a nice to have feature on Dynamics CRM projects which in most cases gets left for various reasons even though having this setup will save lots of time long term, reduce therisk and improve productivity. Using xRM CI Framework you can quickly implement a build->deploy->test workflow with a few clicks. This is achieved by providing easy to use templates and sample scripts. These can also be easily extend to meet any complex or specific scenarios you might have.
Dynamics CRM 2013 SP1 has been recently released and come with lots of new exiting features and capabilities. This includes an updated SDK. To compliment this release I have updated the xRM CI Framework to take advantage of these new capabilities. Hopefully this will allow you to put in these best practices and automation in place as you start your new Dynamics CRM 2013 projects.
Below is a list of updates from the CRM 2013 version:
- Support for Dynamics CRM 2013 SP1 Online/OnPremise
- Uses the latest Dynamics CRM 2013 SP1 SDK
- Ability to Build and Deploy CRM Deployment Packages
- Integration with Visual Studio Release Management
- More Sample Scripts
- More PowerShell Cmdlets
- New custom Dynamics CRM Build Template for TFS 2013 (see process below)
I have uploaded the source code to codeplex with lots of steps by step instructions to get your started quickly. This will also allow you to extend the framework to meet your needs.
Please post any feedback, comments, issues, discussion on the codeplex site.
Feel free to get in touch if you would like to contribute with ideas, enhancements and new features.
I have also created a download to the new Framework from the Visual Studio Gallery here.
Join me for the next meeting of the CRMUG UK Regional Chapter Meeting on Thursday, July 17th at Microsoft Cardinal Place Victoria, London. The July meeting will focus on using Microsoft Dynamics CRM for managing Customer, Citizen, and other kinds of “Service”. Don’t miss this opportunity to experience what CRMUG has to offer you and fellow Dynamics CRM users in your area!
I will be presenting a session about “One-Click Dynamics CRM Deployments ” at 11:15 AM.
“Find out how you can automate the build and deployment processes for your CRM solutions. The session will demonstrate how the latest tools from the CRM SDK, TFS 2013, Visual Studio Release Management & xRM CI Framework can work together to implement end to end one-click deployments of your enterprise Dynamics CRM Solutions across all your environments. This will allow you to deliver CRM more frequently in a consistent and reliable way.“
Don’t forget to take a look at the full Agenda in here. There will be multiple tracks with a range of topics to suite all roles.
Looking forward to seeing you all in there.
eXtremeCRM is the hub where Microsoft Dynamics CRM partners come together to forge business relationships, gain knowledge from real-world experiences and dive deep into current and future technologies. For Microsoft Dynamics CRM partner organizations, it is the annual conference to attend to nurture best practices, facilitate business growth, and educate each organization member. The highly anticipated conference will be held in Barcelona, Spain, 9 – 12 February, 2014.
Join me on Tuesday 11 Feb at 16:45 in room H3 for my session on “Continuous Delivery – Deliver CRM More Frequently in a Consistent and Reliable Way“. Summary of the session below. You can find all the details in here.
“In this session I will show you what it takes to achieve Continuous Delivery in an enterprise environment through automating the build, deployment and testing of your CRM solutions. I will include a demo of an end to end journey of taking a requirement from definition all the way into production using the latest Automation Tools and best practices (Team Foundation Server 2013, Release Management for Visual Studio, PowerShell & xRM CI Framework for Dynamics CRM 2013). I will discuss suitable implementation options for your target infrastructure to cover on-premise and cloud implementation.
This session will be particularly useful for delivering Dynamics CRM into organizations where there is demand for quick results, quality, efficiency, controlled processes and audit.”
Looking forward to seeing you all in there. Don’t forget to take a look at the full Agenda in here.
One of the new features in the Dynamics CRM 2013 SDK is the ability to execute operations asynchronously. At the moment this feature is limited to only solution imports.
Previously in Dynamics CRM 2011 you were only able to import solutions synchronously. This means that the caller had to wait until the solution import process completes. This resulted in time out errors when importing large or complex solutions. Customers had to increase their time out settings significantly for on-premise deployments. For CRM online, the only option was to catch the exception and do some queries to figure out if the solution import was actually successful or no.
In Dynamics CRM 2013, the “ExecuteAsync” message solves this problem. All we have to do is submit a request to the Dynamics CRM Organization Service using this message. The message would kick off a server side process asynchronously to process the request and return the id of the server side process immediately to the caller. The caller then can query the status of the server side process to figure out if the request was processed correctly.
Take a look at the example below. This method supports both synchronous and asynchronous imports. For asynchronous imports, it can optionally wait for the import job to finish and report on the status.
You can start using this feature immediately by downloading the xRM CI Toolkit. This will provide you with a PowerShell Cmdlet to do exactly the above. See an example on how to use this below. This script invokes the solution import asynchronously and waits until the import completes.
The xRM CI Framework is a set of tools that allows you to quickly and easily implement Continuous Integration for your Dynamics CRM solutions. This includes fully Automated Builds & Deployments.
Dynamics CRM 2013 has been recently released and come with lots of new exiting features and capabilities. These include an updated SDK. To compliment this release I have updated the xRM CI Toolkit to take advantage of these new capabilities. Hopefully this will allow you to put in these best practices and automation in place as you start your new Dynamics CRM 2013 projects.
Below is a list of updates from the CRM 2011 version:
- Support for Dynamics CRM 2013 Online/OnPremise
- Uses the latest Dynamics CRM 2013 SDK
- Compatibility with the new CRM Developer Toolkit for Dynamics CRM 2013
- Asynchronous Solution Imports (Check my other post here)
- Sample PowerShell Scripts
Check my previous post for a list of the CRM 2011 version features that are still supported in this release.
Watch out for more posts regarding the above new features and new releases. This will include compatibility and new features for Visual Studio and Team Foundation Server 2013.
Note that even this release you can use the existing automated build templates with TFS 2013. However at this point in time the CRM Developer Toolkit does not work with Visual Studio 2013.
Finally you can download the new Framework from the Visual Studio Gallery here.
Microsoft provides lots of PowerShell commands “cmdlets” that allow you to manage Windows Servers (IIS, File System, Registry) and applications such as Microsoft Office.
The xRM CI Framework provides you with PowerShell “cmdlets” to allow you to script some of the task that are done manually during the build and/or deployment of Dynamics CRM Solutions.
Using the custom “cmdlets” you are able to assemble a script that can be triggered during your TFS build process or executed on demand from your desktop or other automation tools.
Below is a list of “cmdlets” that are available in the initial release:
|CmdLet Name||Description||SDK Message|
|Import-XrmSolution||Imports a CRM Solution||ImportSolutionRequest|
|Export-XrmSolution||Exports a managed or unmanaged CRM Solution||ExportSolutionRequest|
|Get-XrmSolution||Retrieves CRM Solution details using the unique solution name||Not Applicable|
|Publish-XrmCustomizations||Publishes all customizations for a CRM organization||PublishAllXmlRequest|
|Add-XrmEntity||Create a new entity in CRM||CreateRequest|
|New-XrmEntity||Creates a new instance of the Entity class||Not Applicable|
|Set-XrmEntity||Updates an existing entity in CRM||UpdateRequest|
|Remove-XrmEntity||Deletes an existing entity from CRM||DeleteRequest|
Note that most cmdlets will accept the “ConnectionString” parameter. The format is based on the SDK connection string and the cmdlet will use that parameter to connect to CRM.
To get started follow the setup instructions in my previous post.
To get more information about the parameters each cmdlet provides, run the Get-Help cmdlet as shown below from the PowerShell Console. More information on PowerShell can be found in the PowerShell getting started manual. All the parameters are inline with the Dynamics CRM SDK messages of the corresponding cmdlets as shown in the table above.
The next step is to write your first PowerShell Script. Below is a sample script that checks the version of the currently deployed CRM solution and updates the target system if the version deployed is older than the latest version.
This library contains only a subset of what you can do with Dynamics CRM. You can expose any Dynamics CRM SDK message as a PowerShell cmdlet and use it to automate anything that you could be doing manually today.
Having your builds and deployment automated will allow you to build and deploy quickly and will give you the added consistency and reliability.
In future posts, I will show you how you can implement continuous integration by combining the automated builds discussed in this post and the PowerShell cmdlets for Dynamics CRM.
The xRM CI Framework is a set of tools that allows you to quickly and easily implement Continuous Integration for your Dynamics CRM solutions.
The framework provides an implementation of some of the concepts detailed in the recently published Microsoft Dynamics CRM Application Lifecycle Management (ALM) white paper. The framework is also compatible with the Dynamics CRM Developer toolkit from the SDK.
The framework allows you to improve efficiency and consistency by automating your build and deployments using Team Foundation Server (TFS) 2012 and PowerShell.
Below is the list of features provided in the first release.
- Dynamics CRM TFS Build Template that allows you to easily create your Check-In, Continuous Integration, Nightly and Release Builds
- Dynamics CRM PowerShell Cmdlets to extend your build process and automate your deployments
- Ability to support online & offline Dynamics CRM Builds (Build from CRM instance v.s. from source control)
- Ability to trigger automated deployments from your TFS Builds
- Ability to run Integration Tests from your TFS Builds after deployment
- Automatic versioning of your CRM Solutions inline with your TFS Build number
- Ability to automate the updating of your customisations stored in source control from CRM using the solution packager
- Support for Dynamics CRM on-premise & online
- Support for TFS 2012 on-premise & online
- Easy to use and extensible to meet your specific scenarios
Apart from the benefits above you will also get all the benefits of using Team Foundation Server Build to improve your ALM.
There will be a series of blog articles to show you how you can use the framework to implement your specific scenarios in your projects.
In the meantime you can download a copy of the framework from the visual studio gallery.
Don’t forget to check out the setup post on how to get started.
In this post I will provide you with the details on how to setup the xRM CI Framework.
The process is simple and easy. After this stage you will be ready to create your automated builds and deployments.
Framework Download & Installation:
- The first step is to download the setup files from the visual studio gallery.
- Run the setup which will copy all the required files to the installation directory “C:\Program Files (x86)\Xrm CI Framework”.
Automated Build Template Setup:
- The first step is to copy the contents from the installation directory “C:\Program Files (x86)\Xrm CI Framework\CRM 2011\VS 2012\TFS Build Templates” and store them under source control in TFS.
- Once the files are under source control, you will need configure your Build Controller to use the custom assemblies required by the template.
- Follow this link to perform the two steps above. This is based on TFS online but you can use the same process for TFS on premise.
- The final step is to register the Dynamics CRM 2011 Build templates with TFS. Follow this link to register the template by selecting the template from the location in source control from the previous step.
- Now you should be ready to create your first Build Definition using the Dynamics CRM 2011 template.
Dynamics CRM PowerShell Cmdlets Setup
- Start the PowerShell Console and run the command below.
- Import-Module “C:\Program Files (x86)\Xrm CI Framework\CRM 2011\PowerShell Cmdlets\Xrm.Framework.CI.PowerShell.dll”. This will give you access to all the xRM CI Framework PowerShell Cmdlets.
If you are running this on Windows 7 or 8. You will most probably have PowerShell using .NET 2.0 and encounter some errors. To force PowerShell to use .NET follow this blog.
- Create your PowerShell Script using the Cmdlets
This article demonstrated how to setup the xRM CI Framework. In the next blogs i will show you how to configure different types of builds and deployment to suite your specific scenario.