Skip to content

quickstart-custom-container-windows-azure-portal-pivot.md

Latest commit

 

History

History
139 lines (89 loc) · 7.14 KB

quickstart-custom-container-windows-azure-portal-pivot.md

File metadata and controls

139 lines (89 loc) · 7.14 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 from Azure Container Registry to Azure App Service.

Azure App Service provides predefined application stacks on Windows, like ASP.NET or Node.js, 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

Clone the sample repository

Clone the the .NET 6.0 sample app by using the following command:

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

Push the image to Azure Container Registry

Make sure you're in the cloned repository's root folder. This repository contains a Dockerfile.windows file. This article uses Windows Nano Server Long Term Servicing Channel 2022 as the base operating system, and explicitly calls out the Windows base.

Note

Even though this container is a Windows container, the paths still need to use forward slashes. For more information, see Write a Dockerfile.

  1. Sign in to the Azure CLI.

    az login

  2. Sign in to Azure Container Registry.

    az acr login -n <your_registry_name>

  3. Build the container image. This example uses the image name dotnetcore-docs-hello-world-windows.

    docker build -f Dockerfile.windows -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows .

  4. Push the container image to Azure Container Registry.

    docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows:latest

    [!NOTE] The Dockerfile sets the port number to 80 internally. For more information, see Configure custom container.

Deploy to Azure

  1. Sign in to the Azure portal.

  2. Enter app services in the search box. Under Services, select App Services.

    :::image type="content" source="../../media/quickstart-custom-container/portal-search.png" alt-text="Screenshot that shows how to search for app services in the Azure portal.":::

  3. In App Services, select Create > Web App.

  4. On the Basics tab, under Project details, select the correct subscription. Select Create new. Enter myResourceGroup for the name.

    :::image type="content" source="../../media/quickstart-custom-container/project-details.png" alt-text="Screenshot that shows the Project details section where you select the Azure subscription and the resource group for the web app.":::

  5. Under Instance details:

    • Enter a globally unique name for your web app.
    • Select Container.
    • For Operating System, select Linux.
    • For Region, select the region from which you want to serve your app.

    :::image type="content" source="../../media/quickstart-custom-container/instance-details-windows.png" alt-text="Screenshot that shows the Instance details section where you provide a name for the virtual machine and select its region, image, and size.":::

  6. Under App Service Plan, select Create new. Enter myAppServicePlan for the name. To change the tier, select Explore pricing plans, select a plan, and choose Select at the bottom of the pane.

    :::image type="content" source="../../media/quickstart-custom-container/app-service-plan-details-windows.png" alt-text="Screenshot that shows App Service plan options.":::

  7. At the top of the pane, select the Container tab.

  8. On the Container tab, for Image Source, select Azure Container Registry. Under Azure Container Registry options, set the following values:

    • Registry: Select your container registry.
    • Image: Select dotnetcore-docs-hello-world-linux.
    • Tag: Select latest.

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

  9. Select Review + create at the bottom of the pane.

    :::image type="content" source="../../media/quickstart-custom-container/review-create.png" alt-text="Screenshot that shows the Review and create button at the bottom of the pane.":::

  10. After validation runs, select Create.

  11. After deployment finishes, select Go to resource.

    :::image type="content" source="../../media/quickstart-custom-container/next-steps.png" alt-text="Screenshot that shows how to go to the resource.":::

Go to the app

Go to the deployed application in your web browser at the URL http://<app-name>.azurewebsites.net.

:::image type="content" source="../../media/quickstart-custom-container/browse-custom-container-windows.png" alt-text="Screenshot that shows the Windows App Service.":::

The host operating system appears in the footer, which confirms that the app runs in a Windows container.

The App Service app pulls from the container registry each time it starts. If you rebuild your image, push it to your container registry. The app pulls in the updated image when it restarts. To tell your app to pull in the updated image immediately, restart it.

Clean up resources

[!INCLUDE Clean-up Portal web app resources]

Related content