{"id":35837,"date":"2017-09-04T08:01:02","date_gmt":"2017-09-04T08:01:02","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/devops\/?p=35837"},"modified":"2019-02-14T15:51:14","modified_gmt":"2019-02-14T23:51:14","slug":"managing-release-notifications","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/managing-release-notifications\/","title":{"rendered":"Managing Release Notifications"},"content":{"rendered":"<p>When you are configuring continuous deployment pipelines for your team, it becomes essential to keep the team members informed about the progress of releases and the related action items.<\/p>\n<p>We had started <a href=\"https:\/\/blogs.msdn.microsoft.com\/devops\/2017\/05\/27\/personalize-what-notifications-you-receive-for-releases\/\">preview of the release notifications<\/a> feature that integrates the configuration of release related notifications with the default notification settings experience in Visual Studio Team Services (VSTS) a few months back.<\/p>\n<p>Thanks to all for participation in the preview and valuable feedback from the same.<\/p>\n<p>We are now announcing the feature as <strong>generally available <\/strong>on all accounts and be the only available release notification settings experience.\nThe same experience is also available with TFS 2018.<\/p>\n<h2>Default Subscriptions<\/h2>\n<p>Default subscriptions are pre-configured for all accounts and are designed to ensure that relevant users are kept informed about any action item pending on them and all important information related to an action they performed.\nAll teams, groups and users in the account are by default opted-in to these subscriptions.\nAccount administrators can disable a default subscription for the account.<\/p>\n<blockquote><p>https:\/\/[account].visualstudio.com\/_admin\/_notifications?tab=DefaultSubscriptions&amp;view=DefaultSubscriptions<\/p><\/blockquote>\n<p>Additionally, subscribers (users and teams\/groups) can explicitly opt-out of the subscriptions from the custom notification setting pages.<\/p>\n<p>The following default subscriptions are configured for release.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2017\/09\/defaultnotifications-1024x672.png\" alt=\"\" width=\"840\" height=\"551\" class=\"alignnone wp-image-35847 size-large\" \/><\/p>\n<p><strong>Note<\/strong>: The deployment failure notifications are sent out only when the deployment regresses status of the environment i.e. the state changes from Healthy (green) to unhealthy (Red). This happens when a deployment fails or is cancelled and the last deployment on the same environment was successful.<\/p>\n<h2>Custom Subscriptions<\/h2>\n<p>Individual users or teams or VSTS groups can subscribe to additional notifications that are not fulfilled by the default subscriptions.<\/p>\n<p>Manage my\u00a0subscriptions<\/p>\n<blockquote><p>https:\/\/[account].visualstudio.com\/_notifications<\/p><\/blockquote>\n<p>Manage custom subscriptions for teams, groups or users<\/p>\n<blockquote><p>https:\/\/[account].visualstudio.com\/_admin\/_notifications?tab=Subscribers&amp;view=Subscribers<\/p><\/blockquote>\n<p>All users can subscribe for notifications for themselves, while account administrators and team administrators\u00a0can control subscriptions for teams and groups.\nDifferent delivery recipients (including any email address) are supported for custom subscriptions.<\/p>\n<p>Custom subscriptions can be configured for the following templates for release notifications.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2017\/09\/customnotifications.png\" alt=\"\" width=\"1012\" height=\"630\" class=\"alignnone wp-image-35865 size-full\" \/><\/p>\n<p>Learn more about managing\u00a0<a href=\"https:\/\/www.visualstudio.com\/en-us\/docs\/collaborate\/manage-personal-notifications\">personal notification settings<\/a>\u00a0and\u00a0<a href=\"https:\/\/www.visualstudio.com\/en-us\/docs\/collaborate\/manage-team-notifications\">team subscriptions<\/a>.<\/p>\n<h2>FAQs<\/h2>\n<h3>How do I configure a default subscription to be not applicable in my account?<\/h3>\n<p>As an account administrator, visit<\/p>\n<blockquote><p>https:\/\/[account].visualstudio.com\/_admin\/_notifications?tab=DefaultSubscriptions&amp;view=DefaultSubscriptions<\/p><\/blockquote>\n<p>and Disable the relevant subscription.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2017\/09\/disabledefaultsubscription-1024x695.png\" alt=\"\" width=\"840\" height=\"570\" class=\"alignnone size-large wp-image-35885\" \/><\/p>\n<h3>My team uses a group as approver for the deployments. How should I configure notifications such that members of the group do not receive emails when approvals are pending on the group?<\/h3>\n<p>As an account administrator, visit<\/p>\n<blockquote><p>https:\/\/[account].visualstudio.com\/_admin\/_notifications?tab=Subscribers&amp;view=Subscribers<\/p><\/blockquote>\n<p>view subscription settings for the group and Opt-out from \u201c<strong>deployment approval pending<\/strong>\u201d subscription.\nGroup members shall continue to receive notifications when approvals are explicitly assigned to them, or if they have another subscription for the same.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2017\/09\/TeamOptout-1024x716.png\" alt=\"\" width=\"840\" height=\"587\" class=\"alignnone size-large wp-image-35895\" \/><\/p>\n<h3>I received a notification. How do I know what subscription caused it to be delivered to me?<\/h3>\n<p>The footer of the email you receive has a link to view the subscription that caused the notification to be generated for you.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2017\/09\/ViewSubscription.png\" alt=\"\" width=\"702\" height=\"123\" class=\"alignnone size-full wp-image-35896\" \/><\/p>\n<h3>How do I opt out from receiving notifications of a subscription?<\/h3>\n<p>You can opt out from notifications delivered directly to you (not via a group).<\/p>\n<blockquote><p>https:\/\/[account].visualstudio.com\/_notifications<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2017\/09\/IndividualOptout-1024x498.png\" alt=\"\" width=\"840\" height=\"409\" class=\"alignnone size-large wp-image-35886\" \/><\/p><\/blockquote>\n<h3>How do I configure notifications to two different groups on completion of deployment to the two environments in a release definition?<\/h3>\n<p>Create two custom subscriptions, one each for the two subscribers on completion of deployments to the environment they need to be notified on.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2017\/09\/PerEnvironmentSubscription-1024x582.png\" alt=\"\" width=\"840\" height=\"477\" class=\"alignnone size-large wp-image-35905\" \/><\/p>\n<h3>How do I configure a deployment completion notification to be delivered to a partner\u2019s email?<\/h3>\n<p>While configuring a new subscription, choose \u201c<strong>Other email<\/strong>\u201d as the \u201c<strong>deliver to<\/strong>\u201d option and enter the partner\u2019s email in the address field.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>When you are configuring continuous deployment pipelines for your team, it becomes essential to keep the team members informed about the progress of releases and the related action items. We had started preview of the release notifications feature that integrates the configuration of release related notifications with the default notification settings experience in Visual Studio [&hellip;]<\/p>\n","protected":false},"author":200,"featured_media":45953,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[226,1],"tags":[],"class_list":["post-35837","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ci","category-devops"],"acf":[],"blog_post_summary":"<p>When you are configuring continuous deployment pipelines for your team, it becomes essential to keep the team members informed about the progress of releases and the related action items. We had started preview of the release notifications feature that integrates the configuration of release related notifications with the default notification settings experience in Visual Studio [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/35837","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\/200"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=35837"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/35837\/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=35837"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=35837"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=35837"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}