fix!: use devcontainer ID when rebuilding a devcontainer #18604
Conversation
This PR replaces the use of the **container** ID with the **devcontainer** ID. This is a breaking change. This allows rebuilding a devcontainer when there is no valid container ID.
There was a problem hiding this comment.
Pull Request Overview
This PR changes API endpoints and internal references to use the devcontainer ID rather than the container ID. Key changes include updating URL paths, parameter names, and related error messages in both the API and its documentation.
Reviewed Changes
Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| site/src/modules/resources/AgentDevcontainerCard.tsx | Updated the endpoint URL to use devcontainer.id |
| docs/reference/api/agents.md | Updated the API documentation and parameter names |
| codersdk/workspacesdk/agentconn.go | Changed function signature and URL path for recreating devcontainers |
| codersdk/workspaceagents.go | Refactored the workspace agent recreate method to use devcontainerID |
| coderd/workspaceagents_test.go | Updated tests to align with the new devcontainer ID usage |
| coderd/workspaceagents.go, coderd/coderd.go, coderd/apidoc/swagger.json, coderd/apidoc/docs.go | Modified routing, error messages, and API docs for consistency |
| agent/agentcontainers/api_test.go, agent/agentcontainers/api.go | Adjusted API routes and tests to reflect the devcontainer changes |
agent/agentcontainers/api.go
Outdated
| return | ||
| var workspaceFolder string | ||
| for _, dc := range api.knownDevcontainers { | ||
| if dc.ID.String() == devcontainerID { |
There was a problem hiding this comment.
Consider refactoring the 'knownDevcontainers' map to be keyed by the devcontainer ID instead of the workspaceFolder. This change can improve lookup clarity and avoid potential key collisions when multiple devcontainers share the same workspace folder.
Copilot uses AI. Check for mistakes.
| if dc.ID.String() == devcontainerID { | ||
| workspaceFolder = dc.WorkspaceFolder | ||
| break | ||
| } |
There was a problem hiding this comment.
Suggestion: This could be simplified by storing dc from the for-loop rather than doing two lookups first ID then workspace folder (which we already know).
| @@ -494,8 +494,8 @@ func (api *API) Routes() http.Handler { | |||
| r.Get("/", api.handleList) | |||
| // TODO(mafredri): Simplify this route as the previous /devcontainers | |||
| // /-route was dropped. We can drop the /devcontainers prefix here too. | |||
| r.Route("/devcontainers", func(r chi.Router) { | |||
| r.Post("/container/{container}/recreate", api.handleDevcontainerRecreate) | |||
| r.Route("/devcontainers/{devcontainer}", func(r chi.Router) { | |||
There was a problem hiding this comment.
This dawned on me just now, but we could take workspaceFolder here instead, which will allow starting any non-started devcontainer even if it doesn't exist. 😅 We can table this for now though as implementing it would be preemptive and more thought behind it would be good.
There was a problem hiding this comment.
Oooh that could be good to add in the future.
| @@ -626,7 +638,7 @@ func TestAPI(t *testing.T) { | |||
|
|
|||
| for i := range tt.wantStatus { | |||
| // Simulate HTTP request to the recreate endpoint. | |||
| req := httptest.NewRequest(http.MethodPost, "/devcontainers/container/"+tt.containerID+"/recreate", nil). | |||
| req := httptest.NewRequest(http.MethodPost, "/devcontainers/"+tt.devcontainerID+"/recreate", nil). | |||
There was a problem hiding this comment.
This is a much more sensible URL 😍
This PR replaces the use of the container ID with the devcontainer ID. This is a breaking change. This allows rebuilding a devcontainer when there is no valid container ID.