@@ -23,22 +23,6 @@ vim <template-name>/main.tf
23
23
coder templates < create/update> < template-name>
24
24
```
25
25
26
- ## Persistent and ephemeral resources
27
-
28
- Coder supports both ephemeral and persistent resources in workspaces. Ephemeral
29
- resources are destroyed when a workspace is not in use (e.g., when it is
30
- stopped). Persistent resources remain. See how this works for a sample front-end
31
- template:
32
-
33
- | Resource | Type |
34
- | :--------------------------- | :--------- |
35
- | google_compute_disk.home_dir | persistent |
36
- | kubernetes_pod.dev | ephemeral |
37
- | └─ nodejs (linux, amd64) | |
38
- | api_token.backend | ephemeral |
39
-
40
- When a workspace is deleted, all resources are destroyed.
41
-
42
26
## Parameters
43
27
44
28
Templates often contain * parameters* . In Coder, there are two types of parameters:
@@ -47,10 +31,9 @@ Templates often contain *parameters*. In Coder, there are two types of parameter
47
31
are often cloud secrets, such as a ` ServiceAccount ` token, and are annotated
48
32
with ` sensitive = true ` in the template code.
49
33
50
- - ** User parameters** are set when a user creates a workspace. They are unique to
51
- each workspace, often personalization settings such as "preferred
52
- region" or "workspace image".
53
-
34
+ - ** User parameters** are set when a user creates a workspace. They are unique
35
+ to each workspace, often personalization settings such as "preferred region"
36
+ or "workspace image".
54
37
55
38
## Best Practices
56
39
@@ -70,12 +53,12 @@ provider credentials out of Coder's database (making it a less valuable target f
70
53
and is compatible with agent-based authentication schemes (that handle credential rotation
71
54
and/or ensure the credentials are not written to disk).
72
55
73
- Cloud providers for which the Terraform provider supports authenticated environments include
56
+ Cloud providers for which the Terraform provider supports authenticated environments include:
74
57
75
- * [ Google Cloud] ( https://registry.terraform.io/providers/hashicorp/google/latest/docs )
76
- * [ Amazon Web Services] ( https://registry.terraform.io/providers/hashicorp/aws/latest/docs )
77
- * [ Microsoft Azure] ( https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs )
78
- * [ Kubernetes] ( https://registry.terraform.io/providers/hashicorp/kubernetes/latest/docs )
58
+ - [ Google Cloud] ( https://registry.terraform.io/providers/hashicorp/google/latest/docs )
59
+ - [ Amazon Web Services] ( https://registry.terraform.io/providers/hashicorp/aws/latest/docs )
60
+ - [ Microsoft Azure] ( https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs )
61
+ - [ Kubernetes] ( https://registry.terraform.io/providers/hashicorp/kubernetes/latest/docs )
79
62
80
63
Additional providers may be supported; check the
81
64
[ documentation of the Terraform provider] ( https://registry.terraform.io/browse/providers ) for
0 commit comments