Skip to content

[App Service] az webapp up: Add warning message for future deprecation#33410

Merged
yanzhudd merged 1 commit into
Azure:devfrom
vageorge00:deprecate-webapp-up
May 22, 2026
Merged

[App Service] az webapp up: Add warning message for future deprecation#33410
yanzhudd merged 1 commit into
Azure:devfrom
vageorge00:deprecate-webapp-up

Conversation

@vageorge00
Copy link
Copy Markdown
Contributor

@vageorge00 vageorge00 commented May 20, 2026

Related command

az webapp up

Description

App Service Team is deprecating az webapp up. This command continues to function, this PR will only add a deprecation warning so az cli users are notified ahead of eventual removal.

Users will see a warning directing them to az webapp create and az webapp deploy.
No expiration version is set - this is a warning only phase.

Testing Guide

Ran az webapp -help to confirm az webapp up is deprecated in command group:
image

Ran az webapp up --help to confirm help shows it is deprecated:
image

Ran az webapp up --dryrun to show summary of the operation. Confirmed it shows it is deprecated:
image

azdev style appservice
image

azdev linter appservice
image

History Notes


This checklist is used to make sure that common guidelines for a pull request are followed.

@azure-client-tools-bot-prd
Copy link
Copy Markdown

azure-client-tools-bot-prd Bot commented May 20, 2026

️✔️AzureCLI-FullTest
️✔️acr
️✔️latest
️✔️3.12
️✔️3.13
️✔️acs
️✔️latest
️✔️3.12
️✔️3.13
️✔️advisor
️✔️latest
️✔️3.12
️✔️3.13
️✔️ams
️✔️latest
️✔️3.12
️✔️3.13
️✔️apim
️✔️latest
️✔️3.12
️✔️3.13
️✔️appconfig
️✔️latest
️✔️3.12
️✔️3.13
️✔️appservice
️✔️latest
️✔️3.12
️✔️3.13
️✔️aro
️✔️latest
️✔️3.12
️✔️3.13
️✔️backup
️✔️latest
️✔️3.12
️✔️3.13
️✔️batch
️✔️latest
️✔️3.12
️✔️3.13
️✔️batchai
️✔️latest
️✔️3.12
️✔️3.13
️✔️billing
️✔️latest
️✔️3.12
️✔️3.13
️✔️botservice
️✔️latest
️✔️3.12
️✔️3.13
️✔️cdn
️✔️latest
️✔️3.12
️✔️3.13
️✔️cloud
️✔️latest
️✔️3.12
️✔️3.13
️✔️cognitiveservices
️✔️latest
️✔️3.12
️✔️3.13
️✔️compute_recommender
️✔️latest
️✔️3.12
️✔️3.13
️✔️computefleet
️✔️latest
️✔️3.12
️✔️3.13
️✔️config
️✔️latest
️✔️3.12
️✔️3.13
️✔️configure
️✔️latest
️✔️3.12
️✔️3.13
️✔️consumption
️✔️latest
️✔️3.12
️✔️3.13
️✔️container
️✔️latest
️✔️3.12
️✔️3.13
️✔️containerapp
️✔️latest
️✔️3.12
️✔️3.13
️✔️core
️✔️latest
️✔️3.12
️✔️3.13
️✔️cosmosdb
️✔️latest
️✔️3.12
️✔️3.13
️✔️databoxedge
️✔️latest
️✔️3.12
️✔️3.13
️✔️dls
️✔️latest
️✔️3.12
️✔️3.13
️✔️dms
️✔️latest
️✔️3.12
️✔️3.13
️✔️eventgrid
️✔️latest
️✔️3.12
️✔️3.13
️✔️eventhubs
️✔️latest
️✔️3.12
️✔️3.13
️✔️feedback
️✔️latest
️✔️3.12
️✔️3.13
️✔️find
️✔️latest
️✔️3.12
️✔️3.13
️✔️hdinsight
️✔️latest
️✔️3.12
️✔️3.13
️✔️identity
️✔️latest
️✔️3.12
️✔️3.13
️✔️iot
️✔️latest
️✔️3.12
️✔️3.13
️✔️keyvault
️✔️latest
️✔️3.12
️✔️3.13
️✔️lab
️✔️latest
️✔️3.12
️✔️3.13
️✔️managedservices
️✔️latest
️✔️3.12
️✔️3.13
️✔️maps
️✔️latest
️✔️3.12
️✔️3.13
️✔️marketplaceordering
️✔️latest
️✔️3.12
️✔️3.13
️✔️monitor
️✔️latest
️✔️3.12
️✔️3.13
️✔️mysql
️✔️latest
️✔️3.12
️✔️3.13
️✔️netappfiles
️✔️latest
️✔️3.12
️✔️3.13
️✔️network
️✔️latest
️✔️3.12
️✔️3.13
️✔️policyinsights
️✔️latest
️✔️3.12
️✔️3.13
️✔️postgresql
️✔️latest
️✔️3.12
️✔️3.13
️✔️privatedns
️✔️latest
️✔️3.12
️✔️3.13
️✔️profile
️✔️latest
️✔️3.12
️✔️3.13
️✔️rdbms
️✔️latest
️✔️3.12
️✔️3.13
️✔️redis
️✔️latest
️✔️3.12
️✔️3.13
️✔️relay
️✔️latest
️✔️3.12
️✔️3.13
️✔️resource
️✔️latest
️✔️3.12
️✔️3.13
️✔️role
️✔️latest
️✔️3.12
️✔️3.13
️✔️search
️✔️latest
️✔️3.12
️✔️3.13
️✔️security
️✔️latest
️✔️3.12
️✔️3.13
️✔️servicebus
️✔️latest
️✔️3.12
️✔️3.13
️✔️serviceconnector
️✔️latest
️✔️3.12
️✔️3.13
️✔️servicefabric
️✔️latest
️✔️3.12
️✔️3.13
️✔️signalr
️✔️latest
️✔️3.12
️✔️3.13
️✔️sql
️✔️latest
️✔️3.12
️✔️3.13
️✔️sqlvm
️✔️latest
️✔️3.12
️✔️3.13
️✔️storage
️✔️latest
️✔️3.12
️✔️3.13
️✔️synapse
️✔️latest
️✔️3.12
️✔️3.13
️✔️telemetry
️✔️latest
️✔️3.12
️✔️3.13
️✔️util
️✔️latest
️✔️3.12
️✔️3.13
️✔️vm
️✔️latest
️✔️3.12
️✔️3.13

@azure-client-tools-bot-prd
Copy link
Copy Markdown

Hi @vageorge00,
Since the current milestone time is less than 7 days, this pr will be reviewed in the next milestone.

@azure-client-tools-bot-prd
Copy link
Copy Markdown

azure-client-tools-bot-prd Bot commented May 20, 2026

⚠️AzureCLI-BreakingChangeTest
⚠️appservice
rule cmd_name rule_message suggest_message
⚠️ 1003 - CmdPropAdd webapp up cmd webapp up added property deprecate_info_redirect

@microsoft-github-policy-service microsoft-github-policy-service Bot added the customer-reported Issues that are reported by GitHub users external to the Azure organization. label May 20, 2026
@microsoft-github-policy-service
Copy link
Copy Markdown
Contributor

Thank you for your contribution @vageorge00! We will review the pull request and get back to you soon.

@yonzhan
Copy link
Copy Markdown
Collaborator

yonzhan commented May 20, 2026

Thank you for your contribution! We will review the pull request and get back to you soon.

@github-actions
Copy link
Copy Markdown

The git hooks are available for azure-cli and azure-cli-extensions repos. They could help you run required checks before creating the PR.

Please sync the latest code with latest dev branch (for azure-cli) or main branch (for azure-cli-extensions).
After that please run the following commands to enable git hooks:

pip install azdev --upgrade
azdev setup -c <your azure-cli repo path> -r <your azure-cli-extensions repo path>

… and `az webapp deploy`

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@vageorge00 vageorge00 force-pushed the deprecate-webapp-up branch from 5d9741c to 2c747a5 Compare May 20, 2026 21:58
@vageorge00 vageorge00 marked this pull request as ready for review May 20, 2026 22:39
Copilot AI review requested due to automatic review settings May 20, 2026 22:39
@yonzhan yonzhan assigned yanzhudd and unassigned zhoxing-ms and yanzhudd May 20, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a deprecation warning for az webapp up in the App Service command module so users are proactively guided toward supported alternatives before a future removal.

Changes:

  • Marks az webapp up as deprecated via deprecate_info on the command registration.
  • Provides a redirect hint pointing users to webapp create and webapp deploy.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread src/azure-cli/azure/cli/command_modules/appservice/commands.py
@glaming1
Copy link
Copy Markdown

Are there any other places where we potentially suggest using az webapp up in any other command? I remember we tried making commands more discoverable -- just want to make sure there were no places where we are still recommending using this

@vageorge00
Copy link
Copy Markdown
Contributor Author

vageorge00 commented May 20, 2026

@glaming1

Are there any other places where we potentially suggest using az webapp up in any other command? I remember we tried making commands more discoverable -- just want to make sure there were no places where we are still recommending using this

Good point, did a sweep, all of these seem out of scope for this PR. These mentions of az webapp up should be removed when fully deprecated. az webapp up is mentioned in the following files:

  1. src/azure-cli/azure/cli/command_modules/appservice/commands.py (line 134)
    I added the deprecation note, should be removed with the full deprecation.

  2. src/azure-cli/azure/cli/command_modules/appservice/_help.py (lines 2652-2700)
    Part of az webapp up help. Should be removed with the full deprecation

  3. src/azure-cli/azure/cli/command_modules/appservice/_params.py (line 973)
    Part of az webapp up params. Should be removed with the full deprecation.

  4. src/azure-cli/azure/cli/command_modules/appservice/custom.py

  • The webapp_up() function (around line 10300+) — the command's implementation. This and it's webapp up specific helpers should be removed with full deprecation.
  • The _set_webapp_up_default_args() helper (around line 10400) — an az webapp up specific helper. Should be removed with full deprecation.
  • The using_webapp_up parameter on create_webapp() (line 128) and its branches (lines 246-247, 347, 385) — internal flag passed when create_webapp is called from webapp_up(). Should be removed with full deprecation.
  1. src/azure-cli/azure/cli/command_modules/appservice/_create_util.py (lines 329, 343)
    get_site_availability and get_regional_site_availability comments (not shown in cli) mention az webapp up. These docstrings are actually stale — the functions are called from many commands (az webapp create, az webapp deleted restore, az functionapp create, etc.), not just az webapp up. Not customer-facing (source-only). Out of scope for this PR. But let me know if I should remove the mention. We can also remove it when fully deprecated.

  2. src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py (lines 7-8)
    Module docstring: "Context-enriched error builder for az webapp deploy / az webapp up. Enabled via the --enriched-errors flag on az webapp deploy / az webapp up." Currently accurate since --enriched-errors works on both commands. Not customer-facing. We can remove this when fully deprecated.

  3. src/azure-cli/azure/cli/command_modules/appservice/tests/latest/test_webapp_up_commands.py
    The full test suite for the command. Not removed because tests must continue to pass while the command is functional. Should remove when fully deprecated.

  4. src/azure-cli/azure/cli/command_modules/appservice/tests/latest/test_webapp_commands.py (lines 3594-3653)
    The WebappEnrichedErrorsScenarioTest class and its test_webapp_up_enriched_errors_flag_accepted method — exercises the shared --enriched-errors flag. Same reason as 7.

  5. .github/policies/resourceManagement.yml
    The issue-routing regex contains az webapp up so issues mentioning the command route to the App Service team. Intentionally kept — customers will continue filing issues during and after deprecation, and we still want them routed correctly.

@yanzhudd yanzhudd changed the title [App Service] Deprecate az webapp up in favor of az webapp create [App Service] az webapp up: Pre-announce deprecation May 22, 2026
@yanzhudd yanzhudd changed the title [App Service] az webapp up: Pre-announce deprecation [App Service] az webapp up: Add warning message for future deprecation May 22, 2026
@yanzhudd yanzhudd merged commit 3cef0c6 into Azure:dev May 22, 2026
53 of 54 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

act-observability-squad Auto-Assign Auto assign by bot customer-reported Issues that are reported by GitHub users external to the Azure organization. Web Apps az webapp

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants