From b349f3f7618aafaa2e6a598122770d605e4fbbf3 Mon Sep 17 00:00:00 2001 From: Tulika Chaudharie Date: Thu, 7 Aug 2025 14:53:28 +0530 Subject: [PATCH 1/3] added another FAQ to revert config --- articles/app-service/overview-sidecar.md | 29 ++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/articles/app-service/overview-sidecar.md b/articles/app-service/overview-sidecar.md index 802e90bb01c14..bb2a7090fabb5 100644 --- a/articles/app-service/overview-sidecar.md +++ b/articles/app-service/overview-sidecar.md @@ -52,6 +52,35 @@ Use Azure Monitor, Log Analytics, and the Diagnose & Solve blade in the Azure po ### Are there any limitations? Persistent Azure storage is not supported for sidecars. App Service Environment (ASE) and national clouds may not be supported yet. Check the latest Azure documentation for updates. +### How do I revert my app from the new sidecar configuration back to the classic custom container setup? + +If you’ve already moved your web app to the new sidecar configuration (`sitecontainers`) and want to revert to the classic custom container (`docker`) setup, you can do so using the Azure CLI. + +Use the following command: + +```bash +az webapp sitecontainers convert --mode docker --name --resource-group +``` + +This will delete all sidecar configurations and switch your app back to using the `DOCKER|`-style `linuxFxVersion`. You’ll see output confirming the conversion: + +```json +{ + "mode": "docker", + "result": "success" +} +``` + +> **Note:** You must run this command on a web app that is currently using the `sitecontainers` configuration. If your app is not in that mode, the CLI will return an error. + +To switch *to* sidecar mode from a classic custom container setup, use: + +```bash +az webapp sitecontainers convert --mode sitecontainers --name --resource-group +``` + +For full details, see the [Azure CLI documentation for `az webapp sitecontainers convert`](https://learn.microsoft.com/en-us/cli/azure/webapp/sitecontainers?view=azure-cli-latest). + ## More resources - [Interactive guide: sidecars in Azure App Service](https://mslabs.cloudguides.com/guides/Modernize%20existing%20web%20apps%20with%20new%20capabilities%20using%20Sidecar%20patterns) From ad42197513066719c2857edd1ee652b85923d1a7 Mon Sep 17 00:00:00 2001 From: Tulika Chaudharie Date: Thu, 7 Aug 2025 17:17:49 +0530 Subject: [PATCH 2/3] Updated based on feedback from Cephas --- articles/app-service/configure-sidecar.md | 19 +++++++++++++-- articles/app-service/overview-sidecar.md | 29 ----------------------- 2 files changed, 17 insertions(+), 31 deletions(-) diff --git a/articles/app-service/configure-sidecar.md b/articles/app-service/configure-sidecar.md index 890ba2206aba2..ca798fdbcec18 100644 --- a/articles/app-service/configure-sidecar.md +++ b/articles/app-service/configure-sidecar.md @@ -25,12 +25,27 @@ For a custom container, you need to explicitly enable sidecar support. In the po :::image type="content" source="media/configure-sidecar/enable-sidecar.png" alt-text="A screenshot showing a custom container app's container settings with the Start Update button highlighted."::: -With the Azure CLI, set `LinuxFxVersion` to `sitecontainers`. For example: +With the Azure CLI, convert your web app to use the `sitecontainers` configuration. For example: ```azurecli -az webapp config set --name --resource-group --linux-fx-version sitecontainers +az webapp sitecontainers convert --mode sitecontainers --name --resource-group ``` +This updates the `LinuxFxVersion` to `sitecontainers` and enables support for the sidecar pattern. + +### Revert to classic custom container (Docker) mode + +If you need to switch back from the sidecar-enabled configuration to the classic Docker-based setup, run the following command: + +```azurecli +az webapp sitecontainers convert \ + --mode docker \ + --name \ + --resource-group +``` + +This command removes all sidecar containers and resets your app to use the classic `DOCKER|` style configuration. For full details, see the [Azure CLI documentation for `az webapp sitecontainers convert`](https://learn.microsoft.com/cli/azure/webapp/sitecontainers?view=azure-cli-latest). + For more information, see [What are the differences for sidecar-enabled custom containers?](#what-are-the-differences-for-sidecar-enabled-custom-containers) ### What are the differences for sidecar-enabled custom containers? diff --git a/articles/app-service/overview-sidecar.md b/articles/app-service/overview-sidecar.md index bb2a7090fabb5..802e90bb01c14 100644 --- a/articles/app-service/overview-sidecar.md +++ b/articles/app-service/overview-sidecar.md @@ -52,35 +52,6 @@ Use Azure Monitor, Log Analytics, and the Diagnose & Solve blade in the Azure po ### Are there any limitations? Persistent Azure storage is not supported for sidecars. App Service Environment (ASE) and national clouds may not be supported yet. Check the latest Azure documentation for updates. -### How do I revert my app from the new sidecar configuration back to the classic custom container setup? - -If you’ve already moved your web app to the new sidecar configuration (`sitecontainers`) and want to revert to the classic custom container (`docker`) setup, you can do so using the Azure CLI. - -Use the following command: - -```bash -az webapp sitecontainers convert --mode docker --name --resource-group -``` - -This will delete all sidecar configurations and switch your app back to using the `DOCKER|`-style `linuxFxVersion`. You’ll see output confirming the conversion: - -```json -{ - "mode": "docker", - "result": "success" -} -``` - -> **Note:** You must run this command on a web app that is currently using the `sitecontainers` configuration. If your app is not in that mode, the CLI will return an error. - -To switch *to* sidecar mode from a classic custom container setup, use: - -```bash -az webapp sitecontainers convert --mode sitecontainers --name --resource-group -``` - -For full details, see the [Azure CLI documentation for `az webapp sitecontainers convert`](https://learn.microsoft.com/en-us/cli/azure/webapp/sitecontainers?view=azure-cli-latest). - ## More resources - [Interactive guide: sidecars in Azure App Service](https://mslabs.cloudguides.com/guides/Modernize%20existing%20web%20apps%20with%20new%20capabilities%20using%20Sidecar%20patterns) From 187ba6b6da0f8d7d7c1e3327f187689ec62fd17d Mon Sep 17 00:00:00 2001 From: Tulika Chaudharie Date: Thu, 7 Aug 2025 18:42:41 +0530 Subject: [PATCH 3/3] fixed the cli url --- articles/app-service/configure-sidecar.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/articles/app-service/configure-sidecar.md b/articles/app-service/configure-sidecar.md index ca798fdbcec18..fdbb44b7479b0 100644 --- a/articles/app-service/configure-sidecar.md +++ b/articles/app-service/configure-sidecar.md @@ -44,7 +44,7 @@ az webapp sitecontainers convert \ --resource-group ``` -This command removes all sidecar containers and resets your app to use the classic `DOCKER|` style configuration. For full details, see the [Azure CLI documentation for `az webapp sitecontainers convert`](https://learn.microsoft.com/cli/azure/webapp/sitecontainers?view=azure-cli-latest). +This command removes all sidecar containers and resets your app to use the classic `DOCKER|` style configuration. For full details, see the [Azure CLI documentation for `az webapp sitecontainers convert`](/cli/azure/webapp/sitecontainers). For more information, see [What are the differences for sidecar-enabled custom containers?](#what-are-the-differences-for-sidecar-enabled-custom-containers)