Skip to content

{AKS} az aks create: add --enable-quick-attach-detach - #10502

Open
Jenniferyingni wants to merge 2 commits into
Azure:mainfrom
Jenniferyingni:aks/enable-quick-attach-detach
Open

Jenniferyingni wants to merge 2 commits into
Azure:mainfrom
Jenniferyingni:aks/enable-quick-attach-detach

Conversation

@Jenniferyingni

@Jenniferyingni Jenniferyingni commented Oct 21, 2026 •

Copy link
Copy Markdown
Member

🤖 PR Validation — ⚠️ Review suggested

Breaking Changes
⚠️ None
⚠️Azure CLI Extensions Breaking Change Test
⚠️aks-preview
rule cmd_name rule_message suggest_message
⚠️ 1006 - ParaAdd aks create cmd aks create added parameter enable_quick_attach_detach

API version 2026-08-02-preview adds
storageProfile.diskCSIDriver.quickAttachDetach.enabled, which turns on Quick Attach Detach for the AzureDisk CSI driver.

enable-quick-attach-detach (preview) sets the nested property and also sets diskCSIDriver.enabled=true, since QAD requires the disk driver. It is rejected client-side together with --disable-disk-driver.

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

Related command

az aks create --enable-quick-attach-detach

General Guidelines

  • Have you run azdev style <YOUR_EXT> locally? (pip install azdev required)
  • Have you run python scripts/ci/test_index.py -q locally? (pip install azdev required)
  • My extension version conforms to the Extension version schema

For new extensions:

About Extension Publish

There is a pipeline to automatically build, upload and publish extension wheels.
Once your pull request is merged into main branch, a new pull request will be created to update src/index.json automatically.
You only need to update the version information in file setup.py and historical information in file HISTORY.rst in your PR but do not modify src/index.json.

API version 2026-08-02-preview adds
storageProfile.diskCSIDriver.quickAttachDetach.enabled, which turns on
Quick Attach Detach for the AzureDisk CSI driver. The SDK bump in Azure#10491
picked up the model; this exposes it on create.

--enable-quick-attach-detach (preview) sets the nested property and also
sets diskCSIDriver.enabled=true, since QAD requires the disk driver. It is
rejected client-side together with --disable-disk-driver. Kubernetes
version, OIDC issuer and Windows pool requirements are left to the RP,
which returns specific errors for each.
Copilot AI balanced review requested due to automatic review settings October 21, 2026 23:48
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟢 Approval recommended

Static review found no blocking issues in the focused command wiring, validation, or profile construction, with targeted unit coverage added but not executed.

No open issues 🎉

What changed in this PR

Adds the preview --enable-quick-attach-detach option to az aks create, exposing the AzureDisk CSI Driver feature through the AKS extension.

Changes:

  • Enables Quick Attach Detach and the disk driver together, rejecting use with --disable-disk-driver.
  • Adds unit coverage for defaults, enablement, and conflicting options.
  • Documents feature requirements and adds the option-length lint exclusion.
File Description
src/​aks-preview/​linter_exclusions.yml Allows the new option’s length.
src/​aks-preview/​HISTORY.rst Records the new preview option.
src/​aks-preview/​azext_aks_preview/​tests/​latest/​test_managed_cluster_decorator.py Tests enablement, defaults, and conflict validation.
src/​aks-preview/​azext_aks_preview/​managed_cluster_decorator.py Validates the option and builds the nested storage profile.
src/​aks-preview/​azext_aks_preview/​custom.py Adds the option to the create command signature.
src/​aks-preview/​azext_aks_preview/​_params.py Registers the preview CLI flag.
src/​aks-preview/​azext_aks_preview/​_help.py Describes the feature and its requirements.

Review effort: Balanced

@x-engineering-agent

Copy link
Copy Markdown

Hi Jenniferyingni,
Please write the description of changes which can be perceived by customers into HISTORY.rst.
If you want to release a new extension version, please update the version in pyproject.toml (or setup.py, if the extension has not migrated yet) as well.

@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 2 pipeline(s).

@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 2 pipeline(s).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants