{"id":453,"date":"2014-11-11T01:15:00","date_gmt":"2014-11-11T01:15:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/visualstudioalm\/2014\/11\/11\/using-release-management-vso-service-to-manage-releases\/"},"modified":"2022-05-26T04:46:07","modified_gmt":"2022-05-26T12:46:07","slug":"using-release-management-vso-service-to-manage-releases","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/using-release-management-vso-service-to-manage-releases\/","title":{"rendered":"Using Release Management VSO service to manage releases"},"content":{"rendered":"<p>With Release Management for Visual Studio 2013 Update 4 RTM, you can use Visual Studio Online(VSO) service to set up and manage your releases to Azure. This means you can configure Release Management client to connect to Visual Studio Online service instead of Release Management server used for on-premises setup.<\/p>\n<hr style=\"width: 0.25px\" width=\"0\" \/>\n<p><strong>Getting started with Release Management VSO service from Visual Studio IDE<\/strong><\/p>\n<p>If you need to get started quickly with\u00a0Release Management\u00a0service in Visual Studio Online, just download the Release Management Extension from Visual Studio <a href=\"https:\/\/visualstudiogallery.msdn.microsoft.com\/c8a4ef64-66f3-4611-a99c-259f7f65d69a\" target=\"_blank\" rel=\"noopener\">gallery<\/a>. You can create\u00a0release artefacts\u00a0directly from within the Visual Studio IDE using Release Management as a service with a Visual Studio Online account. You must use an Azure subscription to deploy to your Azure VMs with this release definition.<\/p>\n<p><strong>Step 1<\/strong>: Download the Release Management Tool for Visual Studio 2013 from Visual Studio <a href=\"https:\/\/visualstudiogallery.msdn.microsoft.com\/c8a4ef64-66f3-4611-a99c-259f7f65d69a\" target=\"_blank\" rel=\"noopener\">gallery<\/a><\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/6837.01.png\" alt=\"\" border=\"0\" \/><\/p>\n<p><strong>Step 2<\/strong>: Create release artefacts in Visual Studio Online using Build Definition menu<\/p>\n<p>\u00a0<img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/7178.11.png\" alt=\"\" width=\"200\" height=\"174\" border=\"0\" \/><\/p>\n<p>\u00a0<\/p>\n<p><a href=\"http:\/\/www.visualstudio.com\/en-us\/get-started\/deploy-to-azure-vs\" title=\"Learn more about Release to Azure using Release Management Service from Visual Studio IDE\">Learn more about Release to Azure from Visual Studio IDE<\/a><\/p>\n<p>\u00a0<\/p>\n<hr style=\"width: 1px\" width=\"1\" \/>\n<p><strong>This blog describes\u00a0how you can connect Release Management client to\u00a0VSO service to set up and manage releases.<\/strong><\/p>\n<p>Before you start, you&#8217;ll need:<\/p>\n<ul>\n<li><strong>A\u00a0Visual Studio Online account.<\/strong>\u00a0If you don&#8217;t have one,\u00a0\u00a0<a href=\"http:\/\/www.visualstudio.com\/get-started\/sign-up-for-visual-studio-online\">sign up now<\/a>.<\/li>\n<li><strong>A\u00a0team project<\/strong>. If you haven&#8217;t created it,\u00a0<a href=\"http:\/\/vsworking.redmond.corp.microsoft.com\/en-us\/get-started\/dn766171\">find out how<\/a>.<\/li>\n<li><strong>Azure VMs<\/strong>. If you need to create them,\u00a0<a href=\"http:\/\/azure.microsoft.com\/en-us\/documentation\/articles\/virtual-machines-windows-tutorial\/\">here&#8217;s how<\/a>.<\/li>\n<li><strong>An Azure storage account.<\/strong>\u00a0Create one\u00a0<a href=\"http:\/\/azure.microsoft.com\/en-us\/documentation\/articles\/storage-create-storage-account\/\">here<\/a>.<\/li>\n<li><strong>Release Management Update 4 client.<\/strong> Get it <a href=\"http:\/\/go.microsoft.com\/?linkid=9843000\">here<\/a><\/li>\n<li><strong>A deployment script.<\/strong>\u00a0\u00a0Find out how to set up and check-in this\u00a0script\u00a0<a id=\"Content_1005_13\" href=\"http:\/\/go.microsoft.com\/fwlink\/?LinkId=518666\">here<\/a>.\u00a0<\/li>\n<\/ul>\n<p>Here are the steps to set up and manage releases to Azure using Release Management service on Visual Studio Online:<\/p>\n<h2>Configure Release Management client to use Visual Studio Online service<\/h2>\n<p>In order to use Release Management service on Visual Studio Online, you need to connect Release Management client to Visual Studio Online service. Once you download the Release Management client, enter the Visual Studio account URL for which you are <strong>admin<\/strong>, in the <strong>Configure Services<\/strong> window:<\/p>\n<p>\u00a0<img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/7360.RM-Configure20Services.png\" alt=\"\" border=\"0\" \/><\/p>\n<p>\u00a0<\/p>\n<p>This will pop up an authentication browser window where you should enter your Microsoft account credentials corresponding to an <strong>admin<\/strong> account for the Visual Studio account URL.<\/p>\n<p>Once authentication is successful, Release Management client window will appear and you can now set up and manage your releases.<\/p>\n<p><em><strong>Note<\/strong>: The account owner and project collection administrators (at the time of first-connection to Release management features in VSO) will automatically become \u201cRelease Managers\u201d. So if you would like to enable more people having access to Release Management, one of these users has to sign in using the WPF client, and then add the rest of the users as release managers.<\/em><\/p>\n<h2>Set up Stages<\/h2>\n<p>\u00a0<\/p>\n<p>Decide on the number of stages you would like to have in your deployment pipeline. Now go to <strong>Administration<\/strong> tab &#8212;\u00a0<strong>Manage Pick Lists<\/strong> and add the stages:<\/p>\n<p>\u00a0<img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/6201.RM-Add20Stages.png\" alt=\"\" border=\"0\" \/><\/p>\n<p>\u00a0<\/p>\n<p>More details on adding Stages can be found <a href=\"http:\/\/www.visualstudio.com\/get-started\/manage-your-release-vs#AddStages\">here<\/a>.<\/p>\n<h2>Set up Microsoft Azure environments<\/h2>\n<p>In order to release to Azure environments,<\/p>\n<p>1&#46; You should have Azure VMs ready. If you need to create them,\u00a0<a href=\"http:\/\/azure.microsoft.com\/en-us\/documentation\/articles\/virtual-machines-windows-tutorial\/\">here&#8217;s how<\/a>.<\/p>\n<p>2&#46; Import the Azure Environments to Release Management. If you need to import them, <a href=\"http:\/\/www.visualstudio.com\/get-started\/deploy-no-agents-vs#SetupAzure\">here\u2019s how<\/a>.<\/p>\n<p style=\"padding-left: 30px\">\n  <strong>a.<\/strong>\u00a0<a href=\"https:\/\/manage.windowsazure.com\/publishsettings\">Download the settings file<\/a>\u00a0from the Azure portal and open\u00a0it with a text editor, such as Notepad,\u00a0to get your subscription ID and Management Certificate key. (After using the settings file, consider deleting or securing\u00a0it as it contains information that can be used by others to access your Azure account.)\u00a0 Go\u00a0<a href=\"https:\/\/manage.windowsazure.com\/#Workspaces\/StorageExtension\/storage\">here<\/a>\u00a0 to get the name of an existing storage account or add a new storage account using the Azure portal.\n<\/p>\n<p style=\"padding-left: 30px\">\n  <strong>b<\/strong>. Now go to <strong>Administration<\/strong> tab &#8212;\u00a0<strong>Manage Azure<\/strong>. Click on <strong>New vNext: Azure<\/strong>\n<\/p>\n<p style=\"padding-left: 60px\">\n  \u00a0<span class=\"Apple-tab-span\"> <a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/4657.New20Azure20Subscription.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/4657.New20Azure20Subscription.png\" alt=\"\" border=\"0\" \/><\/a><\/span>\n<\/p>\n<p style=\"padding-left: 30px\">\n  <strong>c<\/strong>. Add the subscription by putting in the following details of your Azure subscription as obtained in Step (a)\n<\/p>\n<p style=\"padding-left: 30px\">\n  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <strong>\u00a0i.<\/strong> Subscription Id\n<\/p>\n<p>\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<strong>\u00a0ii.<\/strong> Management Certificate key<\/p>\n<p>\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<strong>iii.<\/strong> Storage Account Name<\/p>\n<p style=\"padding-left: 60px\">\n  <span class=\"Apple-tab-span\"> <a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/0250.RM-Add20Azure20subscription20details.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/0250.RM-Add20Azure20subscription20details.png\" alt=\"\" border=\"0\" \/><\/a><\/span>\n<\/p>\n<p>\u00a0<\/p>\n<p style=\"padding-left: 30px\">\n  <strong>d.<\/strong> Now go to <strong>Configure Paths<\/strong> &#8212; <strong>Environments<\/strong> tab and click <strong>New vNext: Azure<\/strong>. Add the Environments one by one here.\n<\/p>\n<p style=\"padding-left: 30px\">\n  \u00a0<a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/8321.New20Environment20button.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/8321.New20Environment20button.png\" alt=\"\" border=\"0\" \/><\/a>\n<\/p>\n<p style=\"padding-left: 30px\">\n  \u00a0<a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/7532.RM-Add20Azure20Envs.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/7532.RM-Add20Azure20Envs.png\" alt=\"\" border=\"0\" \/><\/a>\n<\/p>\n<p style=\"padding-left: 30px\">\n  <strong>e.<\/strong> For each Environment, you need to add the Servers (Azure VMs that you would have created).\n<\/p>\n<p style=\"padding-left: 30px\">\n  <a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/0081.RM-Link20Servers.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/0081.RM-Link20Servers.png\" alt=\"\" border=\"0\" \/><\/a>\n<\/p>\n<p style=\"padding-left: 30px\">\n  <span class=\"Apple-tab-span\"><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/7750.RM-Link20Servers20-202.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/7750.RM-Link20Servers20-202.png\" alt=\"\" border=\"0\" \/><\/a><\/span>\n<\/p>\n<p style=\"padding-left: 30px\">\n  \u00a0\n<\/p>\n<p>\u00a0<\/p>\n<p>\u00a0You are done now importing the Azure environments to Release Management.<\/p>\n<h2>Create release template and start your release<\/h2>\n<p>To create a Release template and start your release, you need to follow the following steps. Detailed steps are also covered <a href=\"http:\/\/www.visualstudio.com\/get-started\/manage-your-release-vs#CreateReleaseTemplate\">here<\/a>.<\/p>\n<p><strong>1&#46;<\/strong> Create a release path to represent the stages that your release must go through<\/p>\n<p>\u00a0<img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/0537.RM-new20RP.png\" alt=\"\" border=\"0\" \/><\/p>\n<p>\u00a0<\/p>\n<p>Choose the environment and approvers to use for each stage of your release. You can add multiple final approvers for each stage if you want to.<\/p>\n<p>\u00a0<img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/6232.RM-RP20done.png\" alt=\"\" border=\"0\" \/><\/p>\n<p><strong>2&#46;<\/strong> Create required components of your app that you need to deploy separately<\/p>\n<p>Go to <strong>Configure Apps<\/strong> &#8212;\u00a0<strong>Components<\/strong>, click **New vNext **<\/p>\n<p>Select <strong>Builds with application<\/strong>\u00a0and put component path w.r.t. Build drop folder as\u00a0**Path to package. **Here we are putting the whole build as single component, for simplicity.<\/p>\n<p>\u00a0<img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/6355.RM-component-done.png\" alt=\"\" border=\"0\" \/><\/p>\n<p><strong>3&#46;<\/strong> Create a release template and use the release path that you just added<\/p>\n<p style=\"padding-left: 30px\">\n  <strong>a.<\/strong> Go to <strong>Configure Apps<\/strong> &#8212;\u00a0<strong>vNext Release Template<\/strong>. Click <strong>New. <\/strong>Provide the Release Path you created earlier. Select the Build definition by clicking on the <strong>Edit<\/strong> button. If you would like to trigger a new release every time a new build is available, check the box for \u201c<strong>Can Trigger a Release from Build?<\/strong>\u201d\n<\/p>\n<p style=\"padding-left: 30px\">\n  <a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/6232.RM-RT20create.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/6232.RM-RT20create.png\" alt=\"\" border=\"0\" \/><\/a><strong><\/strong>\n<\/p>\n<p>\u00a0<\/p>\n<p style=\"padding-left: 30px\">\n  \u00a0<strong>b.<\/strong> Add the component you created by right click on Component on the left pane and <strong>Add. <\/strong>Add the component you created earlier.\n<\/p>\n<p style=\"padding-left: 30px\">\n  \u00a0<strong>c. <\/strong>Drag and drop the Action \u201cDeploy Using PS\/DSC\u201d to the deployment sequence canvas\n<\/p>\n<p style=\"padding-left: 30px\">\n  \u00a0<a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/8473.RM-Deploy20Using.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/8473.RM-Deploy20Using.png\" alt=\"\" border=\"0\" \/><\/a>\n<\/p>\n<p>\u00a0<\/p>\n<p style=\"padding-left: 30px\">\n  <strong>d.<\/strong> Add the following details to the action.\n<\/p>\n<ul>\n<li>ServerName<\/li>\n<li>UserName<\/li>\n<li>Password<\/li>\n<li>Component Name<\/li>\n<li>Deployment script path (relative to build drop)<\/li>\n<li>Configuration script path, if any.<\/li>\n<li>Put SkipCaCheck as <strong>true<\/strong><\/li>\n<\/ul>\n<p style=\"padding-left: 30px\">\n  \u00a0<a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/6138.DS_.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/6138.DS_.png\" alt=\"\" border=\"0\" \/><\/a>\n<\/p>\n<p style=\"padding-left: 30px\">\n  <strong>e.<\/strong> Copy this deployment sequence and paste it to QA stage. Click <strong>Save &#038; Close.<\/strong>\n<\/p>\n<p style=\"padding-left: 30px\">\n  \u00a0<a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/5807.RM-Copy20DS.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2014\/11\/5807.RM-Copy20DS.png\" alt=\"\" border=\"0\" \/><\/a>\n<\/p>\n<p>\u00a0<\/p>\n<p>The Release Template is now ready. You can trigger a new Release from here (select Release Template and click \u201cNew Release\u201d) or if you have selected \u201c<strong>Can Trigger a Release from Build?<\/strong>\u201d option while creating this Release Template, a new release will be triggered as soon as a new build is available. To test this, go to Visual Studio IDE, <strong>Team Explorer<\/strong> &#8212;\u00a0<strong>Build<\/strong>. Right click on your build definition and select \u201c<strong>Queue New Build<\/strong>\u201d. On completion of a successful build, go to Release Management client \u00e0 <strong>Releases<\/strong> tab and you will see a new Release has been triggered.<\/p>\n<p>\u00a0<\/p>\n<p><strong>Note<\/strong><span style=\"font-size: 12px\"> that with Release Management service on Visual Studio online:<\/span><\/p>\n<ul>\n<li>You can only use <strong>Agent less release pipeline<\/strong>.\u00a0<\/li>\n<li>You can set up <strong>deployments only to Azure environments<\/strong>.\u00a0<\/li>\n<\/ul>\n<h2>Other Release Management Resources<\/h2>\n<ul>\n<li>Try Release Management using\u00a0\u00a0<a href=\"http:\/\/blogs.msdn.com\/b\/briankel\/archive\/2013\/08\/02\/visual-studio-2013-application-lifecycle-management-virtual-machine-and-hands-on-labs-demo-scripts.aspx\">ALM virtual machine<\/a><\/li>\n<li><a href=\"http:\/\/www.visualstudio.com\/get-started\/manage-your-release-vs\">Get started<\/a>\u00a0with Release Management<\/li>\n<li><a href=\"http:\/\/go.microsoft.com\/fwlink\/?LinkId=518790\">Learn<\/a>\u00a0to deploy and test a web application using Release Management<\/li>\n<li><a href=\"http:\/\/go.microsoft.com\/fwlink\/?LinkId=518792\">Customer case studies<\/a><\/li>\n<li><a href=\"http:\/\/blogs.msdn.com\/b\/visualstudioalm\/archive\/2014\/11\/12\/what-s-new-in-release-management-for-vs-2013-update-4.aspx\">What\u2019s new in Release Management for VS 2013 Update 4?<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>With Release Management for Visual Studio 2013 Update 4 RTM, you can use Visual Studio Online(VSO) service to set up and manage your releases to Azure. This means you can configure Release Management client to connect to Visual Studio Online service instead of Release Management server used for on-premises setup. Getting started with Release Management [&hellip;]<\/p>\n","protected":false},"author":139,"featured_media":45953,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[253,226,1],"tags":[],"class_list":["post-453","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-azure-devops-server","category-ci","category-devops"],"acf":[],"blog_post_summary":"<p>With Release Management for Visual Studio 2013 Update 4 RTM, you can use Visual Studio Online(VSO) service to set up and manage your releases to Azure. This means you can configure Release Management client to connect to Visual Studio Online service instead of Release Management server used for on-premises setup. Getting started with Release Management [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/453","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/users\/139"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=453"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/453\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/45953"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=453"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=453"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=453"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}