Skip to content

quickstart-custom-container-windows-visual-studio-pivot.md

Latest commit

 

History

History
190 lines (113 loc) · 11.2 KB

quickstart-custom-container-windows-visual-studio-pivot.md

File metadata and controls

190 lines (113 loc) · 11.2 KB
author cephalin
ms.service azure-app-service
ms.devlang java
ms.topic quickstart
ms.date 02/14/2025
ms.author cephalin

In this quickstart, you learn how to deploy an ASP.NET app in a Windows image to Azure Container Registry from Visual Studio. You run the app in a custom container in Azure App Service.

Azure App Service provides predefined application stacks on Windows that run on Internet Information Services (IIS). These preconfigured application stacks lock down the operating system and prevent low-level access.

Custom Windows containers don't have these restrictions. Developers can use custom containers to give containerized applications full access to Windows functionality.

Prerequisites

If you already installed Visual Studio 2022:

  • Install the latest updates in Visual Studio by selecting Help > Check for Updates.
  • Add the workloads in Visual Studio by selecting Tools > Get Tools and Features.

Create an ASP.NET web app

  1. Open Visual Studio and then select Create a new project.

  2. In Create a new project, select ASP.NET Web Application (.NET Framework) for C#, and then select Next.

    :::image type="content" source="../../media/quickstart-custom-container/create-new-project.png" alt-text="Screenshot that shows the Create a new project dialog.":::

  3. In Configure your new project > Project name, name the application myfirstazurewebapp. Under Framework, select .NET Framework 4.8, and then select Create.

    :::image type="content" source="../../media/quickstart-custom-container/configure-web-app-project-container.png" alt-text="Screenshot that shows Configure your web app project.":::

  4. You can deploy any type of ASP.NET web app to Azure. For this quickstart, select the MVC template.

  5. Under Authentication, select None. Under Advanced, select Container support and clear Configure for HTTPS. Select Create.

    :::image type="content" source="../../media/quickstart-custom-container/select-mvc-template-for-container.png" alt-text="Screenshot that shows the create ASP.NET Web Application dialog.":::

  6. If the Dockerfile doesn't automatically open, open it by selecting Solution Explorer.

  7. You need a supported parent image. Change the parent image by replacing the FROM line with the following code, and then save the file:

    FROM mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-ltsc2019

  8. From the Visual Studio menu, select Debug > Start Without Debugging to run the web app locally.

    :::image type="content" source="../../media/quickstart-custom-container/local-web-app.png" alt-text="Screenshot that shows the app running locally.":::

Publish to Azure Container Registry

  1. In Solution Explorer, right-click the myfirstazurewebapp project, and then select Publish.

  2. In Target, select Docker Container Registry, and then select Next.

    :::image type="content" source="../../media/quickstart-custom-container/select-docker-container-registry-visual-studio-2022.png" alt-text="Screenshot that shows the Select Docker Container Registry screen.":::

  3. In Specific Target, select Azure Container Registry, and then select Next.

    :::image type="content" source="../../media/quickstart-custom-container/publish-to-azure-container-registry-visual-studio-2022.png" alt-text="Screenshot that shows the Publish from project overview pane.":::

  4. In Publish, select the correct subscription. To create a new container registry, select Create new in Container registries.

    :::image type="content" source="../../media/quickstart-custom-container/create-new-azure-container-registry.png" alt-text="Screenshot that shows the Create new Azure Container Registry screen.":::

  5. In Create new, select the correct subscription. Under Resource group, select New and type myResourceGroup for the name. Then, select OK. Under SKU, select Basic. Under Registry location, select a location for the registry, and then select Create.

    :::image type="content" source="../../media/quickstart-custom-container/new-azure-container-registry-details.png" alt-text="Screenshot that shows Azure Container Registry details.":::

  6. In Publish, under Container Registry, select the registry that you created, and then select Finish.

    :::image type="content" source="../../media/quickstart-custom-container/select-existing-azure-container-registry.png" alt-text="Screenshot that shows the Select existing Azure Container Registry screen.":::

    Wait for deployment to finish. The Publish pane now shows the repository name. Select the Copy button to copy the Repository name for later.

    :::image type="content" source="../../media/quickstart-custom-container/published-docker-repository-visual-studio-2022.png" alt-text="Screenshot that highlights the repository name.":::

Create a Windows custom container

  1. Sign in to the Azure portal.

  2. Select Create a resource in the upper-left corner of the Azure portal.

  3. Under Popular services, select Create under Web App.

  4. In Create Web App, select your subscription and resource group. You can create a new resource group if needed.

  5. Provide an app name, such as win-container-demo. For Publish, select Container. For Operating System, select Windows.

    :::image type="content" source="../../media/quickstart-custom-container/create-web-app-container.png" alt-text="Screenshot that shows how to create a web app for containers.":::

  6. Select Next: Database > Next: Container.

  7. For Image Source, select Docker Hub. For Image and tag, enter the repository name that you previously copied in Publish to Azure Container Registry.

    :::image type="content" source="../../media/quickstart-custom-container/configure-web-app-container.png" alt-text="Screenshot that shows how to configure your web app for containers.":::

    If you have a custom image for your web app in another location, like in Azure Container Registry or any other private repository, you can configure it here. Select Review + Create.

  8. Verify all the details, and then select Create.

    :::image type="content" source="../../media/quickstart-custom-container/web-app-container-create-start.png" alt-text="Screenshot that shows how to create your web app for containers.":::

    Wait for Azure to create the required resources.

Browse to the custom container

When the operation finishes, the Azure portal displays a notification.

:::image type="content" source="../../media/quickstart-custom-container/portal-create-finished.png" alt-text="Screenshot that shows deployment succeeded.":::

  1. Select Go to resource.

  2. In the overview, follow the link next to Default domain.

A new browser page opens.

:::image type="content" source="../../media/quickstart-custom-container/app-starting.png" alt-text="Screenshot that shows a Windows custom container starting.":::

Wait a few minutes and try again. Keep trying until you get the default ASP.NET home page.

:::image type="content" source="../../media/quickstart-custom-container/app-running-vs.png" alt-text="Screenshot that shows a Windows custom container running.":::

See container start-up logs

It can take some time for the Windows container to load. To see the progress, go to the following URL by replacing \<app_name> with the name of your app.

https://<app_name>.scm.azurewebsites.net/api/logstream

The streamed logs look like this:

2018-07-27T12:03:11  Welcome, you are now connected to log-streaming service.
27/07/2018 12:04:10.978 INFO - Site: win-container-demo - Start container succeeded. Container: facbf6cb214de86e58557a6d073396f640bbe2fdec88f8368695c8d1331fc94b
27/07/2018 12:04:16.767 INFO - Site: win-container-demo - Container start complete
27/07/2018 12:05:05.017 INFO - Site: win-container-demo - Container start complete
27/07/2018 12:05:05.020 INFO - Site: win-container-demo - Container started successfully

Update locally and redeploy

  1. In Visual Studio, go to Solution Explorer. Select Views > Home > Index.cshtml.

  2. Find the <div class="jumbotron"> HTML tag near the top, and replace the entire element with the following code:

    <div class="jumbotron">
    <h1>ASP.NET in Azure!</h1>
    <p class="lead">This is a simple app that we've built that demonstrates how to deploy a .NET app to Azure App Service.</p>
</div>

  3. To redeploy to Azure, right-click the myfirstazurewebapp project in Solution Explorer, and then select Publish.

  4. On the publish pane, select Publish and wait for publishing to finish.

  5. To tell App Service to pull in the new image from Docker Hub, restart the app. In the app pane in the Azure portal, select Restart > Yes.

    :::image type="content" source="../../media/quickstart-custom-container/portal-restart-app.png" alt-text="Screenshot that shows App Service Overview with the Restart button highlighted.":::

  6. Browse again to the custom container. As you refresh the page, the app should first revert to the Starting up page. It should then display the updated page.

    :::image type="content" source="../../media/quickstart-custom-container/azure-web-app-updated.png" alt-text="Screenshot that shows the updated web app in Azure.":::

Clean up resources

[!INCLUDE Clean-up Portal web app resources]

Related content