opensource/coder
3
0
Fork 0
mirror of https://github.com/coder/coder.git synced 2026-09-24 15:04:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

feat: add workspace restart functionality to API (#25757)

Browse Source 
This models restart as durable orchestration of existing stop and
start workspace builds instead of adding a new restart transition.
Keeping restart as two existing transitions preserves the current
build/provisioner model.

The child start build is created only after the parent stop build
succeeds, rather than being inserted immediately in a pending
state. That keeps `workspace_builds` aligned with actual
provisioner-ready work and avoids introducing a second
pending-build lifecycle that the provisioner and build acquisition
paths would need to understand.

Refs: https://linear.app/codercom/issue/PLAT-143
This commit is contained in:
George K
2026-07-07 09:18:30 -07:00
committed by GitHub
parent ba094c5706
commit 6af0f4d698
45 changed files with 4412 additions and 144 deletions
Download Patch File Download Diff File Expand all files Collapse all files
codersdk/workspaces.go
+28
View File
@@ -136,6 +136,34 @@ type CreateWorkspaceBuildRequest struct {
TemplateVersionPresetID uuid.UUID `json:"template_version_preset_id,omitempty" format:"uuid"`
// Reason sets the reason for the workspace build.
Reason CreateWorkspaceBuildReason `json:"reason,omitempty" validate:"omitempty,oneof=dashboard cli ssh_connection vscode_connection jetbrains_connection task_manual_pause"`
// OnSuccess queues a follow-up workspace build after this build succeeds.
// It currently supports restarting a workspace by starting it after a
// successful stop build.
OnSuccess *CreateWorkspaceBuildOnSuccessRequest `json:"on_success,omitempty"`
}
// CreateWorkspaceBuildOnSuccessRequest queues a follow-up build that
// runs after the parent build succeeds. It currently supports
// restarting a workspace: the parent build must be a "stop" and this
// child build a "start". The child build inherits LogLevel and Reason
// from the parent CreateWorkspaceBuildRequest.
type CreateWorkspaceBuildOnSuccessRequest struct {
// TemplateVersionID pins the child build to a specific template
// version. Pinning requires permission to update the template,
// since the active version may change before the child build
// runs. When empty, the child build uses the template's active
// version at the time it runs.
TemplateVersionID uuid.UUID `json:"template_version_id,omitempty" format:"uuid"`
// Transition must be "start". The parent build's transition must
// be "stop".
Transition WorkspaceTransition `json:"transition" validate:"oneof=start,required"`
// RichParameterValues are applied to the child build. Parameters
// not listed here fall back to their values from the previous
// build, matching normal build behavior.
RichParameterValues []WorkspaceBuildParameter `json:"rich_parameter_values,omitempty"`
// TemplateVersionPresetID selects a preset for the child build.
// It requires TemplateVersionID to also be set.
TemplateVersionPresetID uuid.UUID `json:"template_version_preset_id,omitempty" format:"uuid"`
}
type WorkspaceOptions struct {