docs icon indicating copy to clipboard operation
docs copied to clipboard

mount/volume options are not explicitly listed

Open thedoc31 opened this issue 8 months ago • 1 comments

Is this a docs issue?

  • [X] My issue is about the documentation content or website

Type of issue

I can't find what I'm looking for

Description

I'm trying to mount a volume using either --mount or -v in a container. These mounts need specific permissions. The doucmentation says

The third field is optional, and is a comma-separated list of options, such as ro. These options are discussed below.

But there is no table or other useful list below in which I can identify all available options. readonly, z, and Z are mentioned, but there's no other information listed like whether or not I can configure a uid/gid or explicit linux permissions (e.g. 0640, 0644, 0755, etc) on a mount inside a container. The documentation for these in docker run [1,2], and Bind options [3] is also incomplete in the same way. [1] https://docs.docker.com/reference/cli/docker/container/run/#mount [2] https://docs.docker.com/reference/cli/docker/container/run/#volume [3] https://docs.docker.com/storage/bind-mounts/

Location

https://docs.docker.com/storage/volumes/

Suggestion

Add a table which lists all available options that can be added, and whether or not they're supported by -v or --mount e.g.

Option -v --mount
readonly
z, Z
...

Also, perhaps merge the bind and storage volume pages since they're substantially similar and repeat the same information in two places.

thedoc31 avatar Jun 14 '24 21:06 thedoc31