@@ -6,7 +6,7 @@ through the Coder agent, then stopped and deleted again by Terraform.
6
6
7
7
This page covers how workspaces move through this lifecycle. To learn about
8
8
automating workspace schedules for cost control, read the
9
- [ workspace scheduling docs] ( ../../user-guides /workspace-scheduling.md ) .
9
+ [ workspace scheduling docs] ( ./workspace-scheduling.md ) .
10
10
11
11
## Workspace ephemerality
12
12
@@ -16,7 +16,7 @@ ephemeral resources are destroyed and recreated on restart. All resources are
16
16
destroyed when a workspace is deleted.
17
17
18
18
> Template administrators can learn more about resource configuration in the
19
- > [ extending templates docs] ( ../templates/extending-templates/resource-persistence.md ) .
19
+ > [ extending templates docs] ( ../admin/ templates/extending-templates/resource-persistence.md ) .
20
20
21
21
## Workspace States
22
22
@@ -35,17 +35,18 @@ following broken states:
35
35
36
36
## Workspace creation
37
37
38
- Workspaces are created from [ templates] ( ../templates/index.md ) via the CLI, API,
39
- or dashboard. To learn how, read our [ user guides ] ( ../../user-guides/index.md ) .
38
+ Workspaces are created from [ templates] ( ../admin/ templates/index.md ) via the
39
+ CLI, API, or dashboard .
40
40
41
41
By default, there is no limit on the number of workspaces a user may create,
42
42
regardless of the template's resource demands. Enterprise administrators may
43
43
limit the number of workspaces per template, group, and organization using
44
- [ quotas] ( ../users/quotas.md ) to prevent over provisioning and control costs.
44
+ [ quotas] ( ../admin/users/quotas.md ) to prevent over provisioning and control
45
+ costs.
45
46
46
47
When a user creates a workspace, they're sending a build request to the control
47
48
plane. Coder takes this and uses [ Terraform] ( https://www.terraform.io/ ) to
48
- provision a workspace defined by your [ template] ( ../templates/index.md ) .
49
+ provision a workspace defined by your [ template] ( ../admin/ templates/index.md ) .
49
50
Generally, templates define the resources and environment of a workspace.
50
51
51
52
The resources that run the agent are described as _ computational resources_ ,
@@ -54,24 +55,22 @@ contain some computational resource to run the Coder agent process.
54
55
55
56
The provisioned workspace's computational resources start the agent process,
56
57
which opens connections to your workspace via SSH, the terminal, and IDES such
57
- as [ JetBrains] ( ../../user-guides /workspace-access/jetbrains.md ) or
58
- [ VSCode] ( ../../user-guides /workspace-access/vscode.md ) .
58
+ as [ JetBrains] ( ./workspace-access/jetbrains.md ) or
59
+ [ VSCode] ( ./workspace-access/vscode.md ) .
59
60
60
61
Once started, the Coder agent is responsible for running your workspace startup
61
62
scripts. These may configure tools, service connections, or personalization with
62
- [ dotfiles] ( ../../user-guides/ workspace-dotfiles.md ) .
63
+ [ dotfiles] ( .workspace-dotfiles.md ) .
63
64
64
65
Once these steps have completed, your workspace will now be in the ` Running `
65
- state. You can access it via any of the
66
- [ supported methods] ( ../../user-guides/workspace-access/index.md ) , stop it when
67
- you're away, or delete it once it's no longer in use.
66
+ state. You can access it via any of the [ supported methods] ( ./index.md ) , stop it
67
+ when you're away, or delete it once it's no longer in use.
68
68
69
69
## Stopping workspaces
70
70
71
71
Workspaces may be stopped manually by users and admins in the dashboard, CLI, or
72
72
API. Workspaces may be automatically stopped due to template updates or
73
- inactivity by
74
- [ scheduling configuration] ( ../../user-guides/workspace-scheduling.md ) .
73
+ inactivity by [ scheduling configuration] ( ./workspace-scheduling.md ) .
75
74
76
75
Once stopped, a workspace may resume running by starting it manually, or via
77
76
user connection if automatic start is enabled.
@@ -110,8 +109,8 @@ your template's Terraform file and the target resources on your infrastructure.
110
109
Unhealthy workspaces are usually caused by a misconfiguration in the agent or
111
110
workspace startup scripts.
112
111
113
- ## Next steps
112
+ ### Next steps
114
113
115
- - [ Connecting to your workspace] ( ../../user-guides/workspace-access /index.md )
116
- - [ Creating templates] ( ../templates/index.md )
117
- - [ Workspace scheduling] ( ../../user-guides /workspace-scheduling.md )
114
+ - [ Connecting to your workspace] ( ./index.md )
115
+ - [ Creating templates] ( ../admin/ templates/index.md )
116
+ - [ Workspace scheduling] ( ./workspace-scheduling.md )
0 commit comments