Skip to content

tutorial-import-publish-settings-azure.md

Latest commit

 

History

History
91 lines (61 loc) · 5.27 KB

tutorial-import-publish-settings-azure.md

File metadata and controls

91 lines (61 loc) · 5.27 KB
title Publish to Azure by importing publish settings
description Create and import publish settings to deploy ASP.NET and ASP.NET Core web applications from Visual Studio to Azure App Service.
ms.date 03/21/2025
ms.topic tutorial
helpviewer_keywords
deployment, publish settings
author ghogen
ms.author ghogen
ms.subservice deployment
ms.custom sfi-image-nochange

Get publish settings from Azure and import into Visual Studio

You can use the Publish tool to import publish settings and then deploy your app. In this article, we use publish settings for Azure App Service. These steps apply to ASP.NET and ASP.NET Core web apps.

Note

A publish settings file (*.publishsettings) is different than a publishing profile (*.pubxml) created in Visual Studio. A publish settings file is created by Azure App Service, and then it can be imported into Visual Studio.

Note

The technique described in this article (the use of .publishsettings files) is inherently insecure, because this technology uses Basic Authentication, which relies on passwords for authentication, rather than managed identities. For best security, we recommend using managed identities and the Azure services that support them. Visual Studio 17.12 and later are set up to deploy to Azure services that support managed identities. For web applications, use Azure App Service, and for Cloud Services (Extended Support), we recommend Service Fabric managed clusters.

Prerequisites

Create a new ASP.NET project in Visual Studio

  1. On the computer running Visual Studio, create a new project.

    Choose the correct template. In this example, choose either ASP.NET Web Application (.NET Framework) or (for C# only) ASP.NET Core Web Application, and then select OK.

    If you don't see the specified project templates, go to the Open Visual Studio Installer link in the left pane of the New Project dialog box. The Visual Studio Installer launches. Install the ASP.NET and web development workload.

    The project template you choose (ASP.NET or ASP.NET Core) must correspond to the version of ASP.NET installed on the web server.

  2. Choose either MVC (.NET Framework) or Web Application (Model-View-Controller) (for .NET Core or .NET 5 and later), and make sure that No Authentication is selected, and then select OK.

  3. Type a name like MyWebApp and select OK.

    Visual Studio creates the project.

  4. Choose Build > Build Solution to build the project.

Create the publish settings file in Azure App Service

  1. In the Azure portal, open the Azure App Service.

  2. Go to Download publish profile and save the profile locally.

    Screenshot showing how to download the publish profile in Azure App Service.

    In order to deploy with Web Deploy, you need to enable Basic authentication, which is what Web Deploy uses. In Azure App Service, go to Configuration, General settings, SCM Basic Auth Publishing Credentials, and enable Web Deploy. You can't download a publish profile if this setting is not enabled.

    A file with a .publishsettings file extension has been generated in the location where you saved it. The following code shows a partial example of the file (in a more readable formatting).

    <publishData>
  <publishProfile
    profileName="DeployASPDotNetCore - Web Deploy"
    publishMethod="MSDeploy"
    publishUrl="deployaspdotnetcore.scm.azurewebsites.net:443"
    msdeploySite="DeployASPDotNetCore"
    userName="$DeployASPDotNetCore"
    userPWD="abcdefghijklmnopqrstuzwxyz"
    destinationAppUrl="http://deployaspdotnetcore2021.azurewebsites.net"
    hostingProviderForumLink=""
    controlPanelLink="http://windows.azure.com"
    webSystem="WebSites">
    <databases />
  </publishProfile>
</publishData>

    Typically, the preceding .publishsettings file contains two publishing profiles that you can use in Visual Studio, one to deploy using Web Deploy, and one to deploy using FTP. The preceding code shows the Web Deploy profile. Both profiles will be imported later when you import the profile.

Import the publish settings in Visual Studio and deploy

[!INCLUDE import publish settings]

Next steps

In this tutorial, you created a publish settings file, imported it into Visual Studio, and deployed an ASP.NET app to Azure App Service. You may want an overview of publishing options in Visual Studio.

[!div class="nextstepaction"] First look at deployment