8.6 KiB

Raw Blame History

title

author

description

ms.author

ms.custom

ms.date

no-loc

uid

Publish an ASP.NET Core app to Azure with Visual Studio

rick-anderson

Learn how to publish an ASP.NET Core app to Azure App Service using Visual Studio.

riande

devx-track-csharp, mvc

07/10/2019

Blazor

Blazor Server

Blazor WebAssembly

Identity

Let's Encrypt

Razor

SignalR

tutorials/publish-to-azure-webapp-using-vs

Publish an ASP.NET Core app to Azure with Visual Studio

By Rick Anderson ::: moniker range=">= aspnetcore-3.0"

[!INCLUDE Azure App Service Preview Notice]

::: moniker-end

See Publish a Web app to Azure App Service using Visual Studio for Mac if you are working on macOS.

To troubleshoot an App Service deployment issue, see xref:test/troubleshoot-azure-iis.

Set up

Open a free Azure account if you don't have one.

Create a web app

In the Visual Studio Start Page, select File > New > Project...

Complete the New Project dialog:

Select ASP.NET Core Web Application.
Select Next.

In the New ASP.NET Core Web Application dialog:

Select Web Application.
Select Change under Authentication.

The Change Authentication dialog appears.

Select Individual User Accounts.
Select OK to return to the New ASP.NET Core Web Application, then select Create.

Visual Studio creates the solution.

Run the app

Press CTRL+F5 to run the project.
Test the Privacy link.

Register a user

Select Register and register a new user. You can use a fictitious email address. When you submit, the page displays the following error:

"A database operation failed while processing the request. Applying existing migrations for Application DB context may resolve this issue."
Select Apply Migrations and, once the page updates, refresh the page.

The app displays the email used to register the new user and a Logout link.

Deploy the app to Azure

Right-click on the project in Solution Explorer and select Publish....

In the Publish dialog:

Select Azure.
Select Next.

In the Publish dialog:

Select Azure App Service (Linux).
Select Next.

In the Publish dialog select Create a new Azure App Service...

The Create App Service dialog appears:

The App Name, Resource Group, and App Service Plan entry fields are populated. You can keep these names or change them.
Select Create.

After creation is completed the dialog is automatically closed and the Publish dialog gets focus again:

The new instance that was just created is automatically selected.
Select Finish.

Next you see the Publish Profile summary page. Visual Studio has detected that this application requires a SQL Server database and it's asking you to configure it. Select Configure.

The Configure dependency dialog appears:

Select Azure SQL Database.
Select Next.

In the Configure Azure SQL database dialog select Create a SQL Database

The Create Azure SQL Database appears:

The Database name, Resource Group, Database server and App Service Plan entry fields are populated. You can keep these values or change them.
Enter the Database administrator username and Database administrator password for the selected Database server (note the account you use must have the necessary permissions to create the new Azure SQL database)
Select Create.

After creation is completed the dialog is automatically closed and the Configure Azure SQL Database dialog gets focus again:

The new instance that was just created is automatically selected.
Select Next.

In the next step of the Configure Azure SQL Database dialog:

Enter the Database connection user name and Database connection password fields. These are the details your application will use to connect to the database at runtime. Best practice is to avoid using the same details as the admin username & password used in the previous step.
Select Finish.

In the Publish Profile summary page select Settings:

On the Settings page of the Publish dialog:

Expand Databases and check Use this connection string at runtime.
Expand Entity Framework Migrations and check Apply this migration on publish.
Select Save. Visual Studio returns to the Publish dialog.

Click Publish. Visual Studio publishes your app to Azure. When the deployment completes, the app is opened in a browser.

Update the app

Edit the Pages/Index.cshtml Razor page and change its contents. For example, you can modify the paragraph to say "Hello ASP.NET Core!":

[!code-htmlIndex]
Select Publish from the Publish Profile summary page again.