references/services/functions/consumption-to-flex/windows/workflow.md · 24000
Consumption |
|----------|-------------|------------------|
| SKU | Y1 (Dynamic) | FC1 (FlexConsumption) |
| Plan required | Optional (auto-created) | Required (must be explicit) |
| OS | Windows | Linux |
| Configuration | App settings | functionAppConfig section |
| Storage | WEBSITE_CONTENTSHARE setting | deployment.storage in functionAppConfig |
If the source app is managed through Bicep, ARM, or Terraform:
- Define the Flex app and plan as new resources; a Consumption app cannot be converted to Flex Consumption in place.
- Update the deployment definitions to use the new resource names and the Flex configuration above.
- Reconcile resources created during migration instead of allowing IaC to recreate or overwrite them. For Terraform, import the new resources when appropriate.
- Review the proposed changes with
az deployment group what-iforterraform planbefore applying them. - Update CI/CD pipelines to deploy to the new Flex app.
Do not mix ongoing manual configuration with resource-based deployments. If the app is not managed through IaC, skip this section.
Deprecated Settings (Do NOT Migrate)
These app settings must be filtered out before applying to the new Flex app (Step 4c). The skill handles this automatically — Step 4c streams source settings through jq, deleting these keys in memory before PATCHing the new app's ARM endpoint.
Azure Files content settings (always present on Windows Consumption — never migrate)
Every Windows Consumption app has these because the platform requires them for the Azure Files SMB share. Flex uses blob-based deployment instead — these have no equivalent.
These platform content settings are distinct from explicit Azure Files mount metadata returned by az webapp config storage-account list. Windows Consumption doesn't support explicit storage mounts, so catalog any returned metadata but don't migrate it.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTSHAREWEBSITE_CONTENTOVERVNETWEBSITE_SKIP_CONTENTSHARE_VALIDATION
Deployment settings (Flex uses deployment.storage in functionAppConfig, not app settings)
Windows Consumption has three historical aliases for run-from-package — all must be removed:
WEBSITE_RUN_FROM_PACKAGEWEBSITE_RUN_FROM_ZIP(legacy alias — same semantics asWEBSITE_RUN_FROM_PACKAGE)WEBSITE_USE_ZIP(original name — same semantics)
Runtime / scale settings (configured via functionAppConfig in Flex, not app settings)
FUNCTIONS_EXTENSION_VERSIONFUNCTIONS_WORKER_RUNTIMEFUNCTIONS_WORKER_RUNTIME_VERSIONFUNCTIONS_MAX_HTTP_CONCURRENCYFUNCTIONS_WORKER_PROCESS_COUNTFUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLEDWEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT
Other unsupported settings
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATEDWEBSITE_LOAD_CERTIFICATES(unused in Flex; use the site-scoped certificate process and make certificates accessible to app code)AzureWebJobsDashboard(legacy v1 setting — not used by the v4 runtime)WEBSITE_MOUNT_ENABLEDENABLE_ORYX_BUILDSCM_DO_BUILD_DURING_DEPLOYMENTWEBSITE_DNS_SERVERWEBSITE_NODE_DEFAULT_VERSIONWEBSITE_VNET_ROUTE_ALL
Application Insights (preserved from Step 4b and verified by Step 4k)
APPLICATIONINSIGHTS_CONNECTION_STRING— Step 4c preserves the target-specific value normally created byaz functionapp create; Step 4k verifies it without displaying the value.APPLICATIONINSIGHTS_AUTHENTICATION_STRING=Authorization=AADis preserved only when the source already used AAD ingestion.
Storage (replaced by Step 4b / 4b.opt)
Every setting whose name starts with AzureWebJobsStorage is dropped by the 4c filter. Preserve the target binding verified by Step 4b or configured by Step 4b.opt:
AzureWebJobsStorage— discard the source connection string. Step 4b creates a fresh target connection string only when Shared Key authentication is permitted; identity-first targets must not receive one.- All
AzureWebJobsStorage__*variants — discard source settings so they can't silently point the target runtime at the wrong account. Preserve verified target identity settings or re-derive them through 4b.opt where conversion is permitted.