Skip to content

[vm-repair] Update --distro help text to list all supported distros#9899

Open
msaenzbosupport wants to merge 2 commits into
Azure:mainfrom
msaenzbosupport:fix/vm-repair-update-distro-help-text
Open

[vm-repair] Update --distro help text to list all supported distros#9899
msaenzbosupport wants to merge 2 commits into
Azure:mainfrom
msaenzbosupport:fix/vm-repair-update-distro-help-text

Conversation

@msaenzbosupport
Copy link
Copy Markdown

Description

The --distro parameter help text in _params.py and the example in _help.py only listed a subset of the actually supported distros:

  • Old list: rhel7|rhel8|sles12|sles15|ubuntu20|centos7|centos8|oracle7

However, the code in repair_utils.py (functions _select_distro_linux, _select_distro_linux_gen2, and _select_distro_linux_Arm64) supports many more:

  • Full list: rhel7|rhel8|rhel9|rhel10|ubuntu20|ubuntu22|ubuntu24|centos6|centos7|centos8|oracle7|oracle8|oracle9|oracle10|sles12|sles15

Changes

  • _params.py: Updated the --distro argument help string to include all supported distros and documented that a custom URN (Publisher:Offer:Sku:Version) is also accepted.
  • _help.py: Updated the example command to show all available distro keywords.

Testing

Documentation-only change. No functional code modified.

The --distro parameter help text and example only listed a subset of the
actually supported distros (rhel7|rhel8|sles12|sles15|ubuntu20|centos7|centos8|oracle7).

Updated both _params.py and _help.py to include all distros currently
supported in the code (repair_utils.py):
- Added: rhel9, rhel10, ubuntu22, ubuntu24, centos6, oracle7, oracle8,
  oracle9, oracle10
- Also documented that a custom URN (Publisher:Offer:Sku:Version) is accepted
Copilot AI review requested due to automatic review settings May 25, 2026 22:53
@azure-client-tools-bot-prd
Copy link
Copy Markdown

Validation for Breaking Change Starting...

Thanks for your contribution!

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

Hi @msaenzbosupport,
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 setup.py as well.

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

Note

Copilot was unable to run its full agentic suite in this review.

Updates the --distro argument help and examples for az vm repair create to reflect additional distro options and clarify that a custom URN is supported.

Changes:

  • Expanded the documented list of supported distros for --distro.
  • Added documentation that a custom URN can be provided for --distro.
  • Updated CLI help example to include the expanded distro list.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
src/vm-repair/azext_vm_repair/_params.py Expands --distro help text and documents custom URN input format.
src/vm-repair/azext_vm_repair/_help.py Updates the example command to reflect the expanded --distro options.

c.argument('enable_nested', help='enable nested hyperv.')
c.argument('associate_public_ip', help='Option to create a repair vm with a public ip. If this parameter is not used, only a private ip will be made.')
c.argument('distro', help='Option to create repair vm from a specific linux distro (rhel7|rhel8|sles12|sles15|ubuntu20|centos7|centos8|oracle7)')
c.argument('distro', help='Option to create repair vm from a specific linux distro (rhel7|rhel8|rhel9|rhel10|ubuntu20|ubuntu22|ubuntu24|centos6|centos7|centos8|oracle7|oracle8|oracle9|oracle10|sles12|sles15). A custom URN can also be provided in the format Publisher:Offer:Sku:Version.')
Comment thread src/vm-repair/azext_vm_repair/_help.py Outdated
- name: Create a repair VM of a specific distro or a specific URN could also be provided
text: >
az vm repair create -g MyResourceGroup -n myVM --distro 'rhel7|sles12|ubuntu20|centos6|oracle8|sles15'
az vm repair create -g MyResourceGroup -n myVM --distro 'rhel7|rhel8|rhel9|rhel10|ubuntu20|ubuntu22|ubuntu24|centos6|centos7|centos8|oracle7|oracle8|oracle9|oracle10|sles12|sles15'
@yonzhan yonzhan removed the request for review from zhoxing-ms May 25, 2026 23:15
@yonzhan
Copy link
Copy Markdown
Collaborator

yonzhan commented May 25, 2026

vm-repair

… fix examples

- Added HISTORY.rst entry for version 2.2.1
- Bumped version in setup.py from 2.2.0 to 2.2.1
- Split distro example into two: one with a concrete distro keyword (rhel9),
  and another showing custom URN format (Publisher:Offer:Sku:Version)
- Addresses Copilot review comment about pipe-delimited example being misleading
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.

4 participants