You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/dev_containers.md
+9-7Lines changed: 9 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,6 +8,7 @@ Dev Container for short) allows a container to be used as a full‑featured
8
8
development environment.
9
9
10
10
Stack provides the following Dev Containers:
11
+
11
12
* a default Dev Container, intended for use with Stack's project‑level
12
13
configuration (`stack.yaml`); and
13
14
* alternative Dev Containers, intended for use with Stack's experimental
@@ -63,6 +64,7 @@ These Docker images are multi-architecture (`linux/amd64`, `linux/arm64/v8`)
63
64
64
65
The images contain *unofficial* binary distributions of GHC 9.4.6 and 9.6.2
65
66
(that is, ones not released by the GHC developers). That is because:
67
+
66
68
1. the official GHC binary distributions for Alpine Linux/x86_64 have known
67
69
bugs; and
68
70
2. there are no official binary distributions for Alpine Linux/AArch64.
@@ -82,19 +84,19 @@ For use with Github Codespaces, please follow the instruction at
82
84
83
85
Data in the following locations is persisted:
84
86
85
-
1. The user's home directory (`/home/vscode`)[^2]
87
+
1. The user's home directory (`/home/vscode` or, for the root user, `/root`).
88
+
Use with Docker/Podman in *rootless mode*.
86
89
2. The Dev Container's workspace (`/workspaces`)
87
90
88
-
[^2]: Alternatively for the root user (`/root`). Use with Docker/Podman in
89
-
*rootless mode*.
90
-
91
-
This is accomplished either via a *volume* or *bind mount* (or *loop device*
91
+
This is accomplished via either a *volume* or *bind mount* (or *loop device*
92
92
on Codespaces) and is preconfigured.
93
93
94
94
!!! info
95
95
96
-
**Codespaces: A 'Full Rebuild Container' resets the home directory.**
97
-
This is never necessary unless you want exactly that.
96
+
The VS Code Command Palette command
97
+
['Codespaces: Full Rebuild Container'](https://docs.github.com/en/codespaces/developing-in-codespaces/rebuilding-the-container-in-a-codespace#rebuilding-a-container)
98
+
resets the home directory. This is never necessary unless you want exactly
0 commit comments