From 66bc2b929cb1764c3ee80cac1fff1442d14732a3 Mon Sep 17 00:00:00 2001 From: Rob E Date: Wed, 2 Sep 2026 16:58:18 +1000 Subject: [PATCH 1/3] Document planned deprecation of Azure Web App step Added information about the planned deprecation of the Azure Web App step and recommended migration paths for users. --- src/pages/docs/deprecations/index.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/src/pages/docs/deprecations/index.md b/src/pages/docs/deprecations/index.md index ca5710cb74..5124e1e009 100644 --- a/src/pages/docs/deprecations/index.md +++ b/src/pages/docs/deprecations/index.md @@ -29,9 +29,18 @@ If you have questions or need help assessing the impact of a deprecation on your ## Planned Deprecations +## Azure Web App Step {#azure-web-app-deprecate} +The `Deploy an Azure Web App (Web Deploy)` step depends on Microsoft's [Web Deploy tooling](https://www.nuget.org/packages/Microsoft.Web.Deployment) which only run on Windows and have not been updated for several years. + +Although Azure Web Apps are still a service provided by Azure, most deployment processes now rely on the `az webapp deployment` cli tooling. Unfortunately this new approach does not have feature parity with the older MSDeploy capabilities and so a simple automated port by Octopus from old to new is not viable. + +From **2026.3** Octopus Server will no longer support adding new `Azure Web App (Web Deploy)` steps. We reccommend users migrate towards the use of the `Azure App Service` step, or use the `Azure Script` step to perform the required deployment process. + +In the **2027.1** release we will convert remaining `Azure Web App (Web Deploy)` steps to an `Azure Script` step, ensuring like-for-like invocation of the old MSDeploy tools for legacy usage. + ## VHD Deployments {#vhd-deprecation} -The Deploy a VHD step allows for deployment of VHD/VHDX files to Hyper-V. This step has extremely low usage and will be disabled by default in `2026.4` and removed in `2027.1`. +The `Deploy a VHD` step allows for deployment of VHD/VHDX files to Hyper-V. This step has extremely low usage and will be disabled by default in `2026.4` and removed in `2027.1`. ## Step Package Framework (SPF) deprecation {#step-package-framework-spf-deprecation} From ed07d6c7c91c7dbe907640fa43130c235b7f1d49 Mon Sep 17 00:00:00 2001 From: Rob E Date: Wed, 2 Sep 2026 17:12:27 +1000 Subject: [PATCH 2/3] Revise Azure Web App deprecation details Updated the section on Azure Web App (Web Deploy) step to clarify deprecation plans and migration recommendations. --- src/pages/docs/deprecations/index.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/src/pages/docs/deprecations/index.md b/src/pages/docs/deprecations/index.md index 5124e1e009..eca692dd99 100644 --- a/src/pages/docs/deprecations/index.md +++ b/src/pages/docs/deprecations/index.md @@ -29,14 +29,15 @@ If you have questions or need help assessing the impact of a deprecation on your ## Planned Deprecations -## Azure Web App Step {#azure-web-app-deprecate} -The `Deploy an Azure Web App (Web Deploy)` step depends on Microsoft's [Web Deploy tooling](https://www.nuget.org/packages/Microsoft.Web.Deployment) which only run on Windows and have not been updated for several years. +## Azure Web App (Web Deploy) step {#azure-web-app-deprecate} -Although Azure Web Apps are still a service provided by Azure, most deployment processes now rely on the `az webapp deployment` cli tooling. Unfortunately this new approach does not have feature parity with the older MSDeploy capabilities and so a simple automated port by Octopus from old to new is not viable. +The `Deploy an Azure Web App (Web Deploy)` step depends on Microsoft's [Web Deploy tooling](https://www.nuget.org/packages/Microsoft.Web.Deployment) which only runs on Windows and has not been updated for several years. -From **2026.3** Octopus Server will no longer support adding new `Azure Web App (Web Deploy)` steps. We reccommend users migrate towards the use of the `Azure App Service` step, or use the `Azure Script` step to perform the required deployment process. +Although Azure Web Apps are still a service provided by Azure, most deployment processes now rely on the `az webapp deployment` CLI tooling. Unfortunately this new approach does not have feature parity with the older MSDeploy capabilities and so a simple automated port by Octopus from old to new is not viable. -In the **2027.1** release we will convert remaining `Azure Web App (Web Deploy)` steps to an `Azure Script` step, ensuring like-for-like invocation of the old MSDeploy tools for legacy usage. +From **2026.3** Octopus Server will no longer support adding new `Azure Web App (Web Deploy)` steps. We recommend users migrate towards the use of the `Azure App Service` step, or use the `Run an Azure Script` step to perform the required deployment process. + +Pending feedback, in a later release we will convert remaining `Azure Web App (Web Deploy)` steps to an `Run an Azure Script` step, ensuring like-for-like invocation of the old MSDeploy tools for legacy usage. ## VHD Deployments {#vhd-deprecation} From c3463a3c68948473969526ac0b059f018b5323c5 Mon Sep 17 00:00:00 2001 From: Rob E Date: Wed, 2 Sep 2026 17:15:28 +1000 Subject: [PATCH 3/3] Update deprecation notice for Azure Web App step Clarify deprecation of the Azure Web App (Web Deploy) step and recommend migration to Azure App Service or Azure Script step. --- src/pages/docs/deprecations/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/docs/deprecations/index.md b/src/pages/docs/deprecations/index.md index eca692dd99..17dde19356 100644 --- a/src/pages/docs/deprecations/index.md +++ b/src/pages/docs/deprecations/index.md @@ -31,7 +31,7 @@ If you have questions or need help assessing the impact of a deprecation on your ## Azure Web App (Web Deploy) step {#azure-web-app-deprecate} -The `Deploy an Azure Web App (Web Deploy)` step depends on Microsoft's [Web Deploy tooling](https://www.nuget.org/packages/Microsoft.Web.Deployment) which only runs on Windows and has not been updated for several years. +The `Deploy an Azure Web App (Web Deploy)` step depends on Microsoft's [Web Deploy tooling](https://www.nuget.org/packages/Microsoft.Web.Deployment) which only runs on Windows and has not been updated for several years. Although Azure Web Apps are still a service provided by Azure, most deployment processes now rely on the `az webapp deployment` CLI tooling. Unfortunately this new approach does not have feature parity with the older MSDeploy capabilities and so a simple automated port by Octopus from old to new is not viable.