Skip to content

[SSH] Make --environment-version flag public - #7310

Merged
rclarey merged 7 commits into
mainfrom
ssh-environment-version-flag-public
Nov 3, 2026
Merged

rclarey merged 7 commits into
mainfrom
ssh-environment-version-flag-public

Conversation

@rclarey

@rclarey rclarey commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

Changes

  • ssh connect --environment-version now shows in help, with a description that is no longer AI-Runtime-only, and with an example.
  • Environment version is folded into the default connection name, as --base-environment already is. So two ssh connect commands with different environment versions start two different servers.
    • The default environment version is also folded into the connection name, so when the default version is bumped a running server on the old version is not reused
  • The flag is rejected together with --cluster, matching --base-environment and --usage-policy-id.

Why

CPU serverless environments 5 and 6 now work with the tunnel wherever the REPL sandbox's port forwarding is enabled. Users need a supported opt-in before the default moves off 4 once the rollout finishes. The IDE path already picks up the flag: ssh connect --ide vscode --environment-version 5 carries it in the generated ProxyCommand. ssh setup is dedicated-only, so it gets no flag.

Before this change the flag was hidden and ignored with --cluster, so rejecting that pair can only affect a hand-written invocation that never had any effect.

Tests

  • Unit tests cover the new validation and the connection-name hashing
  • go test ./acceptance -run TestAccept/ssh passes.
  • With a local build I checked the --help output and the --cluster rejection.

anton-107 and others added 3 commits October 30, 2026 15:35
Serverless environment versions 5 and 6 now work with the tunnel in the
regions where the driver's sandbox port forwarding is enabled, so users
need a supported way to opt in before the default moves off 4.

Make the flag visible, and close the two gaps a public flag would expose:

- Fold an explicit version into the default connection name, the same
  way --base-environment already is. Otherwise `ssh connect` followed by
  `ssh connect --environment-version 5` reuses the running version 4
  server.
- Reject the flag together with --cluster instead of silently ignoring it,
  matching --base-environment and --usage-policy-id.

Co-authored-by: Isaac <no-reply@databricks.com>
Co-authored-by: Isaac <no-reply@databricks.com>
@rclarey
rclarey requested review from a team as code owners November 3, 2026 12:27
@rclarey
rclarey requested review from anton-107, lennartkats-db and louis-johnston-db and removed request for louis-johnston-db November 3, 2026 12:27
@rclarey rclarey changed the title Ssh environment version flag public [SSH] Make --environment-version flag public Nov 3, 2026
@eng-dev-ecosystem-bot

eng-dev-ecosystem-bot commented Nov 3, 2026 •

Copy link
Copy Markdown
Collaborator

Integration test report

Commit: 6486b06

Run: 41649286660

Env 🔄​flaky ✅​pass 🙈​skip Time
✅​ aws linux-2core-8gb 271 15 10:29
🔄​ aws-windows-latest-4core-16gb 1 272 13 7:31
✅​ azure linux-2core-8gb 270 15 10:07
✅​ azure-windows-latest-4core-16gb 272 13 7:12
✅​ gcp linux-2core-8gb 271 15 9:09
✅​ gcp-windows-latest-4core-16gb 273 13 7:25
Test Name aws-windows-latest-4core-16gb
🔄​ TestSyncIncrementalSyncPythonNotebookDelete 🔄​f
Top 10 slowest tests (at least 2 minutes):
duration env testname
7:19 gcp-windows-latest-4core-16gb TestAccept
7:10 aws-windows-latest-4core-16gb TestAccept
7:05 azure-windows-latest-4core-16gb TestAccept
4:24 gcp linux-2core-8gb TestAccept
4:08 aws linux-2core-8gb TestAccept
4:07 azure linux-2core-8gb TestAccept
3:25 gcp linux-2core-8gb TestFilerWorkspaceFilesExtensionsReadDir
2:10 aws linux-2core-8gb TestFilerWorkspaceFilesExtensionsReadDir
2:07 aws-windows-latest-4core-16gb TestImportDir
2:07 gcp-windows-latest-4core-16gb TestSyncFullFileSync

@rclarey
rclarey requested a review from anton-107 November 3, 2026 12:53

@anton-107 anton-107 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.

The changelog now covers the default-name change and the cleanup of the old secret scope and local files. LGTM.

@rclarey
rclarey added this pull request to the merge queue Nov 3, 2026
Merged via the queue into main with commit f9a6aa4 Nov 3, 2026
31 checks passed
@rclarey
rclarey deleted the ssh-environment-version-flag-public branch November 3, 2026 15:27
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