GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — feat: allow template version selection for workspace builds by dylanhuff-at-coder · Pull Request #30199 · coder/coder

Conversation

@dylanhuff-at-coder

@dylanhuff-at-coder dylanhuff-at-coder commented Sep 30, 2026

Copy link
Copy Markdown
Contributor

Add named template version selection to coder start and coder stop, and independent stop/start selection to coder update with --stop-template-version and --template-version. Stop still defaults to the workspace's current version, and update starts with the active version by default. Explicit selections use the selected version for parameter preparation and builds, keep server permissions authoritative, and never silently fall back to the active version.

Classic stop builds retain previous parameter values omitted by the selected stop version, so a later start can reuse them across separate commands or an interrupted update. Declared parameters still follow normal validation, and start builds still discard removed parameters. Update now returns an error and retry guidance when a start apply fails after stopping, including unflagged updates that previously returned success.

Closes #29100

PLAT-616

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
@dylanhuff-at-coder
feat: allow template version selection for workspace builds
eaf830f
@linear-code

linear-code Bot commented Sep 30, 2026

Copy link
Copy Markdown

PLAT-616
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@github-actions github-actions Bot assigned dylanhuff-at-coder Sep 30, 2026
@dylanhuff-at-coder
chore: merge main and resolve update conflicts
ac12d55
@dylanhuff-at-coder
dylanhuff-at-coder marked this pull request as ready for review October 2, 2026 14:42
@coderagents

coderagents Bot commented Oct 2, 2026 •
edited by dylanhuff-at-coder
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Contributor

Documentation Check

Updates Needed

  • docs/user-guides/workspace-management.md (open) - The "Update with the CLI" section documents coder update <workspace-name> and coder update -y, but not the new --template-version and --stop-template-version flags that let a user start or stop a workspace on a specific named template version. These are user-facing CLI flags visible in --help, and the auto-generated docs/reference/cli/*.md pages the PR regenerated do not close the gap in this conceptual guide that explains the update/start/stop flow.

Automated review via Coder Agents
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@dylanhuff-at-coder
dylanhuff-at-coder requested review from a team and geokat October 2, 2026 16:54
geokat
geokat approved these changes Oct 2, 2026
View reviewed changes

@geokat geokat left a comment

Copy link
Copy Markdown
Contributor

There was a problem hiding this comment.

Choose a reason for hiding this comment

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

lgtm 👍

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
Comment thread cli/start.go Resolved

Uh oh!

There was an error while loading. Please reload this page.
Comment thread cli/update.go Resolved

Uh oh!

There was an error while loading. Please reload this page.
Comment thread cli/update.go Resolved

Uh oh!

There was an error while loading. Please reload this page.
Comment thread coderd/wsbuilder/wsbuilder.go Resolved

Uh oh!

There was an error while loading. Please reload this page.
Comment thread cli/update.go Resolved

Uh oh!

There was an error while loading. Please reload this page.
@dylanhuff-at-coder
fix: address review feedback on template version builds
aab112a 
- Preserve omitted classic parameters on delete builds, not just stop.
- Stop update from starting a stopped workspace when only
  --stop-template-version is passed. On a cleanly stopped workspace with
  other update work, warn and ignore the flag. Otherwise error, since
  there is nothing for update to stop.
- Name the actual target version in the update confirmation prompt.
- Quote 'coder start' in update retry guidance.
- Share the template version name lookup with coder create.
- Document the new flags in the workspace management guide.
@dylanhuff-at-coder
dylanhuff-at-coder requested a review from nickvigilante as a code owner October 7, 2026 16:12
@github-actions

github-actions Bot commented Oct 7, 2026 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Contributor

Docs preview

Check off each page once it's been reviewed. If a page changes in a later push, its checkbox clears automatically so it gets a fresh look. Pages not yet wired into the docs navigation aren't listed here.

  • docs/user-guides/workspace-management.md
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@dylanhuff-at-coder

dylanhuff-at-coder commented Oct 7, 2026

Copy link
Copy Markdown
Contributor Author

Added a short section on the new flags to the workspace management guide
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
nickvigilante
nickvigilante reviewed Oct 7, 2026
View reviewed changes

@nickvigilante nickvigilante left a comment

Copy link
Copy Markdown
Contributor

There was a problem hiding this comment.

Choose a reason for hiding this comment

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

Some docs styling nits, but otherwise, docs LGTM!

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
dylanhuff-at-coder reacted with thumbs up emoji
All reactions
  • 👍 1 reaction
Comment thread docs/user-guides/workspace-management.md Resolved

Uh oh!

There was an error while loading. Please reload this page.
Comment thread docs/user-guides/workspace-management.md Resolved

Uh oh!

There was an error while loading. Please reload this page.
dylanhuff-at-coder and others added 2 commits October 7, 2026 09:19
@dylanhuff-at-coder @nickvigilante
Update docs/user-guides/workspace-management.md
adfa005 
Co-authored-by: Nick Vigilante <[email protected]>
@dylanhuff-at-coder @nickvigilante
Update docs/user-guides/workspace-management.md
154eaf2 
Co-authored-by: Nick Vigilante <[email protected]>
@dylanhuff-at-coder
dylanhuff-at-coder merged commit b4d5101 into main Oct 7, 2026
32 checks passed

Uh oh!

There was an error while loading. Please reload this page.
@dylanhuff-at-coder
dylanhuff-at-coder deleted the feat/plat-616-template-version-builds branch October 7, 2026 20:17
@github-actions github-actions Bot locked and limited conversation to collaborators Oct 7, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

@nickvigilante nickvigilante nickvigilante left review comments
@geokat geokat geokat approved these changes

Uh oh!

There was an error while loading. Please reload this page.

Assignees

@dylanhuff-at-coder dylanhuff-at-coder

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

CLI: allow specifying a template version for stop/start builds and both legs of coder update

Uh oh!

There was an error while loading. Please reload this page.

3 participants

@dylanhuff-at-coder @geokat @nickvigilante
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.