docs: update run --mount verbiage #3406
Conversation
Signed-off-by: David Karlsson <david.karlsson@docker.com>
dvdksn
force-pushed
the
docs/dockerfile-run-mount-verbiage
branch
from
7bfe378
to
9490fd1
Compare
| `RUN --mount` allows you to create filesystem mounts that the build can access. | ||
| This can be used to: | ||
|
|
||
| - Create bind mount to the host filesystem or other build stages |
There was a problem hiding this comment.
host filesystem may be confusing here; as far as I know, we don't support --mount type=bind,source=/some/arbitrary/path/on/host.
The above case has lead to long debates (as we want to keep the build environment isolated, and not able to modify state on the host), see moby/moby#14080, so from that perspective we should avoid confusion if possible.
There was a problem hiding this comment.
So it should probably outline that it mounts from a) the host where the builder / daemon runs, and b) that (for bind-mounts), it mounts from the build-context storage that's used by the builder (which holds am immutable copy of files used during build). The BuildKit maintainers are probable better suited to fill in the blanks for me 😂
Signed-off-by: David Karlsson david.karlsson@docker.com