Skip to content

Commit 2591ed6

Browse files
cephalincephalin
committed
add arm steps
1 parent e8d4874 commit 2591ed6

File tree

2 files changed

+75
-7
lines changed

2 files changed

+75
-7
lines changed

‎articles/app-service/tutorial-custom-container-sidecar.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,12 @@ keywords: azure app service, web app, linux, windows, docker, container, sidecar
1212

1313
In this tutorial, you add an OpenTelemetry collector as a sidecar container to a Linux custom container app in Azure App Service.
1414

15-
In Azure App Service, you can add up to four sidecar containers for each sidecar-enabled custom container app. Sidecar containers let you deploy extra services and features to your container application without making them tightly coupled to your main application container. For example, you can add monitoring, logging, configuration, and networking services as sidecar containers. An OpenTelemetry collector sidecar is one such monitoring example.
15+
In Azure App Service, you can add up to nine sidecar containers for each sidecar-enabled custom container app. Sidecar containers let you deploy extra services and features to your container application without making them tightly coupled to your main application container. For example, you can add monitoring, logging, configuration, and networking services as sidecar containers. An OpenTelemetry collector sidecar is one such monitoring example.
1616

17-
For more information about sidecars, see [Sidecar pattern](/azure/architecture/patterns/sidecar).
17+
For more information about side container in App Service, see:
18+
19+
- [Introducing Sidears for Azure App Service for Linux: Now Generally Available](https://azure.github.io/AppService/2024/11/08/Global-Availability-Sidecars.html)
20+
- [Announcing the general availability of sidecar extensibility in Azure App Service](https://techcommunity.microsoft.com/blog/appsonazureblog/announcing-the-general-availability-of-sidecar-extensibility-in-azure-app-servic/4267985)
1821

1922
[!INCLUDE [quickstarts-free-trial-note](~/reusable-content/ce-skilling/azure/includes/quickstarts-free-trial-note.md)]
2023

‎articles/app-service/tutorial-sidecar.md

Lines changed: 70 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: 'Tutorial: Configure a sidecar container'
33
description: Add sidecar containers to your linux app in Azure App Service. Add or update services to your application without changing your application code.
44
ms.topic: tutorial
5-
ms.date: 11/13/2024
5+
ms.date: 11/19/2024
66
ms.author: msangapu
77
author: msangapu-msft
88
keywords: azure app service, web app, linux, windows, docker, sidecar
@@ -12,9 +12,12 @@ keywords: azure app service, web app, linux, windows, docker, sidecar
1212

1313
In this tutorial, you add an OpenTelemetry collector as a sidecar container to a Linux app in Azure App Service.
1414

15-
In Azure App Service, you can add up to four sidecar containers for each sidecar-enabled custom container app. Sidecar containers let you deploy extra services and features to your container application without making them tightly coupled to your main application container. For example, you can add monitoring, logging, configuration, and networking services as sidecar containers. An OpenTelemetry collector sidecar is one such monitoring example.
15+
In Azure App Service, you can add up to nine sidecar containers for each sidecar-enabled custom container app. Sidecar containers let you deploy extra services and features to your container application without making them tightly coupled to your main application container. For example, you can add monitoring, logging, configuration, and networking services as sidecar containers. An OpenTelemetry collector sidecar is one such monitoring example.
1616

17-
For more information about sidecars, see [Sidecar pattern](/azure/architecture/patterns/sidecar).
17+
For more information about side container in App Service, see:
18+
19+
- [Introducing Sidears for Azure App Service for Linux: Now Generally Available](https://azure.github.io/AppService/2024/11/08/Global-Availability-Sidecars.html)
20+
- [Announcing the general availability of sidecar extensibility in Azure App Service](https://techcommunity.microsoft.com/blog/appsonazureblog/announcing-the-general-availability-of-sidecar-extensibility-in-azure-app-servic/4267985)
1821

1922
[!INCLUDE [quickstarts-free-trial-note](~/reusable-content/ce-skilling/azure/includes/quickstarts-free-trial-note.md)]
2023

@@ -71,11 +74,16 @@ This basic web application is deployed as MyFirstAzureWebApp.dll to App Service.
7174

7275
## 3. Add a sidecar container
7376

74-
In this section, you add a sidecar container to your custom container app.
77+
In this section, you add a sidecar container to your custom container app. The portal experience is still being rolled out. If it's not available to you yet, continue with the **Use ARM template** tab below.
78+
79+
### [Use portal UI](#tab/portal)
7580

7681
1. In the [Azure portal](https://portal.azure.com), navigate to the app's management page
7782
1. In the app's management page, from the left menu, select **Deployment Center**.
78-
1. Select the message **Interested in adding containers to run alongside your app? Click here to give it a try.**
83+
1. Select the banner **Interested in adding containers to run alongside your app? Click here to give it a try.**
84+
85+
If you can't see the banner, then the portal UI isn't rolled out for your subscription yet. Select the **Use ARM template** here instead and continue.
86+
7987
1. When the page reloads, select the **Containers (new)** tab.
8088
1. Select **Add** and configure the new container as follows:
8189
- **Name**: *otel-collector*
@@ -88,6 +96,63 @@ In this section, you add a sidecar container to your custom container app.
8896

8997
:::image type="content" source="media/tutorial-sidecar/add-sidecar-container.png" alt-text="Screenshot showing how to configure a sidecar container in a web app's deployment center.":::
9098

99+
### [Use ARM template](#tab/template)
100+
101+
1. Navigate to the [custom deployment](https://portal.azure.com/#create/Microsoft.Template) template in the portal.
102+
103+
1. Select **Build your own template in the editor**.
104+
105+
1. Replace the content in the textbox with the following JSON code and select **Save**:
106+
107+
```json
108+
{
109+
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
110+
"contentVersion": "1.0.0.0",
111+
"parameters": {
112+
"appName": {
113+
"type": "String"
114+
},
115+
"sidecarName": {
116+
"defaultValue": "otel-collector",
117+
"type": "String"
118+
},
119+
"azureContainerRegistryName": {
120+
"type": "String"
121+
},
122+
"azureContainerRegistryImageName": {
123+
"defaultValue": "otel-collector:latest",
124+
"type": "String"
125+
}
126+
},
127+
"resources": [
128+
{
129+
"type": "Microsoft.Web/sites/sitecontainers",
130+
"apiVersion": "2023-12-01",
131+
"name": "[concat(parameters('appName'), '/', parameters('sidecarName'))]",
132+
"properties": {
133+
"image": "[concat(parameters('azureContainerRegistryName'), '.azurecr.io/', parameters('azureContainerRegistryImageName'))]",
134+
"isMain": false,
135+
"authType": "UserCredentials",
136+
"userName": "[parameters('azureContainerRegistryImageName')]",
137+
"volumeMounts": [],
138+
"environmentVariables": []
139+
}
140+
}
141+
]
142+
}
143+
```
144+
145+
1. Configure the template with the following information:
146+
147+
- **Resource Group**: Select the resource group with the App Service app you created with `az webapp up` earlier.
148+
- **App Name**: Type the name of the App Service app.
149+
- **Azure Container Registry Name**: Type the name of the registry you created with `azd up` earlier.
150+
- **Azure Container Regsitry Image Name**: Leave the default value of *otel-collector:latest*. This points to the OpenTelemtry image in the registry.
151+
152+
1. Select **Review + Create**, then select **Create**.
153+
154+
-----
155+
91156
## 4. Configure environment variables
92157

93158
For the sample scenario, the otel-collector sidecar is configured to export the OpenTelemetry data to Azure Monitor, but it needs the connection string as an environment variable (see the [OpenTelemetry configuration file for the otel-collector image](https://github.com/Azure-Samples/app-service-sidecar-tutorial-prereqs/blob/main/images/otel-collector/otel-collector-config.yaml)).

0 commit comments

Comments
 (0)