Skip to content

[AKS] Hotfix: az aks create/update: Add --enable-app-routing-istio and --disable-app-routing-istio to manage App Routing Istio gateway implementation#33287

Merged
wangzelin007 merged 2 commits intoAzure:releasefrom
meecethereese:work/ari-onto-release-20260429-131231
Apr 30, 2026
Merged

[AKS] Hotfix: az aks create/update: Add --enable-app-routing-istio and --disable-app-routing-istio to manage App Routing Istio gateway implementation#33287
wangzelin007 merged 2 commits intoAzure:releasefrom
meecethereese:work/ari-onto-release-20260429-131231

Conversation

@meecethereese
Copy link
Copy Markdown
Contributor

Hotfix cherry-pick of #33254 onto release

Cherry-picks #33254 ("az aks create/update: Add --enable-app-routing-istio and --disable-app-routing-istio to manage App Routing Istio gateway implementation") onto the release branch so the GA App Routing Istio surface ships in the next patch without waiting for the regular dev → release promotion.

Why hotfix

App Routing Istio is being promoted from the aks-preview extension to the GA Azure CLI. Customers need the new flags (--enable-app-routing-istio / --disable-app-routing-istio, with --enable-ari / --disable-ari aliases) available in the current release line to onboard via the in-box CLI.

Contents

Notes for reviewers

  • This is an ingress-only Istio deployment for App Routing — it does not provide service-mesh functionality (mTLS, inter-service traffic management).
  • It is mutually exclusive with the Istio service mesh add-on (--enable-azure-service-mesh).
  • Requires App Routing enabled on the cluster; the managed Gateway API installation provides the Gateway implementation that App Routing Istio binds to.

Follow-up

A release → dev back-merge PR will be opened after this ships, without squash, to keep the histories aligned (per the precedent in #32168, #32881, #32038, #32076, #15505).

References

…o / --disable-app-routing-istio

Cherry-pick of Azure#33254 onto release.

Promotes App Routing Istio from the aks-preview extension to the GA Azure CLI:
adds --enable-app-routing-istio (with --enable-ari alias) to az aks create
and both --enable-app-routing-istio and --disable-app-routing-istio
(with --enable-ari / --disable-ari aliases) to az aks update, managing
ingressProfile.webAppRouting.gatewayApiImplementations.appRoutingIstio.mode.
@azure-client-tools-bot-prd
Copy link
Copy Markdown

Hi @meecethereese,
Usually we only allow pull requests to be submitted to the dev branch, please double check your pull request target branch release.

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

Validation for Azure CLI Full Test Starting...

Thanks for your contribution!

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

Validation for Breaking Change Starting...

Thanks for your contribution!

@yonzhan
Copy link
Copy Markdown
Collaborator

yonzhan commented Apr 29, 2026

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

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

Hotfix cherry-pick onto release to ship GA support for configuring the App Routing Istio Gateway API implementation in AKS via new CLI flags (and related aks approuting convenience commands), along with help/docs, tests, and recordings.

Changes:

  • Add --enable-app-routing-istio/--disable-app-routing-istio (and --enable-ari/--disable-ari aliases) to az aks create/az aks update, wiring them into ingressProfile.webAppRouting.gatewayApiImplementations.appRoutingIstio.mode.
  • Add new command group az aks approuting gateway istio {enable|disable} to toggle the same setting via the App Routing command surface.
  • Add/extend unit + scenario tests and include the necessary test recordings; update HISTORY.rst for the 2.86.1 hotfix note.

Reviewed changes

Copilot reviewed 10 out of 15 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
src/azure-cli/azure/cli/command_modules/acs/managed_cluster_decorator.py Adds context getters and create/update decorator logic to set App Routing Istio mode in the ingress profile.
src/azure-cli/azure/cli/command_modules/acs/custom.py Plumbs new flags into aks create/update and adds aks approuting gateway istio enable/disable handlers.
src/azure-cli/azure/cli/command_modules/acs/commands.py Registers aks approuting gateway istio command group and commands.
src/azure-cli/azure/cli/command_modules/acs/_params.py Adds CLI parameters and aliases for enabling/disabling App Routing Istio on create/update.
src/azure-cli/azure/cli/command_modules/acs/_help.py Documents the new flags and the new aks approuting gateway istio command group.
src/azure-cli/azure/cli/command_modules/acs/_consts.py Introduces constants for App Routing Istio mode values.
src/azure-cli/azure/cli/command_modules/acs/tests/latest/test_managed_cluster_decorator.py Adds unit coverage for new context getters and decorator update/setup methods.
src/azure-cli/azure/cli/command_modules/acs/tests/latest/test_aks_commands.py Adds scenario tests covering enable/disable flows and ASM mutual-exclusion behavior.
src/azure-cli/azure/cli/command_modules/acs/tests/latest/recordings/test_aks_create_with_app_routing_istio_fails_when_asm_enabled.yaml Adds recording for the new failure scenario test.
src/azure-cli/HISTORY.rst Adds 2.86.1 hotfix entry for the new AKS surface.

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

Comment thread src/azure-cli/azure/cli/command_modules/acs/_params.py
@yanzhudd yanzhudd changed the title [AKS] Hotfix: Cherry-pick #33254 — Add --enable-app-routing-istio / --disable-app-routing-istio [AKS] Hotfix: az aks create/update: Add --enable-app-routing-istio and --disable-app-routing-istio to manage App Routing Istio gateway implementation Apr 30, 2026
@yanzhudd
Copy link
Copy Markdown
Contributor

yanzhudd commented Apr 30, 2026

Hi @meecethereese
please discard the changes to the HISTORY.rst as we don't need to make that change manually.

@meecethereese
Copy link
Copy Markdown
Contributor Author

@yanzhudd I've removed the History.rst file!

@wangzelin007 wangzelin007 merged commit 7d395bd into Azure:release Apr 30, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

act-observability-squad AKS az aks/acs/openshift Auto-Assign Auto assign by bot

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants