Merge pull request #106758 from cephalin/issue36547

rewrite Traffic Manager integrate doc

Author: megvanhuygen

.openpublishing.redirection.json

@@ -8472,7 +8472,12 @@
     },
     {
       "source_path": "articles/app-service-web/web-sites-traffic-manager-custom-domain-name.md",
-      "redirect_url": "/azure/app-service/web-sites-traffic-manager-custom-domain-name",
+      "redirect_url": "/azure/app-service/configure-domain-traffic-manager",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/app-service/web-sites-traffic-manager-custom-domain-name.md",
+      "redirect_url": "/azure/app-service/configure-domain-traffic-manager",
       "redirect_document_id": false
     },
     {

articles/app-service-mobile/TOC.yml

@@ -166,7 +166,7 @@
       - name: Map your own custom domain
         href: ../app-service/app-service-web-tutorial-custom-domain.md?toc=%2fazure%2fapp-service-mobile%2ftoc.json
       - name: Custom domains with Traffic Manager
-        href: ../app-service/web-sites-traffic-manager-custom-domain-name.md?toc=%2fazure%2fapp-service-mobile%2ftoc.json
+        href: ../app-service/configure-domain-traffic-manager.md?toc=%2fazure%2fapp-service-mobile%2ftoc.json
     - name: Clone an existing app
       href: ../app-service/app-service-web-app-cloning.md?toc=%2fazure%2fapp-service-mobile%2ftoc.json
     - name: Azure Virtual Network

articles/app-service/configure-domain-traffic-manager.md

@@ -0,0 +1,92 @@
+---
+title: Configure DNS names with Traffic Manager
+description: Learn how to configure a custom domain for an Azure App Service app that integrates with Traffic Manager for load balancing.
+ms.assetid: 0f96c0e7-0901-489b-a95a-e3b66ca0a1c2
+ms.topic: article
+ms.date: 03/05/2020
+ms.custom: seodec18
+
+---
+# Configure a custom domain name in Azure App Service with Traffic Manager integration
+
+[!INCLUDE [web-selector](../../includes/websites-custom-domain-selector.md)]
+
+> [!NOTE]
+> For Cloud Services, see 
+[Configuring a custom domain name for an Azure cloud service](../cloud-services/cloud-services-custom-domain-name.md).
+
+When you use [Azure Traffic Manager](/azure/traffic-manager/) to load balance traffic to [Azure App Service](overview.md), the App Service app can be accessed using **\<traffic-manager-endpoint>.trafficmanager.net**. You can assign a custom domain name, such as www\.contoso.com, with your App Service app in order to provide a more recognizable domain name for your users.
+
+This article shows you how to configure a custom domain name with an App Service app that's integrated with [Traffic Manager](../traffic-manager/traffic-manager-overview.md).
+
+> [!NOTE]
+> Only [CNAME](https://en.wikipedia.org/wiki/CNAME_record) records are supported when you configure a domain name using the Traffic Manager endpoint. Because A records are not supported, a root domain mapping, such as contoso.com is also not supported.
+> 
+
+## Prepare the app
+
+To map a custom DNS name to an app that's integrated with Azure Traffic Manager, the web app's [App Service plan](https://azure.microsoft.com/pricing/details/app-service/) must be in **Standard** tier or higher. In this step, you make sure that the App Service app is in the supported pricing tier.
+
+### Check the pricing tier
+
+In the [Azure portal](https://portal.azure.com), search for and select **App Services**.
+
+On the **App Services** page, select the name of your Azure app.
+
+![Portal navigation to Azure app](./media/app-service-web-tutorial-custom-domain/select-app.png)
+
+In the left navigation of the app page, select **Scale up (App Service plan)**.
+
+![Scale-up menu](./media/app-service-web-tutorial-custom-domain/scale-up-menu.png)
+
+The app's current tier is highlighted by a blue border. Check to make sure that the app is in **Standard** tier or above (any tier in the **Production** or **Isolated** category). If yes, close the **Scale up** page and skip to [Create the CNAME mapping](#create-the-cname-mapping).
+
+![Check pricing tier](./media/app-service-web-tutorial-custom-domain/check-pricing-tier.png)
+
+### Scale up the App Service plan
+
+If you need to scale up your app, select any of the pricing tiers in the **Production** category. For additional options, click **See additional options**.
+
+Click **Apply**.
+
+## Create Traffic Manager endpoint
+
+Following the steps at [Add or Delete Endpoints](../traffic-manager/traffic-manager-endpoints.md), add your App Service app as an endpoint in your Traffic Manager profile.
+
+Once your App Service app is in a supported pricing tier, it shows up in the list of available App Service targets when you add the endpoint. If your app isn't listed, [verify the pricing tier of your app](#prepare-the-app).
+
+## Create the CNAME mapping
+> [!NOTE]
+> To configure an [App Service domain that you purchased](manage-custom-dns-buy-domain.md), skip this section and go to [Enable custom domain](#enable-custom-domain).
+> 
+
+[!INCLUDE [Access DNS records with domain provider](../../includes/app-service-web-access-dns-records-no-h.md)]
+
+While the specifics of each domain provider vary, you map *from* the custom domain name (such as **contoso.com**) *to* the Traffic Manager domain name (**contoso.trafficmanager.net**) that's integrated with your app.
+
+> [!NOTE]
+> If a record is already in use and you need to preemptively bind your apps to it, you can create an additional CNAME record. For example, to preemptively bind **www\.contoso.com** to your app, create a CNAME record from **awverify.www** to **contoso.trafficmanager.net**. You can then add "www\.contoso.com" to your app without the need to change the "www" CNAME record. For more information, see [Migrate an active DNS name to Azure App Service](manage-custom-dns-migrate-domain.md).
+
+Once you have finished adding or modifying DNS records at your domain provider, save the changes.
+
+## Enable custom domain
+After the records for your domain name have propagated, use the browser to verify that your custom domain name resolves to your App Service app.
+
+> [!NOTE]
+> It can take some time for your CNAME to propagate through the DNS system. You can use a service such as <a href="https://www.digwebinterface.com/">https://www.digwebinterface.com/</a> to verify that the CNAME is available.
+> 
+> 
+
+1. Once domain resolution succeeds, to back to your app page in the [Azure Portal](https://portal.azure.com)
+2. From the left navigation, select **Custom domains** > **Add hostname**.
+4. Type the custom domain name that you mapped earlier and select **Validate**.
+5. Make sure that **Hostname record type** is set to **CNAME (www\.example.com or any subdomain)**.
+
+6. Since the App Service app is now integrated with a Traffic Manager endpoint, you should see the Traffic Manager domain name under **CNAME configuration**. Select it and click **Add custom domain**.
+
+    ![Add DNS name to the app](./media/configure-domain-traffic-manager/enable-traffic-manager-domain.png)
+
+## Next steps
+
+> [!div class="nextstepaction"]
+> [Secure a custom DNS name with an SSL binding in Azure App Service](configure-ssl-bindings.md)

articles/app-service/containers/index.yml

@@ -124,7 +124,7 @@ landingContent:
       - linkListType: how-to-guide
         links:
           - text: Load balance with Traffic Manager
-            url: ../web-sites-traffic-manager-custom-domain-name.md?toc=%2fazure%2fapp-service%2fcontainers%2ftoc.json
+            url: ../configure-domain-traffic-manager.md?toc=%2fazure%2fapp-service%2fcontainers%2ftoc.json
           - text: Back up your app to Storage Blobs
             url: ../manage-backup.md?toc=%2fazure%2fapp-service%2fcontainers%2ftoc.json
   - title: More resources

articles/app-service/containers/toc.yml

@@ -128,7 +128,7 @@
     - name: Buy domain
       href: ../manage-custom-dns-buy-domain.md?toc=%2fazure%2fapp-service%2fcontainers%2ftoc.json
     - name: Map domains with Traffic Manager
-      href: ../web-sites-traffic-manager-custom-domain-name.md?toc=%2fazure%2fapp-service%2fcontainers%2ftoc.json
+      href: ../configure-domain-traffic-manager.md?toc=%2fazure%2fapp-service%2fcontainers%2ftoc.json
     - name: Migrate an active domain
       href: ../manage-custom-dns-migrate-domain.md?toc=%2fazure%2fapp-service%2fcontainers%2ftoc.json
   - name: Secure app

articles/app-service/faq-configuration-and-management.md

@@ -101,7 +101,7 @@ A common cause of backup failure is that some files are in use by the applicatio
 
 ## How do I remove a header from the HTTP response?
 
-To remove the headers from the HTTP response, update your site’s web.config file. For more information, see [Remove standard server headers on your Azure websites](https://azure.microsoft.com/blog/removing-standard-server-headers-on-windows-azure-web-sites/).
+To remove the headers from the HTTP response, update your site's web.config file. For more information, see [Remove standard server headers on your Azure websites](https://azure.microsoft.com/blog/removing-standard-server-headers-on-windows-azure-web-sites/).
 
 ## Is App Service compliant with PCI Standard 3.0 and 3.1?
 
@@ -179,7 +179,7 @@ You have two options for capturing an F12 trace:
 ### F12 console output
 
 1. Select the **Console** tab.
-2. For each tab that contains more than zero items, select the tab (**Error**, **Warning**, or **Information**). If the tab isn’t selected, the tab icon is gray or black when you move the cursor away from it.
+2. For each tab that contains more than zero items, select the tab (**Error**, **Warning**, or **Information**). If the tab isn't selected, the tab icon is gray or black when you move the cursor away from it.
 3. Right-click in the message area of the pane, and then select **Copy all**.
 4. Paste the copied text in a file, and then save the file.
 
@@ -208,7 +208,7 @@ For more information, see [How to create an App Service Environment](environment
 Sometimes, creating an App Service Environment fails. In that case, you see the following error in the Activity logs:
 ```
 ResourceID: /subscriptions/{SubscriptionID}/resourceGroups/Default-Networking/providers/Microsoft.Web/hostingEnvironments/{ASEname}
-Error:{"error":{"code":"ResourceDeploymentFailure","message":"The resource provision operation did not complete within the allowed timeout period.”}}
+Error:{"error":{"code":"ResourceDeploymentFailure","message":"The resource provision operation did not complete within the allowed timeout period."}}
 ```
 
 To resolve this, make sure that none of the following conditions are true:
@@ -244,15 +244,15 @@ To perform penetration testing, [submit a request](https://portal.msrc.microsoft
 
 ## How do I configure a custom domain name for an App Service web app that uses Traffic Manager?
 
-To learn how to use a custom domain name with an App Service app that uses Azure Traffic Manager for load balancing, see [Configure a custom domain name for an Azure web app with Traffic Manager](web-sites-traffic-manager-custom-domain-name.md).
+To learn how to use a custom domain name with an App Service app that uses Azure Traffic Manager for load balancing, see [Configure a custom domain name for an Azure web app with Traffic Manager](configure-domain-traffic-manager.md).
 
 ## My App Service certificate is flagged for fraud. How do I resolve this?
 
 [!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
 
 During the domain verification of an App Service certificate purchase, you might see the following message:
 
-“Your certificate has been flagged for possible fraud. The request is currently under review. If the certificate does not become usable within 24 hours, please contact Azure Support.”
+"Your certificate has been flagged for possible fraud. The request is currently under review. If the certificate does not become usable within 24 hours, please contact Azure Support."
 
 As the message indicates, this fraud verification process might take up to 24 hours to complete. During this time, you'll continue to see the message.
 
@@ -278,7 +278,7 @@ For detailed documentation for authentication and authorization in App Service,
 
 ## How do I redirect the default *.azurewebsites.net domain to my Azure web app's custom domain?
 
-When you create a new website by using Web Apps in Azure, a default *sitename*.azurewebsites.net domain is assigned to your site. If you add a custom host name to your site and don’t want users to be able to access your default *.azurewebsites.net domain, you can redirect the default URL. To learn how to redirect all traffic from your website's default domain to your custom domain, see [Redirect the default domain to your custom domain in Azure web apps](https://zainrizvi.io/blog/block-default-azure-websites-domain/).
+When you create a new website by using Web Apps in Azure, a default *sitename*.azurewebsites.net domain is assigned to your site. If you add a custom host name to your site and don't want users to be able to access your default *.azurewebsites.net domain, you can redirect the default URL. To learn how to redirect all traffic from your website's default domain to your custom domain, see [Redirect the default domain to your custom domain in Azure web apps](https://zainrizvi.io/blog/block-default-azure-websites-domain/).
 
 ## How do I determine which version of .NET version is installed in App Service?
 

articles/app-service/index.yml

@@ -120,7 +120,7 @@ landingContent:
           - text: Create hybrid connections to on-prem
             url: app-service-hybrid-connections.md
           - text: Load balance with Traffic Manager
-            url: web-sites-traffic-manager-custom-domain-name.md
+            url: configure-domain-traffic-manager.md
           - text: Back up your app to Storage Blobs
             url: manage-backup.md
 

articles/app-service/media/configure-domain-traffic-manager/enable-traffic-manager-domain.png

@@ -144,7 +144,7 @@
     - name: Buy domain
       href: manage-custom-dns-buy-domain.md
     - name: Map domains with Traffic Manager
-      href: web-sites-traffic-manager-custom-domain-name.md
+      href: configure-domain-traffic-manager.md
     - name: Migrate an active domain
       href: manage-custom-dns-migrate-domain.md
   - name: Secure app