* Update "Mounts" example
In the original example, the "Mounts" field returned by `docker container inspect [CONTAINER]` was not shown. This may be too much data, but we should at least show the "Mounts" field so folks know what to look for.
* shortened the docker inspect example
Co-authored-by: David Karlsson <david.karlsson@docker.com>
Mount propagation is not supported for named volumes, as mentioned in
the paragraph before this one, so let's remove it here.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
The current wording implies that ANY bind mount into a non-empty directory will obscure the files in that directory, but while that's true of bind mounting a directory, it's not true if bind-mounting a single file (from my testing, in a linux container running Docker Desktop for Windows).
I simply added that minor (but important) clarification of "a directory".
These were notes about distro versions that have been EOL for a long
time, and an old version of docker engine that's EOL as well.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Add information on compose usage.
Add information on how to declare a bind mount in docke compose.
* Apply suggestions from code review
* Update storage/bind-mounts.md
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
There is an error in the example commands of Step 9 in the copy on write strategy section of the [About storage drivers](https://docs.docker.com/storage/storagedriver/#the-copy-on-write-cow-strategy) page. The first command should reference the `acme/my-base-image:1.0` image and the second command should reference the `acme/my-final-image:1.0`.
* Change section headers for backing up/restoring volumes to use "volume" instead of "container"
The section headers "Backup a container" and "Restore container from backup" are used as headers for sections that are actually about backing up and restoring volumes.
* Minor style update
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
* Minor `read-only` clarification
## Why
It was not obvious to me that `ro` is the shorthand form of `readonly`.
## Description
This adds a bit of text to explicitly state that `ro` is the shorthand form of `readonly` when using volumes
* Update storage/volumes.md
Co-authored-by: Sebastiaan van Stijn <thaJeztah@users.noreply.github.com>
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
Co-authored-by: Sebastiaan van Stijn <thaJeztah@users.noreply.github.com>
* Document path conversion on Windows
* Minor formatting and style updates
* desktop/windows: minor fixes in troubleshoot
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
- Add missing code-hints (console, yaml)
- Consistently add an empty line after code-blocks
- Combine some examples where the output and the command were
put in separate blocks. With the "console" code-hint, this
is no longer nescessary.
- fix indentation in cloud/ecs-integration.md, which caused the
numbered-list to be interrupted.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
- Reduce use of "Community Edition", and some sections that were written
for Docker Enterprise.
- Add notes about deprecation of AuFS in the overview.
- Update the storage driver index page to use BuildKit, and rephrase some
bits that made assumptions about each Dockerfile instruction producing
a new layer.
- Updated some examples to be usable on Docker Desktop, which does not
provide direct access to the daemon's storage directoreis.
- Add some notes linking to relevant sections about formatting output.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Added .md files for SLES and RHEL engine installation. Added indexing to _data/toc.yaml and engine/install/index.md. Modified engine/install/index.md, includes/install-script.md, engine/security/rootless.md, storage/storagedriver/device-mapper-driver.md, and storage/storagedriver/select-storage-driver.md to add info for added RHEL and SLES support. Modified engine/install/ubuntu.md to add s390x repos and other info. Added tab target for RHEL and SLES to engine/security/rootless.md along with other info.
Signed-off-by: Nirman Narang <narang@us.ibm.com>
BuildKit allows using alternative Dockerfile syntaxes to introduce new features
without having to update Docker itself. The general recommendation is to always
specify a "syntax" directive in a Dockerfile, so that (if needed) older versions
of Docker can download the correct syntax to build the Dockerfile.
This updates our examples to include a syntax directive, to make users more familiar
with these directives, and to illustrate best-pracitces in our documentation.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
The documentation curently doesn't contain reference docs for the
unified (version-less) compose-file syntax, so for now replacing
all links to point to the v3 compose-file reference, which is still
present.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
