Skip to content

fix: declare ssh extension 2.0.9 minCliCoreVersion 2.71.0 and bump version#10107

Open
mvanhorn wants to merge 1 commit into
Azure:mainfrom
mvanhorn:fix/10061-ssh-mincli-version
Open

fix: declare ssh extension 2.0.9 minCliCoreVersion 2.71.0 and bump version#10107
mvanhorn wants to merge 1 commit into
Azure:mainfrom
mvanhorn:fix/10061-ssh-mincli-version

Conversation

@mvanhorn

Copy link
Copy Markdown

Fixes #10061

The ssh extension 2.0.9 migrated its compute (VM) code from the Azure SDK to AAZ-based commands (#9778), which import azure.cli.command_modules.vm.operations.vm.VMShow. That module path only exists in azure-cli core >= 2.71.0. However src/ssh/azext_ssh/azext_metadata.json still declared azext.minCliCoreVersion as 2.45.0, so the extension compatibility resolver kept offering the 2.0.9 build to users on pinned azure-cli cores older than 2.71.0. On those cores az ssh vm crashes with ModuleNotFoundError: No module named 'azure.cli.command_modules.vm.operations'.

This change raises azext.minCliCoreVersion to 2.71.0 so the resolver stops offering the AAZ-based build to incompatible cores and instead installs the last compatible version (2.0.8) there. The metadata must ship under a new version for az extension list-versions to re-evaluate compatibility, so setup.py VERSION is bumped to 2.0.10 with a matching HISTORY.md entry. This is the maintainer-stated expected behavior in the issue; there is no runtime code change, only the extension's declared minimum core version.

Related command

az ssh vm

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

This PR only updates the version information in setup.py and the historical information in HISTORY.md; src/index.json is left unchanged for the publish pipeline to update automatically after merge.

ssh 2.0.9 migrated its compute (VM) code to AAZ-based commands, which
import azure.cli.command_modules.vm.operations.vm.VMShow, only present in
azure-cli core >= 2.71.0. The extension metadata still declared
minCliCoreVersion 2.45.0, so the compatibility resolver offered the 2.0.9
build to older cores where `az ssh vm` crashes with ModuleNotFoundError.

Raise azext.minCliCoreVersion to 2.71.0 and ship it under a new version
(2.0.10) so `az extension list-versions` re-evaluates compatibility and
installs the last compatible build (2.0.8) on cores older than 2.71.0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QXwvFKU1BuKiw1hKwr8fwC
Copilot AI review requested due to automatic review settings July 14, 2026 06:16
@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 @mvanhorn,
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.

@azure-pipelines

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

@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 Jul 14, 2026
@microsoft-github-policy-service

Copy link
Copy Markdown
Contributor

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

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.

Pull request overview

This PR updates the ssh extension’s declared minimum compatible Azure CLI core version to prevent users on older pinned azure-cli cores from installing an incompatible ssh extension build (per issue #10061). It also bumps the extension version and records the change in release history so compatibility can be re-evaluated by the extension resolver.

Changes:

  • Raise azext.minCliCoreVersion from 2.45.0 to 2.71.0 in extension metadata.
  • Bump extension version from 2.0.9 to 2.0.10.
  • Add a 2.0.10 entry to HISTORY.md documenting the compatibility change.

Reviewed changes

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

File Description
src/ssh/azext_ssh/azext_metadata.json Raises minimum Azure CLI core version to 2.71.0 to avoid installing incompatible builds on older cores.
src/ssh/setup.py Bumps extension package version to 2.0.10 to ensure compatibility metadata is re-evaluated.
src/ssh/HISTORY.md Documents the 2.0.10 release and the min core version change.

@yonzhan
yonzhan requested a review from isra-fel July 14, 2026 06:22
@yonzhan

yonzhan commented Jul 14, 2026

Copy link
Copy Markdown
Collaborator

ssh

@yonzhan
yonzhan requested a review from yanzhudd July 14, 2026 06:23
@yonzhan
yonzhan removed request for isra-fel and yonzhan July 14, 2026 06:24
@Klaas-

Klaas- commented Jul 16, 2026

Copy link
Copy Markdown

don't merge this without first fixing the warning message please -- #9937

@mvanhorn

Copy link
Copy Markdown
Author

Good flag, and there's no file overlap: #9937 removes the stale <2.0.4 breaking-change registrations in _breaking_change.py, while this PR only touches azext_metadata.json (minCliCoreVersion), setup.py, and HISTORY.md for the version bump. They're independent, but I agree it's cleaner to land the warning cleanup so the bumped 2.0.10 doesn't ship the outdated May-2025 <2.0.4 warnings. I'm happy to sequence behind #9937, or to fold the _breaking_change.py cleanup into this bump and ship it as one version, whichever the ssh reviewers prefer on ordering.

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. VM SSH

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ssh-2.0.9 breaks backwards compatibility with older Azure CLI versions < 2.71.0

5 participants