Workspaces as code (WAC) allows you to define and create new workspaces using workspace templates.
Workspace templates are written as YAML and have a
Coder looks for your workspace template at the following path:
The following is a sample workspace template that makes use of all available fields. Depending on your use case, you may not need all of the options available.
Note that the fields are case-sensitive.
For detailed information on the fields available, see the subsequent sections of this article
version: 0.2 workspace: type: kubernetes spec: image: index.docker.io/ubuntu:18.04 container-based-vm: true cpu: 4 memory: 16 disk: 128 gpu-count: 1 labels: com.coder.custom.hello: "hello" com.coder.custom.world: "world" configure: start: - name: "install curl" command: | apt update apt install -y curl - name: "install Go binary" command: "go install" directory: /home/coder/go/src/github.com/my-project shell: "bash" env: GOPATH: /home/coder/go devURLs: - name: MyWebsite port: 3000 scheme: http access: private - name: PublicPort port: 8080 scheme: https access: public - name: OrgWebsite port: 3001 scheme: http access: org - name: AuthedSite port: 8081 scheme: https access: authed
The version number of the config file being used. The current version is
Required. The section containing all configuration information related to the workspace.
Required. Determines the type of workspace to be created. Currently, the
only accepted value is
Required. This section contains configuration information specific to the
Required. The image to use for the workspace. The image should include the
registry and (optionally) the tag, i.e.
docker.io/ubuntu:18.04. If you omit
the tag, Coder uses the default value of
You must have imported the image into Coder, otherwise, the workspace will fail to build.
The Kubernetes labels to be added to the workspace pod.
workspace: labels: com.coder.custom.hello: hello com.coder.custom.world: world
The number of GPUs to allocate to the workspace.
Determines whether the workspace should be created as a
container-based virtual machine (CVM). Default is
Required. The number of cores to allocate to the workspace.
Required. The amount of memory (in GB) to allocate to the workspace.
Required. The amount of disk space (in GB) to allocate to the workspace.
This section lists the commands that run within the workspace after Coder builds the workspace. See Configure for more information.
The list of commands to run when Coder starts a workspace.
Required. Runs the provided command within the workspace (Coder supports the use of both single-line and multi-line commands).
- name: Install curl command: apt install -y curl
- name: Update and install curl command: | apt update apt install -y curl
The name of the command being run.
The shell Coder should use to run the command.
start: - name: First step shell: /bin/bash
The working directory from which Coder should run the command.
start: - name: First step directory: /home/coder
The map of environment variables to set for the command.
start: - name: First step env: HOME: /home/coder GOPATH: /home/coder/go
This list allows you to provision dev URLs using the workspaces as code configuration file. The dev URLs will be provisioned in addition to any dev URLs you create.
devURLs: - name: PublicPort port: 8080 scheme: https access: public
The name of the dev URL to be created.
The workspace port that the dev URL exposes.
The URL scheme (protocol) to use (i.e.,
The permission level of the dev URL: