From ff71e8320d0e2b998e27b7781b3f13beddb6dfe0 Mon Sep 17 00:00:00 2001
From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
Date: Wed, 16 Oct 2024 05:03:24 +0000
Subject: [PATCH 01/16] update template main.tf
---
docs/tutorials/template-from-scratch.md | 64 ++++++++++---------------
1 file changed, 24 insertions(+), 40 deletions(-)
diff --git a/docs/tutorials/template-from-scratch.md b/docs/tutorials/template-from-scratch.md
index c1a9b556fdae2..6909d54ac14ce 100644
--- a/docs/tutorials/template-from-scratch.md
+++ b/docs/tutorials/template-from-scratch.md
@@ -14,18 +14,13 @@ To follow this guide, you'll need:
[Docker](https://docs.docker.com/get-docker/) and [Coder](../install/index.md)
installed on it.
-> When setting up your computer or computing instance, make sure to install
-> Docker first, then Coder. Otherwise, you'll need to add the `coder` user to
-> the `docker` group.
+ - When setting up your computer or computing instance, make sure to install Docker first, then Coder. Otherwise, you'll need to add the `coder` user to the `docker` group.
- The URL for your Coder instance. If you're running Coder locally, the default
URL is [http://127.0.0.1:3000](http://127.0.0.1:3000).
- A text editor. For this tour, we use [GNU nano](https://nano-editor.org/).
-> Haven't written Terraform before? Check out Hashicorp's
-> [Getting Started Guides](https://developer.hashicorp.com/terraform/tutorials).
-
## What's in a template
The main part of a Coder template is a [Terraform](https://terraform.io) `tf`
@@ -36,6 +31,9 @@ Coder can provision all Terraform modules, resources, and properties. The Coder
server essentially runs a `terraform apply` every time a workspace is created,
started, or stopped.
+> Haven't written Terraform before? Check out Hashicorp's
+> [Getting Started Guides](https://developer.hashicorp.com/terraform/tutorials).
+
Here's a simplified diagram that shows the main parts of the template we'll
create.
@@ -47,10 +45,8 @@ On your local computer, create a directory for your template and create the
`Dockerfile`.
```sh
-mkdir template-tour
-cd template-tour
-mkdir build
-nano build/Dockerfile
+mkdir -p template-tour/build && cd $_
+nano Dockerfile
```
You'll enter a simple `Dockerfile` that starts with the
@@ -72,7 +68,6 @@ RUN useradd --groups sudo --no-create-home --shell /bin/bash ${USER} \
&& chmod 0440 /etc/sudoers.d/${USER}
USER ${USER}
WORKDIR /home/${USER}
-
```
Notice how `Dockerfile` adds a few things to the parent `ubuntu` image, which
@@ -83,7 +78,7 @@ your template needs later:
## 2. Set up template providers
-Now you can edit the Terraform file, which provisions the workspace's resources.
+Edit the Terraform file to provision the workspace's resources:
```shell
nano main.tf
@@ -97,31 +92,28 @@ terraform {
required_providers {
coder = {
source = "coder/coder"
- version = "~> 0.8.3"
}
docker = {
source = "kreuzwerker/docker"
- version = "~> 3.0.1"
}
}
}
-provider "coder" {
+locals {
+ username = data.coder_workspace_owner.me.name
}
-provider "docker" {
+data "coder_provisioner" "me" {
}
-locals {
- username = data.coder_workspace.me.owner
+provider "docker" {
}
-data "coder_provisioner" "me" {
+provider "coder" {
}
data "coder_workspace" "me" {
}
-
```
Notice that the `provider` blocks for `coder` and `docker` are empty. In a more
@@ -132,8 +124,7 @@ The
[`coder_workspace`](https://registry.terraform.io/providers/coder/coder/latest/docs/data-sources/workspace)
data source provides details about the state of a workspace, such as its name,
owner, and so on. The data source also lets us know when a workspace is being
-started or stopped. We'll take advantage of this information in later steps to
-do these things:
+started or stopped. We'll take advantage of this information in later steps to:
- Set some environment variables based on the workspace owner.
- Manage ephemeral and persistent storage.
@@ -150,26 +141,25 @@ You do not need to have any open ports on the compute aspect, but the agent
needs `curl` access to the Coder server. Remember that we installed `curl` in
`Dockerfile`, earlier.
-This snippet creates the agent:
+Add this snippet below the last closing `}` in `main.tf` to create the agent:
```tf
resource "coder_agent" "main" {
arch = data.coder_provisioner.me.arch
os = "linux"
- startup_script_timeout = 180
startup_script = <<-EOT
set -e
# install and start code-server
- curl -fsSL https://code-server.dev/install.sh | sh -s -- --method=standalone --prefix=/tmp/code-server --version 4.11.0
+ curl -fsSL https://code-server.dev/install.sh | sh -s -- --method=standalone --prefix=/tmp/code-server
/tmp/code-server/bin/code-server --auth none --port 13337 >/tmp/code-server.log 2>&1 &
EOT
env = {
- GIT_AUTHOR_NAME = "${data.coder_workspace.me.owner}"
- GIT_COMMITTER_NAME = "${data.coder_workspace.me.owner}"
- GIT_AUTHOR_EMAIL = "${data.coder_workspace.me.owner_email}"
- GIT_COMMITTER_EMAIL = "${data.coder_workspace.me.owner_email}"
+ GIT_AUTHOR_NAME = coalesce(data.coder_workspace_owner.me.full_name, data.coder_workspace_owner.me.name)
+ GIT_AUTHOR_EMAIL = "${data.coder_workspace_owner.me.email}"
+ GIT_COMMITTER_NAME = coalesce(data.coder_workspace_owner.me.full_name, data.coder_workspace_owner.me.name)
+ GIT_COMMITTER_EMAIL = "${data.coder_workspace_owner.me.email}"
}
metadata {
@@ -188,11 +178,10 @@ resource "coder_agent" "main" {
timeout = 1
}
}
-
```
Because Docker is running locally in the Coder server, there is no need to
-authenticate `coder_agent`. But if your `coder_agent` were running on a remote
+authenticate `coder_agent`. But if your `coder_agent` is running on a remote
host, your template would need
[authentication credentials](../admin/external-auth.md).
@@ -229,7 +218,7 @@ This is commonly used for
[web IDEs](../user-guides/workspace-access/web-ides.md) such as
[code-server](https://coder.com/docs/code-server), RStudio, and JupyterLab.
-To install and code-server in the workspace, remember that we installed it in
+To install code-server in the workspace, remember that we installed it in
the `startup_script` argument in `coder_agent`. We make it available from a
workspace with a `coder_app` resource. See
[web IDEs](../user-guides/workspace-access/web-ides.md) for more examples.
@@ -250,11 +239,10 @@ resource "coder_app" "code-server" {
threshold = 6
}
}
-
```
You can also use a `coder_app` resource to link to external apps, such as links
-to wikis or cloud consoles.
+to wikis or cloud consoles:
```tf
resource "coder_app" "coder-server-doc" {
@@ -264,7 +252,6 @@ resource "coder_app" "coder-server-doc" {
url = "https://coder.com/docs/code-server"
external = true
}
-
```
## 5. Persistent and ephemeral resources
@@ -296,7 +283,6 @@ resource "docker_volume" "home_volume" {
ignore_changes = all
}
}
-
```
For details, see
@@ -305,7 +291,7 @@ For details, see
## 6. Set up the Docker container
To set up our Docker container, our template has a `docker_image` resource that
-uses `build/Dockerfile`, which we created earlier.
+uses `build/Dockerfile`, which we created earlier:
```tf
resource "docker_image" "main" {
@@ -320,7 +306,6 @@ resource "docker_image" "main" {
dir_sha1 = sha1(join("", [for f in fileset(path.module, "build/*") : filesha1(f)]))
}
}
-
```
Our `docker_container` resource uses `coder_workspace` `start_count` to start
@@ -331,7 +316,7 @@ resource "docker_container" "workspace" {
count = data.coder_workspace.me.start_count
image = docker_image.main.name
# Uses lower() to avoid Docker restriction on container names.
- name = "coder-${data.coder_workspace.me.owner}-${lower(data.coder_workspace.me.name)}"
+ name = "coder-${data.coder_workspace_owner.me.name}-${lower(data.coder_workspace.me.name)}"
# Hostname makes the shell more user friendly: coder@my-workspace:~$
hostname = data.coder_workspace.me.name
# Use the docker gateway if the access URL is 127.0.0.1
@@ -349,7 +334,6 @@ resource "docker_container" "workspace" {
read_only = false
}
}
-
```
## 7. Create the template in Coder
From 3665adaf4c615ee868fc5a1fbbb68210bc071792 Mon Sep 17 00:00:00 2001
From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
Date: Wed, 16 Oct 2024 05:14:30 +0000
Subject: [PATCH 02/16] make fmt
---
docs/tutorials/template-from-scratch.md | 8 +++++---
1 file changed, 5 insertions(+), 3 deletions(-)
diff --git a/docs/tutorials/template-from-scratch.md b/docs/tutorials/template-from-scratch.md
index 6909d54ac14ce..2087327eb41b1 100644
--- a/docs/tutorials/template-from-scratch.md
+++ b/docs/tutorials/template-from-scratch.md
@@ -14,7 +14,9 @@ To follow this guide, you'll need:
[Docker](https://docs.docker.com/get-docker/) and [Coder](../install/index.md)
installed on it.
- - When setting up your computer or computing instance, make sure to install Docker first, then Coder. Otherwise, you'll need to add the `coder` user to the `docker` group.
+ - When setting up your computer or computing instance, make sure to install
+ Docker first, then Coder. Otherwise, you'll need to add the `coder` user to
+ the `docker` group.
- The URL for your Coder instance. If you're running Coder locally, the default
URL is [http://127.0.0.1:3000](http://127.0.0.1:3000).
@@ -218,8 +220,8 @@ This is commonly used for
[web IDEs](../user-guides/workspace-access/web-ides.md) such as
[code-server](https://coder.com/docs/code-server), RStudio, and JupyterLab.
-To install code-server in the workspace, remember that we installed it in
-the `startup_script` argument in `coder_agent`. We make it available from a
+To install code-server in the workspace, remember that we installed it in the
+`startup_script` argument in `coder_agent`. We make it available from a
workspace with a `coder_app` resource. See
[web IDEs](../user-guides/workspace-access/web-ides.md) for more examples.
From 3488bf269d48b34c216c08c06ca1bb341d80f669 Mon Sep 17 00:00:00 2001
From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
Date: Wed, 16 Oct 2024 05:16:12 +0000
Subject: [PATCH 03/16] add expand of full main.tf
---
docs/tutorials/template-from-scratch.md | 129 ++++++++++++++++++++++++
1 file changed, 129 insertions(+)
diff --git a/docs/tutorials/template-from-scratch.md b/docs/tutorials/template-from-scratch.md
index 2087327eb41b1..c182fc3d9bc73 100644
--- a/docs/tutorials/template-from-scratch.md
+++ b/docs/tutorials/template-from-scratch.md
@@ -338,6 +338,135 @@ resource "docker_container" "workspace" {
}
```
+
+Expand for the full `main.tf` file
+```tf
+terraform {
+ required_providers {
+ coder = {
+ source = "coder/coder"
+ }
+ docker = {
+ source = "kreuzwerker/docker"
+ }
+ }
+}
+
+locals {
+ username = data.coder_workspace_owner.me.name
+}
+
+data "coder_provisioner" "me" {
+}
+
+provider "docker" {
+}
+
+provider "coder" {
+}
+
+data "coder_workspace" "me" {
+}
+
+data "coder_workspace_owner" "me" {}
+
+resource "coder_agent" "main" {
+ arch = data.coder_provisioner.me.arch
+ os = "linux"
+ startup_script = <<-EOT
+ set -e
+
+ # install and start code-server
+ curl -fsSL https://code-server.dev/install.sh | sh -s -- --method=standalone --prefix=/tmp/code-server
+ /tmp/code-server/bin/code-server --auth none --port 13337 >/tmp/code-server.log 2>&1 &
+ EOT
+
+ env = {
+ GIT_AUTHOR_NAME = coalesce(data.coder_workspace_owner.me.full_name, data.coder_workspace_owner.me.name)
+ GIT_AUTHOR_EMAIL = "${data.coder_workspace_owner.me.email}"
+ GIT_COMMITTER_NAME = coalesce(data.coder_workspace_owner.me.full_name, data.coder_workspace_owner.me.name)
+ GIT_COMMITTER_EMAIL = "${data.coder_workspace_owner.me.email}"
+ }
+
+ metadata {
+ display_name = "CPU Usage"
+ key = "0_cpu_usage"
+ script = "coder stat cpu"
+ interval = 10
+ timeout = 1
+ }
+
+ metadata {
+ display_name = "RAM Usage"
+ key = "1_ram_usage"
+ script = "coder stat mem"
+ interval = 10
+ timeout = 1
+ }
+}
+
+resource "coder_app" "code-server" {
+ agent_id = coder_agent.main.id
+ slug = "code-server"
+ display_name = "code-server"
+ url = "http://localhost:13337/?folder=/home/${local.username}"
+ icon = "/icon/code.svg"
+ subdomain = false
+ share = "owner"
+
+ healthcheck {
+ url = "http://localhost:13337/healthz"
+ interval = 5
+ threshold = 6
+ }
+}
+
+resource "docker_volume" "home_volume" {
+ name = "coder-${data.coder_workspace.me.id}-home"
+ # Protect the volume from being deleted due to changes in attributes.
+ lifecycle {
+ ignore_changes = all
+ }
+}
+
+resource "docker_image" "main" {
+ name = "coder-${data.coder_workspace.me.id}"
+ build {
+ context = "./build"
+ build_args = {
+ USER = local.username
+ }
+ }
+ triggers = {
+ dir_sha1 = sha1(join("", [for f in fileset(path.module, "build/*") : filesha1(f)]))
+ }
+}
+
+resource "docker_container" "workspace" {
+ count = data.coder_workspace.me.start_count
+ image = docker_image.main.name
+ # Uses lower() to avoid Docker restriction on container names.
+ name = "coder-${data.coder_workspace_owner.me.name}-${lower(data.coder_workspace.me.name)}"
+ # Hostname makes the shell more user friendly: coder@my-workspace:~$
+ hostname = data.coder_workspace.me.name
+ # Use the docker gateway if the access URL is 127.0.0.1
+ entrypoint = ["sh", "-c", replace(coder_agent.main.init_script, "/localhost|127\\.0\\.0\\.1/", "host.docker.internal")]
+ env = [
+ "CODER_AGENT_TOKEN=${coder_agent.main.token}",
+ ]
+ host {
+ host = "host.docker.internal"
+ ip = "host-gateway"
+ }
+ volumes {
+ container_path = "/home/${local.username}"
+ volume_name = docker_volume.home_volume.name
+ read_only = false
+ }
+}
+```
+
+
## 7. Create the template in Coder
Save `main.tf` and exit the editor.
From 9b40e7f8aa0cf839b702da86c2b55ef3782439d1 Mon Sep 17 00:00:00 2001
From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
Date: Wed, 16 Oct 2024 05:38:33 +0000
Subject: [PATCH 04/16] remove expand
---
docs/tutorials/template-from-scratch.md | 129 ------------------------
1 file changed, 129 deletions(-)
diff --git a/docs/tutorials/template-from-scratch.md b/docs/tutorials/template-from-scratch.md
index c182fc3d9bc73..2087327eb41b1 100644
--- a/docs/tutorials/template-from-scratch.md
+++ b/docs/tutorials/template-from-scratch.md
@@ -338,135 +338,6 @@ resource "docker_container" "workspace" {
}
```
-
-Expand for the full `main.tf` file
-```tf
-terraform {
- required_providers {
- coder = {
- source = "coder/coder"
- }
- docker = {
- source = "kreuzwerker/docker"
- }
- }
-}
-
-locals {
- username = data.coder_workspace_owner.me.name
-}
-
-data "coder_provisioner" "me" {
-}
-
-provider "docker" {
-}
-
-provider "coder" {
-}
-
-data "coder_workspace" "me" {
-}
-
-data "coder_workspace_owner" "me" {}
-
-resource "coder_agent" "main" {
- arch = data.coder_provisioner.me.arch
- os = "linux"
- startup_script = <<-EOT
- set -e
-
- # install and start code-server
- curl -fsSL https://code-server.dev/install.sh | sh -s -- --method=standalone --prefix=/tmp/code-server
- /tmp/code-server/bin/code-server --auth none --port 13337 >/tmp/code-server.log 2>&1 &
- EOT
-
- env = {
- GIT_AUTHOR_NAME = coalesce(data.coder_workspace_owner.me.full_name, data.coder_workspace_owner.me.name)
- GIT_AUTHOR_EMAIL = "${data.coder_workspace_owner.me.email}"
- GIT_COMMITTER_NAME = coalesce(data.coder_workspace_owner.me.full_name, data.coder_workspace_owner.me.name)
- GIT_COMMITTER_EMAIL = "${data.coder_workspace_owner.me.email}"
- }
-
- metadata {
- display_name = "CPU Usage"
- key = "0_cpu_usage"
- script = "coder stat cpu"
- interval = 10
- timeout = 1
- }
-
- metadata {
- display_name = "RAM Usage"
- key = "1_ram_usage"
- script = "coder stat mem"
- interval = 10
- timeout = 1
- }
-}
-
-resource "coder_app" "code-server" {
- agent_id = coder_agent.main.id
- slug = "code-server"
- display_name = "code-server"
- url = "http://localhost:13337/?folder=/home/${local.username}"
- icon = "/icon/code.svg"
- subdomain = false
- share = "owner"
-
- healthcheck {
- url = "http://localhost:13337/healthz"
- interval = 5
- threshold = 6
- }
-}
-
-resource "docker_volume" "home_volume" {
- name = "coder-${data.coder_workspace.me.id}-home"
- # Protect the volume from being deleted due to changes in attributes.
- lifecycle {
- ignore_changes = all
- }
-}
-
-resource "docker_image" "main" {
- name = "coder-${data.coder_workspace.me.id}"
- build {
- context = "./build"
- build_args = {
- USER = local.username
- }
- }
- triggers = {
- dir_sha1 = sha1(join("", [for f in fileset(path.module, "build/*") : filesha1(f)]))
- }
-}
-
-resource "docker_container" "workspace" {
- count = data.coder_workspace.me.start_count
- image = docker_image.main.name
- # Uses lower() to avoid Docker restriction on container names.
- name = "coder-${data.coder_workspace_owner.me.name}-${lower(data.coder_workspace.me.name)}"
- # Hostname makes the shell more user friendly: coder@my-workspace:~$
- hostname = data.coder_workspace.me.name
- # Use the docker gateway if the access URL is 127.0.0.1
- entrypoint = ["sh", "-c", replace(coder_agent.main.init_script, "/localhost|127\\.0\\.0\\.1/", "host.docker.internal")]
- env = [
- "CODER_AGENT_TOKEN=${coder_agent.main.token}",
- ]
- host {
- host = "host.docker.internal"
- ip = "host-gateway"
- }
- volumes {
- container_path = "/home/${local.username}"
- volume_name = docker_volume.home_volume.name
- read_only = false
- }
-}
-```
-
-
## 7. Create the template in Coder
Save `main.tf` and exit the editor.
From 1cbc62bac6749cf7fedf6d2e9ff501313b6ef014 Mon Sep 17 00:00:00 2001
From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
Date: Mon, 21 Oct 2024 18:55:57 +0000
Subject: [PATCH 05/16] quick copy edit
---
docs/tutorials/template-from-scratch.md | 171 +++++++++++-------------
1 file changed, 78 insertions(+), 93 deletions(-)
diff --git a/docs/tutorials/template-from-scratch.md b/docs/tutorials/template-from-scratch.md
index 2087327eb41b1..35857df8294e3 100644
--- a/docs/tutorials/template-from-scratch.md
+++ b/docs/tutorials/template-from-scratch.md
@@ -1,27 +1,15 @@
-# A guided tour of a template
+# Write a template from scratch
-This guided tour introduces you to the different parts of a Coder template by
-showing you how to create a template from scratch.
+A template is a common configuration that you use to deploy workspaces.
-You'll write a simple template that provisions a workspace as a Docker container
-with Ubuntu.
+This tutorial teaches you how to create a template that provisions a workspace
+as a Docker container with Ubuntu.
## Before you start
-To follow this guide, you'll need:
-
-- A computer or cloud computing instance with both
- [Docker](https://docs.docker.com/get-docker/) and [Coder](../install/index.md)
- installed on it.
-
- - When setting up your computer or computing instance, make sure to install
- Docker first, then Coder. Otherwise, you'll need to add the `coder` user to
- the `docker` group.
-
-- The URL for your Coder instance. If you're running Coder locally, the default
- URL is [http://127.0.0.1:3000](http://127.0.0.1:3000).
-
-- A text editor. For this tour, we use [GNU nano](https://nano-editor.org/).
+You'll need a computer or cloud computing instance with both
+[Docker](https://docs.docker.com/get-docker/) and [Coder](../install/index.md)
+installed on it.
## What's in a template
@@ -37,22 +25,21 @@ started, or stopped.
> [Getting Started Guides](https://developer.hashicorp.com/terraform/tutorials).
Here's a simplified diagram that shows the main parts of the template we'll
-create.
+create:
## 1. Create template files
On your local computer, create a directory for your template and create the
-`Dockerfile`.
+`Dockerfile`. You will upload the files to your Coder instance later.
```sh
mkdir -p template-tour/build && cd $_
-nano Dockerfile
```
-You'll enter a simple `Dockerfile` that starts with the
-[official Ubuntu image](https://hub.docker.com/_/ubuntu/). In the editor, enter
+Enter content into a `Dockerfile` that starts with the
+[official Ubuntu image](https://hub.docker.com/_/ubuntu/). In your editor, enter
and save the following text in `Dockerfile` then exit the editor:
```dockerfile
@@ -72,22 +59,18 @@ USER ${USER}
WORKDIR /home/${USER}
```
-Notice how `Dockerfile` adds a few things to the parent `ubuntu` image, which
-your template needs later:
+`Dockerfile` adds a few things to the parent `ubuntu` image, which your template
+needs later:
- It installs the `sudo` and `curl` packages.
- It adds a `coder` user, including a home directory.
## 2. Set up template providers
-Edit the Terraform file to provision the workspace's resources:
-
-```shell
-nano main.tf
-```
+Edit the Terraform `main.tf` file to provision the workspace's resources.
-We'll start by setting up our providers. At a minimum, we need the `coder`
-provider. For this template, we also need the `docker` provider:
+Start by setting up the providers. At a minimum, we need the `coder` provider.
+For this template, we also need the `docker` provider:
```tf
terraform {
@@ -126,7 +109,7 @@ The
[`coder_workspace`](https://registry.terraform.io/providers/coder/coder/latest/docs/data-sources/workspace)
data source provides details about the state of a workspace, such as its name,
owner, and so on. The data source also lets us know when a workspace is being
-started or stopped. We'll take advantage of this information in later steps to:
+started or stopped. We'll use this information in later steps to:
- Set some environment variables based on the workspace owner.
- Manage ephemeral and persistent storage.
@@ -140,10 +123,9 @@ runs inside the compute aspect of your workspace, typically a VM or container.
In our case, it will run in Docker.
You do not need to have any open ports on the compute aspect, but the agent
-needs `curl` access to the Coder server. Remember that we installed `curl` in
-`Dockerfile`, earlier.
+needs `curl` access to the Coder server.
-Add this snippet below the last closing `}` in `main.tf` to create the agent:
+Add this snippet after the last closing `}` in `main.tf` to create the agent:
```tf
resource "coder_agent" "main" {
@@ -184,29 +166,33 @@ resource "coder_agent" "main" {
Because Docker is running locally in the Coder server, there is no need to
authenticate `coder_agent`. But if your `coder_agent` is running on a remote
-host, your template would need
+host, your template will need
[authentication credentials](../admin/external-auth.md).
This template's agent also runs a startup script, sets environment variables,
and provides metadata.
-The
-[`startup script`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#startup_script)
-installs [code-server](https://coder.com/docs/code-server), a browser-based
-[VS Code](https://code.visualstudio.com/) app that runs in the workspace. We'll
-give users access to code-server through `coder_app`, later.
+- [`startup script`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#startup_script)
-The
-[`env`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#env)
-block sets environments variables for the workspace. We use the data source from
-`coder_workspace` to set the environment variables based on the workspace's
-owner. This way, the owner can make git commits immediately without any manual
-configuration.
+ - Installs [code-server](https://coder.com/docs/code-server), a browser-based
+ [VS Code](https://code.visualstudio.com/) app that runs in the workspace.
+
+ We'll give users access to code-server through `coder_app`, later.
+
+- [`env` block](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#env)
+
+ - Sets environments variables for the workspace.
+
+ We use the data source from `coder_workspace` to set the environment
+ variables based on the workspace's owner. This way, the owner can make git
+ commits immediately without any manual configuration.
-Your template can use metadata to show information to the workspace owner. Coder
-displays this metadata in the Coder dashboard. Our template has
-[`metadata`](../admin/templates/extending-templates/agent-metadata.md) blocks
-for CPU and RAM usage.
+- [`metadata`](../admin/templates/extending-templates/agent-metadata.md) blocks
+
+ - Your template can use metadata to show information to the workspace owner
+ Coder displays this metadata in the Coder dashboard.
+
+ Our template has `metadata` blocks for CPU and RAM usage.
## 4. coder_app
@@ -220,10 +206,9 @@ This is commonly used for
[web IDEs](../user-guides/workspace-access/web-ides.md) such as
[code-server](https://coder.com/docs/code-server), RStudio, and JupyterLab.
-To install code-server in the workspace, remember that we installed it in the
-`startup_script` argument in `coder_agent`. We make it available from a
-workspace with a `coder_app` resource. See
-[web IDEs](../user-guides/workspace-access/web-ides.md) for more examples.
+We installed code-server in the `startup_script` argument. To add code-server to
+the workspace, make it available in the workspace with a `coder_app` resource.
+See [web IDEs](../user-guides/workspace-access/web-ides.md) for more examples:
```tf
resource "coder_app" "code-server" {
@@ -272,10 +257,9 @@ We do this in 2 parts:
workspace name change, we use an immutable parameter, like
`data.coder_workspace.me.id`.
-You'll see later that we make sure that our Docker container is ephemeral with
-the Terraform
+Later, we use the Terraform
[count](https://developer.hashicorp.com/terraform/language/meta-arguments/count)
-meta-argument.
+meta-argument to make sure that our Docker container is ephemeral.
```tf
resource "docker_volume" "home_volume" {
@@ -345,57 +329,58 @@ Save `main.tf` and exit the editor.
Now that we've created the files for our template, we can add them to our Coder
deployment.
-We can do this with the Coder CLI or the Coder dashboard. For this tour, we'll
+We can do this with the Coder CLI or the Coder dashboard. In this example, we'll
use the Coder CLI.
-First, you'll need to log in to your Coder deployment from the CLI. This is
-where you need the URL for your deployment:
+1. Log in to your Coder deployment from the CLI. This is where you need the URL
+ for your deployment:
-```sh
-$ coder login https://coder.example.com
-Your browser has been opened to visit:
+ ```console
+ $ coder login https://coder.example.com
+ Your browser has been opened to visit:
- https://coder.example.com/cli-auth
+ https://coder.example.com/cli-auth
-> Paste your token here:
-```
+ > Paste your token here:
+ ```
-In your web browser, enter your credentials:
+1. In your web browser, enter your credentials:
-
+ 
-Copy the session token into the clipboard:
+1. Copy the session token into the clipboard:
-
+ 
-And paste it into the CLI:
+1. Paste it into the CLI:
-```sh
-> Welcome to Coder, marc! You're authenticated.
-$
-```
+ ```output
+ > Welcome to Coder, marc! You're authenticated.
+ $
+ ```
-Now you can add your template files to your Coder deployment:
+1. Add your template files to your Coder deployment:
-```sh
-$ pwd
-/home/marc/template-tour
-$ coder templates create
-> Upload "."? (yes/no) yes
-```
+ ```console
+ $ pwd
+ /home/docs/template-tour
+ $ coder templates create
+ > Upload "."? (yes/no) yes
+ ```
-The Coder CLI tool gives progress information then prompts you to confirm:
+1. The Coder CLI tool gives progress information then prompts you to confirm:
-```sh
-> Confirm create? (yes/no) yes
+ ```console
+ > Confirm create? (yes/no) yes
-The template-tour template has been created! Developers can provision a workspace with this template using:
+ The template-tour template has been created! Developers can provision a workspace with this template using:
- coder create --template="template-tour" [workspace name]
-```
+ coder create --template="template-tour" [workspace name]
+ ```
+
+1. In your web browser, log in to your Coder dashboard, select **Templates**.
-In your web browser, log in to your Coder dashboard, select **Templates**. Your
-template is ready to use for new workspaces.
+Your template is ready to use for new workspaces.
From c9d37d74504cac5120d0f8c05e5ba6c9356137e0 Mon Sep 17 00:00:00 2001
From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
Date: Wed, 6 Nov 2024 18:55:37 +0000
Subject: [PATCH 06/16] update steps to include 1. upload through ui 2. new
screenshots
---
docs/images/templates/coder-login-web.png | Bin 47996 -> 29767 bytes
docs/images/templates/coder-session-token.png | Bin 57195 -> 29767 bytes
.../templates/upload-create-template-form.png | Bin 0 -> 91738 bytes
.../upload-create-your-first-template.png | Bin 0 -> 70983 bytes
docs/images/templates/workspace-apps.png | Bin 508500 -> 67735 bytes
docs/tutorials/template-from-scratch.md | 46 +++++++++++++++---
6 files changed, 39 insertions(+), 7 deletions(-)
create mode 100644 docs/images/templates/upload-create-template-form.png
create mode 100644 docs/images/templates/upload-create-your-first-template.png
diff --git a/docs/images/templates/coder-login-web.png b/docs/images/templates/coder-login-web.png
index 161ff92a004012b67774fa3889dfcd19ff4294ec..571c28ccd0568904d1250b1b94ee3f6991ea4bfa 100644
GIT binary patch
literal 29767
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