Files
coder/examples/templates/docker-with-dotfiles
Cian Johnston 2c0d57e8c0 fix: update reference to agent.dev in examples and docs (#3198)
* fix: update agent ID in example templates
* fix: update agent ID in dogfood template
* chore: update default agent ID in documentation
* fix: develop.sh: start FE after template is created; leave template dir around if template creation fails
2022-07-26 14:09:09 +01:00
..

name, description, tags
name description tags
Develop in Docker with a dotfiles URL Run workspaces on a Docker host using registry images
local
docker

docker-with-dotfiles

This is an example for deploying workspaces with a prompt for the users' dotfiles repo URI.

Getting started

Run coder templates init and select this template. Follow the instructions that appear.

How it works

During workspace creation, Coder prompts you to specify a dotfiles URL via a Terraform variable. Once the workspace starts, the Coder agent runs coder dotfiles via the startup script:

variable "dotfiles_uri" {
  description = <<-EOF
  Dotfiles repo URI (optional)

  see https://dotfiles.github.io
  EOF
    # The codercom/enterprise-* images are only built for amd64
  default = ""
}

resource "coder_agent" "main" {
  ...
  startup_script = var.dotfiles_uri != "" ? "/tmp/tmp.coder*/coder dotfiles -y ${var.dotfiles_uri}" : null
}

Managing images and workspaces

Refer to the documentation in the Docker template.