Merge pull request #7043 from Mikejo5000/mikejo-deploy

Deployment updates

Author: PMEds28

docs/deployment/deploying-applications-services-and-components-resources.md

@@ -1,7 +1,8 @@
 ---
-title: "Deployment overview | Microsoft Docs"
-ms.custom: "seodec18"
-ms.date: 06/22/2018
+title: "Deploy your Visual Studio app to a folder, IIS, Azure, or another destination"
+description: "Learn more about publishing options for your app using the Publish Wizard"
+ms.custom: "contperfq1"
+ms.date: 08/21/2020
 ms.topic: "overview"
 dev_langs:
   - "FSharp"
@@ -15,7 +16,7 @@ ms.workload:
   - "multiple"
 ---
 
-# Overview of deployment in Visual Studio
+# Deploy your app to a folder, IIS, Azure, or another destination
 
 By deploying an application, service, or component, you distribute it for installation on other computers, devices, servers, or in the cloud. You choose the appropriate method in Visual Studio for the type of deployment that you need.
 
@@ -30,19 +31,27 @@ From within Visual Studio, applications can be published directly to the followi
 - [Azure](#azure)
 - [Docker Container Registry](#docker-container-registry)
 - [Folder](#folder)
-- [Custom targets (IIS, FTP)](#Custom targets (IIS, FTP))
-
-On the **Publish** tab, you can select an existing publish profile, import an existing one, or create a new one using the options described here. For a tour of the publishing options in the IDE for different app types, see [First look at deployment](../deployment/deploying-applications-services-and-components.md).
+- [FTP/FTPS server](#ftpftps-server)
+- [Web server(IIS)](#web-server-iis)
+- [Import profile](#import-profile)
 
 ## Azure 
 
+When you choose Azure, you can choose between:
+
+- Azure App Service running on Windows, Linux, or as a Docker image
+- A Docker image deployed to Azure Container Registry
+- An Azure Virtual Machine
+
+![Choose an Azure service](../deployment/media/quickstart-choose-azure-service.png)
+
 ### Azure App Service
 
-[Azure App Service](/azure/app-service/app-service-web-overview) which help developers quickly create scalable web applications and services without maintaining infrastructure. An App Service runs on cloud-hosted virtual machines in Azure, but those virtual machines are managed for you. Each app in an App Service will be assigned a unique \*.azurewebsites.net URL; all pricing tiers other than Free allow assigning custom domain names to the site.
+[Azure App Service](/azure/app-service/app-service-web-overview) helps developers quickly create scalable web applications and services without maintaining infrastructure. An App Service runs on cloud-hosted virtual machines in Azure, but those virtual machines are managed for you. Each app in an App Service will be assigned a unique \*.azurewebsites.net URL; all pricing tiers other than Free allow assigning custom domain names to the site.
 
 You determine how much computing power an App Service has by choosing a [pricing tier or plan](/azure/app-service/azure-web-sites-web-hosting-plans-in-depth-overview) for the containing App Service. You can have multiple Web apps (and other app types) share the same App Service without changing the pricing tier. For example, you can host development, staging, and production Web apps together on the same App Service.
 
-### When to choose Azure App Service
+#### When to choose Azure App Service
 
 - You want to deploy a web application that's accessible through the Internet.
 - You want to automatically scale your web application according to demand without needing to redeploy.
@@ -51,7 +60,18 @@ You determine how much computing power an App Service has by choosing a [pricing
 
 > If you want to use Azure App Service in your own datacenter or other on-premises computers, you can do so using the [Azure Stack](https://azure.microsoft.com/overview/azure-stack/).
 
-For more information on publishing to App Service, see [Quickstart - Publish to Azure App Service](quickstart-deploy-to-azure.md) and [Quickstart - Publish ASP.NET Core to Linux](quickstart-deploy-to-linux.md).
+For more information on publishing to App Service, see:
+- [Quickstart - Publish to Azure App Service](quickstart-deploy-to-azure.md) and [Quickstart - Publish ASP.NET Core to Linux](quickstart-deploy-to-linux.md).
+- [Troubleshoot ASP.NET Core on Azure App Service and IIS](/aspnet/core/test/troubleshoot-azure-iis).
+
+### Azure Container Registry
+
+[Azure Container Registry](/azure/container-registry/) allows you to build, store, and manage Docker container images and artifacts in a private registry for all types of container deployments.
+
+#### When to choose Azure Container Registry
+
+- When you have an existing Docker container development and deployment pipeline.
+- When you want to build Docker container images in Azure.
 
 ### Azure Virtual Machines
 
@@ -61,7 +81,7 @@ Scaling an application that's hosted on virtual machines involves spinning up ad
 
 For additional information, refer to the [detailed comparison](https://azure.microsoft.com/documentation/articles/choose-web-site-cloud-service-vm/) between Azure App Service, Azure Virtual Machines, and other Azure services that you can use as a deployment target using the Custom option in Visual Studio.
 
-### When to choose Azure App Virtual Machines
+#### When to choose Azure Virtual Machines
 
 - You want to deploy a web application that's accessible through the Internet, with full control over the lifetime of assigned IP addresses.
 - You need machine-level customizations on your servers, which includes additional software such as a specialized database system, specific networking configurations, disk partitions, and so forth.
@@ -94,26 +114,61 @@ Note that if for any reason (such as machine access) you are not able to use clo
 
 For more information, see [Quickstart - Deploy to a local folder](quickstart-deploy-to-local-folder.md)
 
-## Custom targets (IIS, FTP)
+## FTP/FTPS server
 
-A custom target lets you deploy your application to a target other than Azure App Service, Azure Virtual Machines, or the local file system. It can deploy to a file system or any other server (Internet or Intranet) to which you have access, including those on other cloud services. It can work with web deploy (files or .ZIP) and FTP.
+An FTP/FTPS server lets you deploy your application to a server other than Azure. It can deploy to a file system or any other server (Internet or Intranet) to which you have access, including those on other cloud services. It can work with web deploy (files or .ZIP) and FTP.
 
-When choosing a custom target, Visual Studio prompts you for a profile name, and then collect additional **Connection** information including the target server or location, a site name, and credentials. You can control the following behaviors on the **Settings** tab:
+When choosing a FTP/FTPS server, Visual Studio prompts you for a profile name, and then collect additional **Connection** information including the target server or location, a site name, and credentials. You can control the following behaviors on the **Settings** tab:
 
 - The configuration you want to deploy.
 - Whether to remove existing files from the destination.
 - Whether to precompile during publishing.
 - Whether to exclude files in the App_Data folder from deployment.
 
-You can create any number of Custom deployment profiles in Visual Studio, making it possible to manage profiles with different settings.
+You can create any number of FTP/FTPS deployment profiles in Visual Studio, making it possible to manage profiles with different settings.
 
-### When to choose custom deployment
+### When to choose FTP/FTPS server deployment
 
 - You're using cloud services on a provider other than Azure that can be accessed through URLs.
 - You want to deploy using credentials other than the ones that you use within Visual Studio, or those tied directly to your Azure accounts.
 - You want to delete files from the target each time you deploy.
 
-For more information, see [Quickstart - Deploy to a web site](quickstart-deploy-to-a-web-site.md)
+## Web Server (IIS)
+
+An IIS web server lets you deploy your application to a web server other than Azure. It can deploy to an IIS server (Internet or Intranet) to which you have access, including those on other cloud services. It can work with Web Deploy or a Web Deploy package.
+
+When choosing an IIS web server, Visual Studio prompts you for a profile name, and then collect additional **Connection** information including the target server or location, a site name, and credentials. You can control the following behaviors on the **Settings** tab:
+
+- The configuration you want to deploy.
+- Whether to remove existing files from the destination.
+- Whether to precompile during publishing.
+- Whether to exclude files in the App_Data folder from deployment.
+
+You can create any number of IIS web server deployment profiles in Visual Studio, making it possible to manage profiles with different settings.
+
+### When to choose web server (IIS) deployment
+
+- You're using IIS to publish a site or service that can be accessed through URLs.
+- You want to deploy using credentials other than the ones that you use within Visual Studio, or those tied directly to your Azure accounts.
+- You want to delete files from the target each time you deploy.
+
+For more information, see [Quickstart - Deploy to a web site](quickstart-deploy-to-a-web-site.md). For help troubleshooting ASP.NET Core on IIS, see [Troubleshoot ASP.NET Core on Azure App Service and IIS](/aspnet/core/test/troubleshoot-azure-iis).
+
+## Import Profile
+
+You can import a profile when publishing to IIS or Azure App Service. You can configure deployment using a *publish settings file* (*\*.publishsettings*). A publish settings file is created by IIS or Azure App Service, or it can be manually created, and then it can be imported into Visual Studio.
+
+Use of a publish settings file can simplify deployment configuration and works better in a team environment versus manually configuring each deployment profile.
+
+### When to choose import profile
+
+- You're publishing to IIS and want to simplify deployment configuration.
+- You're publishing to IIS or Azure App Service and want to speed up deployment configuration for re-use or for team members publishing to the same service.
+
+For more information, see the following:
+
+- [Import publish settings and deploy to IIS](tutorial-import-publish-settings-iis.md)
+- [Import publish settings and deploy to Azure](tutorial-import-publish-settings-azure.md)
 
 ## Next steps
 

docs/deployment/index.yml

@@ -23,10 +23,10 @@ landingContent:
     linkLists:
       - linkListType: overview
         links:
-          - text: Overview of deployment
-            url: deploying-applications-services-and-components-resources.md
           - text: First look at deployment
             url: deploying-applications-services-and-components.md
+          - text: Deploy to a folder, IIS, or Azure
+            url: deploying-applications-services-and-components-resources.md
 
   # Card (optional)
   - title: Get started
@@ -58,18 +58,8 @@ landingContent:
           - text: Package a desktop app for Windows Store
             url: /windows/msix/desktop/desktop-to-uwp-packaging-dot-net
 
-    # Card
-  - title: Deploy .NET packages to NuGet.org
-    linkLists:
-      - linkListType: tutorial
-        links:
-          - text: Publish to NuGet.org (.NET Standard)
-            url: /nuget/quickstart/create-and-publish-a-package-using-visual-studio
-          - text: Publish to NuGet.org (.NET Framework)
-            url: /nuget/quickstart/create-and-publish-a-package-using-visual-studio-net-framework
-
   # Card
-  - title: Deploy ASP.NET apps
+  - title: Deploy ASP.NET Core apps
     linkLists:
       - linkListType: tutorial
         links:
@@ -105,3 +95,13 @@ landingContent:
         links:
           - text: Publish to Linux App Service
             url: ../javascript/publish-nodejs-app-azure.md
+
+  # Card
+  - title: Deploy .NET packages to NuGet.org
+    linkLists:
+      - linkListType: tutorial
+        links:
+          - text: Publish to NuGet.org (.NET Standard)
+            url: /nuget/quickstart/create-and-publish-a-package-using-visual-studio
+          - text: Publish to NuGet.org (.NET Framework)
+            url: /nuget/quickstart/create-and-publish-a-package-using-visual-studio-net-framework

docs/deployment/media/quickstart-choose-azure-service.png

@@ -2,12 +2,12 @@
   href: index.yml
 - name: Overview
   items:
-  - name: Overview of deployment
+  - name: First look at deployment
+    href: deploying-applications-services-and-components.md
+  - name: Deploy to a folder, IIS, or Azure
     href: deploying-applications-services-and-components-resources.md
 - name: Quickstarts
   items:
-  - name: First look at deployment
-    href: deploying-applications-services-and-components.md
   - name: Deploy to Azure App Service
     href: quickstart-deploy-to-azure.md
   - name: Deploy to App Service for Linux