Skip to content

feat(coder/templates): add image variable to docker and kubernetes templates#943

Open
bpmct wants to merge 1 commit into
mainfrom
ben/devrel-201-add-an-image-and-runtime-to-variable-to-all-image-based
Open

feat(coder/templates): add image variable to docker and kubernetes templates#943
bpmct wants to merge 1 commit into
mainfrom
ben/devrel-201-add-an-image-and-runtime-to-variable-to-all-image-based

Conversation

@bpmct

@bpmct bpmct commented Jul 6, 2026

Copy link
Copy Markdown
Member

Adds a plain-text image variable to the Docker and Kubernetes templates so admins can pick the workspace image without editing Terraform. Both default to codercom/example-base:ubuntu.

Also adds a "Workspace image" section to each template's prerequisites explaining why image choice matters, with tradeoffs between example-base (minimal) and example-universal (catch-all), plus pointers to coder/images and the image management docs.

Companion to coder/coder#27018, which does the same for the template builder bases and expands the image management docs.

Part of DEVREL-201.

🤖 Generated with Coder Agents using Claude, on behalf of @bpmct

@linear-code

linear-code Bot commented Jul 6, 2026

Copy link
Copy Markdown

DEVREL-201

bpmct added a commit to coder/coder that referenced this pull request Jul 6, 2026
…27018)

Makes it easier to pick the right workspace image, both in the template
builder and in the docs.

- Template builder: the Docker and Kubernetes bases now expose a
`container_image` variable in the wizard (freeform text, defaults to
`codercom/example-base:ubuntu`), and their prerequisites explain why
image choice matters, with tradeoffs between
`codercom/example-base:ubuntu` (minimal) and
`codercom/example-universal:ubuntu` (catch-all), plus pointers to
[coder/images](https://github.com/coder/images) and the image management
docs.
- Docs: reworked [image
management](https://coder.com/docs/@ben%2Fdevrel-201-image-guidance-prereqs/admin/templates/managing-templates/image-management)
into a clearer maturity ladder (minimal → golden → project-specific →
developer customization), with pullable image references in every
example, `codercom/oss-dogfood` as a project-specific example, and Dev
Containers + [mise](https://mise.jdx.dev/) as ways to customize without
new images.

Companion PR for the starter templates: coder/registry#943

Part of DEVREL-201.

🤖 Generated with Coder Agents using Claude, on behalf of @bpmct (wizard
variable by @jeremyruppel in #27024)

---------

Co-authored-by: Jeremy Ruppel <jeremyruppel@users.noreply.github.com>
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.

1 participant