Skip to content

Commit cd9f9b8

Browse files
authored
Merge pull request #294617 from TimShererWithAquent/us345675-14
Freshness Edit: Azure App Service (14 of several)
2 parents e8739b6 + bf0d0d1 commit cd9f9b8

29 files changed

+332
-430
lines changed

articles/app-service/includes/quickstart-custom-container/quickstart-custom-container-linux-azure-portal-pivot.md

Lines changed: 64 additions & 77 deletions
Original file line numberDiff line numberDiff line change
@@ -4,63 +4,61 @@ ms.service: azure-app-service
44
ms.devlang: java
55
ms.custom: linux-related-content
66
ms.topic: quickstart
7-
ms.date: 01/22/2025
7+
ms.date: 02/14/2025
88
ms.author: cephalin
99
---
1010

11-
[Azure App Service](../../overview.md) on Linux provides pre-defined application stacks on Linux with support for languages such as .NET, Java, Node.js, PHP, and others. You can also use a custom Docker image to run your web app on an application stack that isn't already defined in Azure. This quickstart shows you how to deploy an image from Azure Container Registry to Azure App Service.
11+
[Azure App Service](../../overview.md) on Linux provides predefined application stacks on Linux with support for languages such as .NET, Java, Node.js, and PHP. You can also use a custom Docker image to run your web app on an application stack that isn't already defined in Azure. This quickstart shows you how to deploy an image from Azure Container Registry to Azure App Service.
1212

13-
> [!NOTE]
14-
> For information regarding running containerized applications in a serverless environment, please see [Container Apps](../../../container-apps/overview.md).
15-
>
13+
For more information about containerized applications in a serverless environment, see [Container Apps](../../../container-apps/overview.md).
1614

17-
To complete this quickstart, you need:
15+
## Prerequisites
1816

1917
- An [Azure account](https://azure.microsoft.com/free/?utm_source=campaign&utm_campaign=vscode-tutorial-docker-extension&mktingSource=vscode-tutorial-docker-extension)
2018
- An [Azure container registry](/azure/container-registry/container-registry-get-started-portal)
2119
- [Azure CLI](/cli/azure/install-azure-cli)
2220
- [Docker](https://www.docker.com/community-edition)
2321

24-
## 1 - Clone the sample repository
22+
## Clone the sample repository
2523

2624
Clone the [the .NET 6.0 sample app](https://github.com/Azure-Samples/dotnetcore-docs-hello-world) with the following command:
2725

2826
```bash
2927
git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git
3028
```
3129

32-
## 2 - Push the image to Azure Container Registry
30+
## Push the image to Azure Container Registry
3331

34-
Make sure you are in the cloned repository's root folder. This repository contains a **Dockerfile.linux** file.
32+
Make sure you are in the cloned repository's root folder. This repository contains a *Dockerfile.linux* file.
3533

36-
1. Log in to the Azure CLI.
34+
1. Sign in to the Azure CLI.
3735

38-
```azurecli
39-
az login
40-
```
36+
```azurecli
37+
az login
38+
```
4139

42-
1. Log in to Azure Container Registry.
40+
1. Sign in to Azure Container Registry.
4341

44-
```azurecli
45-
az acr login -n <your_registry_name>
46-
```
42+
```azurecli
43+
az acr login -n <your_registry_name>
44+
```
4745

48-
1. Build the container image. We are naming the image **dotnetcore-docs-hello-world-linux**.
46+
1. Build the container image. This example uses the image name *dotnetcore-docs-hello-world-linux*.
4947

50-
```docker
51-
docker build -f Dockerfile.linux -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux .
52-
```
48+
```docker
49+
docker build -f Dockerfile.linux -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux .
50+
```
5351

5452
1. Push the container image to Azure Container Registry.
5553

56-
```docker
57-
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux:latest
58-
```
54+
```docker
55+
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux:latest
56+
```
5957

60-
> [!NOTE]
61-
> The Dockerfile sets the port number to 80 internally. For more information about configuring the container, see [Configure custom container](../../configure-custom-container.md).
58+
> [!NOTE]
59+
> The Dockerfile sets the port number to 80 internally. For more information about configuring the container, see [Configure custom container](../../configure-custom-container.md).
6260
63-
## 3 - Deploy to Azure
61+
## Deploy to Azure
6462

6563
### Sign in to Azure portal
6664

@@ -70,80 +68,69 @@ Sign in to the [Azure portal](https://portal.azure.com).
7068

7169
1. Type **app services** in the search. Under **Services**, select **App Services**.
7270

73-
:::image type="content" source="../../media/quickstart-custom-container/portal-search.png?text=Azure portal search details" alt-text="Screenshot of searching for 'app services' in the Azure portal.":::
71+
:::image type="content" source="../../media/quickstart-custom-container/portal-search.png" alt-text="Screenshot of searching for 'app services' in the Azure portal.":::
7472

75-
1. In the **App Services** page, select **+ Create**.
73+
1. In the **App Services** page, select **Create** > **Web App**.
7674

77-
1. In the **Basics** tab, under **Project details**, ensure the correct subscription is selected and then select to **Create new** resource group. Type *myResourceGroup* for the name.
75+
1. In the **Basics** tab, under **Project details**, select the correct subscription. Select **Create new** resource group. Type *myResourceGroup* for the name.
7876

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

81-
1. Under **Instance details**, type a globally unique name for your web app and select **Docker Container**. Select *Linux* for the **Operating System**. Select a **Region** you want to serve your app from.
79+
1. Under **Instance details**:
8280

83-
:::image type="content" source="../../media/quickstart-custom-container/instance-details-linux.png" alt-text="Screenshot of the Instance details section where you provide a name for the virtual machine and select its region, image and size.":::
81+
- Enter a globally unique name for your web app.
82+
- Select **Container**.
83+
- For the **Operating System**, select **Linux**.
84+
- Select a **Region** that you want to serve your app from.
8485

85-
1. Under **App Service Plan**, select **Create new** App Service Plan. Type *myAppServicePlan* for the name. To change to the Free tier, select **Change size**, select the **Dev/Test** tab, select **F1**, and select the **Apply** button at the bottom of the page.
86+
:::image type="content" source="../../media/quickstart-custom-container/instance-details-linux.png" alt-text="Screenshot of the Instance details section where you provide a name for the virtual machine and select its region, image, and size.":::
8687

87-
:::image type="content" source="../../media/quickstart-custom-container/app-service-plan-details-linux.png" alt-text="Screenshot of the App Service plan options.":::
88+
1. Under **App Service Plan**, select **Create new** App Service Plan. Enter *myAppServicePlan* for the name. To change to the Free tier, select **Change size**, select the **Dev/Test** tab, select **F1**. Select **Apply**.
8889

89-
1. Select the **Next: Docker >** button at the bottom of the page.
90+
:::image type="content" source="../../media/quickstart-custom-container/app-service-plan-details-linux.png" alt-text="Screenshot of the App Service plan options.":::
91+
92+
1. At the top of the page, select the **Container** tab.
93+
94+
1. In the **Container** tab, for **Image Source**, select **Azure Container Registry**. Under **Azure container registry options**, set the following values:
9095

91-
1. In the **Docker** tab, select *Single Container* under **Options** and *Azure Container Registry* for the **Image Source**. Under **Azure container registry options**, set the following values:
9296
- **Registry**: Select your Azure Container Registry.
93-
- **Image**: Select *dotnetcore-docs-hello-world-linux*.
94-
- **Tag**: Select *latest*.
97+
- **Image**: Select **dotnetcore-docs-hello-world-linux**.
98+
- **Tag**: Select **latest**.
99+
100+
:::image type="content" source="../../media/quickstart-custom-container/azure-container-registry-options-linux.png" alt-text="Screenshot showing the Azure Container Registry options.":::
95101

96-
:::image type="content" source="../../media/quickstart-custom-container/azure-container-registry-options-linux.png" alt-text="Screenshot showing the Azure Container Registry options.":::
97-
98-
1. Select the **Review + create** button at the bottom of the page.
102+
1. Select **Review + create** at the bottom of the page.
99103

100-
:::image type="content" source="../../media/quickstart-custom-container/review-create.png" alt-text="Screenshot showing the Review and create button at the bottom of the page.":::
104+
:::image type="content" source="../../media/quickstart-custom-container/review-create.png" alt-text="Screenshot showing the Review and create button at the bottom of the page.":::
101105

102-
1. After validation runs, select the **Create** button at the bottom of the page.
106+
1. After validation runs, select **Create**.
103107

104-
1. After deployment is complete, select **Go to resource**.
108+
1. After deployment finishes, select **Go to resource**.
105109

106-
:::image type="content" source="../../media/quickstart-custom-container/next-steps.png" alt-text="Screenshot showing the next step of going to the resource.":::
110+
:::image type="content" source="../../media/quickstart-custom-container/next-steps.png" alt-text="Screenshot showing the next step of going to the resource.":::
107111

108-
## 4 - Browse to the app
112+
## Browse to the app
109113

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

112116
:::image type="content" source="../../media/quickstart-custom-container/browse-custom-container-linux.png" alt-text="Screenshot showing the deployed application.":::
113117

114-
## 5 - Clean up resources
118+
## Clean up resources
115119

116120
[!INCLUDE [Clean-up Portal web app resources](../../../../includes/clean-up-section-portal-no-h.md)]
117121

118-
## Next steps
122+
## Related content
119123

120124
Congratulations, you've successfully completed this quickstart.
121125

122-
The App Service app pulls from the container registry every time it starts. If you rebuild your image, you just need to push it to your container registry, and the app pulls in the updated image when it restarts. To tell your app to pull in the updated image immediately, restart it.
123-
124-
> [!div class="nextstepaction"]
125-
> [Secure with custom domain and certificate](../../tutorial-secure-domain-certificate.md)
126-
127-
> [!div class="nextstepaction"]
128-
> [Migrate to Windows container in Azure](../../tutorial-custom-container.md)
129-
130-
> [!div class="nextstepaction"]
131-
> [Integrate your app with an Azure virtual network](../../overview-vnet-integration.md)
132-
133-
> [!div class="nextstepaction"]
134-
> [Use Private Endpoints for App Service apps](../../networking/private-endpoint.md)
135-
136-
> [!div class="nextstepaction"]
137-
> [Azure Monitor overview](/azure/azure-monitor/overview)
138-
139-
> [!div class="nextstepaction"]
140-
> [Application monitoring for Azure App Service overview](/azure/azure-monitor/app/azure-web-apps)
141-
142-
> [!div class="nextstepaction"]
143-
> [How to use managed identities for App Service and Azure Functions](../../overview-managed-identity.md)
144-
145-
> [!div class="nextstepaction"]
146-
> [Configure custom container](../../configure-custom-container.md)
147-
148-
> [!div class="nextstepaction"]
149-
> [Sidecar container tutorial](../../tutorial-custom-container-sidecar.md)
126+
The App Service app pulls from the container registry each time it starts. If you rebuild your image, just 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.
127+
128+
- [Secure with custom domain and certificate](../../tutorial-secure-domain-certificate.md)
129+
- [Migrate to Windows container in Azure](../../tutorial-custom-container.md)
130+
- [Integrate your app with an Azure virtual network](../../overview-vnet-integration.md)
131+
- [Use Private Endpoints for App Service apps](../../networking/private-endpoint.md)
132+
- [Azure Monitor overview](/azure/azure-monitor/overview)
133+
- [Application monitoring for Azure App Service overview](/azure/azure-monitor/app/azure-web-apps)
134+
- [How to use managed identities for App Service and Azure Functions](../../overview-managed-identity.md)
135+
- [Configure custom container](../../configure-custom-container.md)
136+
- [Sidecar container tutorial](../../tutorial-custom-container-sidecar.md)

0 commit comments

Comments
 (0)