- move "docker desktop" to the top of the "product manuals" section,
and make it the default page
- Add a "Reference documentation" menu item to the TOC, which will be
the "active" menu item when opening the reference section.
- move the "Samples home" menu item outside of the "samples" sub-menu,
and add it at the top level as "samples overview", so that the "index"
highlights that menu-item without opening the "samples" sub-menu. The
"samples" submenu contains various samples which are a bit outdated,
so probably shouldn't be _that_ prominent when opening the page.
Moving the menu item also makes the "breadcrumb" navigation more
natural (moving from a sample to "samples overview" navigates back
to the "top" of the samples section.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
The docker for mac "toolbox" migration page was not accessible as it
was redirected, so removing that page and related images.
This page contained instructions to backup images, which was described
elsewhere, so removing that part in favor of a link to the (better maintained)
content in the "desktop" section.
Also move the migration page that was located inside the "for windows"
directory to a "toolbox" directory, which matches the location inside the
TOC.
Finally; remove the "troubleshooting" entry from the TOC, as it was
redirecting to the migration page (and was under the "kitematic" section,
which was confusing).
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Both Docker Desktop for Mac and Docker Desktop for Windows provide
this feature, so moving it out of the section that's specific to
Docker Desktop for Mac.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
- The /samples/wordpress/ location collided with an old redirect
to the official images, so removed the redirect
- Removed the sshd example from the table and TOC, as the example
was removed, and now pointing to an alternative examples. The
page is kept for people that may have bookmarked it, but no
need to include it in the navigation.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Unifying all "examples" in this directory; some of these should still be
reviewed and/or removed in favor of examples from "awesome compose"
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
these commands are hidden in the cli, but functional, and mentioned
in the "working with buildx" introduction.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Combine Windows install pages
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
* Apply suggestions from code review
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
* Apply suggestions from code review
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
* Some more minor updates to improve readability
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
This started as a "fix some links", but reading the section, I found various
issues that could use some improvement. After that, I noticed that both the
Windows and Mac pages had the same content, so I moved this to a common page
instead.
Note that there's still additional information that should likely be included
(and perhaps a rewrite into "per topic" headings (containers, images, ...).
Things that are missing;
- backup/restore swarmkit configs
- backup/restore swarmkit secrets
- backup/restore CLI configuration, trust data etc.
What I did in this pull request:
- recommend pushing images to Docker Hub as the default approach to back up
images (but kept `docker image save` as an alternative)
- recommend `docker container commit` to save containers to an image, as doing
so preserves both the container's configuration _and_ filesystem changes.
`docker container export` only preserves the filesystem, but all other
configuration is lost, which makes it hard to restore a container from it.
Using `docker container commit` (committing the container to an image) also
allows to follow the same procedure to backup containers as for images
(both allowing them to be pushed to a registry, or to a file).
- added some information about "wether or not" containers should be backed
up, as it may not be needed to back up containers if all data is stored
in volumes (best practice).
- added some warnings regarding "sensitive data" (environment variables),
and links to making repositories private before pushing.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Document GPU support in Docker Compose
Signed-off-by: aiordache <anca.iordache@docker.com>
* Update the note format
Added target=blank to enable external links to open in a new tab.
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
Previously, the `ssh://` helper was only mentioned in `engine/security/index.md`.
The `ssh://` helper is now documented in "Protect the Docker daemon socket"
(`engine/security/protect-access.md`, nee `engine/security/https.md`).
Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
The existing implementation was broken, and didn't override
the URLs (due to leading, trailing slashes the paths were not
matched).
Instead of using the custom "not_edited_here.yaml", set the
edit-url as front-matter variable through the _config.yml
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Generated yaml files were temporarily updated manually (pending
pull request to be merged in the upstream docker/cli repository)
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
- Updated the Guides tab to open to the Get started page, instead of Develop with Docker.
- Moved Docker overview as the first entry in the Guides toc.
* Move WSL page
Signed-off-by: Stefan Scherer <scherer_stefan@icloud.com>
* Update Windows 10, version 2004
Signed-off-by: Stefan Scherer <stefan.scherer@docker.com>
* - Added a new topic to describe how to install Desktop on Windows Home machines.
- Update installation instructions on Windows/Mac topics
- Removed references to Toolbox from the Install topics
- Updated the Install pages to add info on the new onboarding tutorial on startup
* Update docker-for-windows/install-windows-home.md
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
* Update docker-for-windows/install-windows-home.md
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
* Update docker-for-windows/install-windows-home.md
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
* Update docker-for-windows/install-windows-home.md
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
* move WSL 2 req above Hyper-V reqs
* Add info on purge container data
Co-authored-by: Stefan Scherer <stefan.scherer@docker.com>
* - Added a new Overview topic for Docker Desktop
- Moved Dashboard up one level and removed OS-specific topics and images from the Mac and Windows directories
* Updated the Desktop TOC
- Moved Install topics above Getting started topic
- Moved Open source licensing up one level
- Removed OS-specific topics
* Fix review comments
This is a follow-up to d4ead1b120,
which removed the datafile for `docker deploy`, but didn't remove
the stub or removed it from the TOC.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
now that all API versions are unified in both the "master" and
release branches, we can fetch then all at once with svn.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Links to reference pages for each command were shown without `docker-compose`.
Given that there's similar commands for the `docker cli`, it's easy for users
to confuse the pages. The `docker` CLI reference prefixes all commands with
`docker`, so updating the Docker Compose section to use the same.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
- Move getting started overview to /get-started/overview/
- Move engine installation files under /engine/
- Redirect the top-level /install/ to /get-docker/
- Updated titles in left-hand navigation
- Added back some pages to the navigation that were
currently not included.
- Reduce some steps in the installation pages
- Move devicemapper prerequisites to the devicemapper
storage driver page.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
- Remove the "Develop your apps on Docker" section, as there
was only a single section.
- Shorten titles in the navigation: the page itself still
has the full title. Some titles also didn't match the
title on the page.
- Changed "Docker build enhancements for 18.09" to
"Build images with BuildKit" to help discovery of the
BuildKit back-end.
- Some minor (Markdown) touch-ups of the BuildKit topic.
- Moved "Create a base image" lower in the navigation,
because it's an advanced topic that most users won't
be using (generally, using the official base images
from Docker Hub would be recommended).
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Regenerated the yaml files after fixing a bug in the generator
script that caused some extended descriptions and examples
to not be included.
Also fixes the generated YAML to use the "long form" format,
instead of the compact format (where newlines were encoded
as `\n`). This makes the YAML more "human readable", and makes
reviewing updates easier.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
The list of items in the left-hand menu is not too long,
so to improve discoverability, moving these two sections
one level "up".
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* DTR release notes for March 2020 Amberjack patch release
* updating dtr and ucp product versions and links to tarballs
* fixing typo
Co-authored-by: Dawn W Docker <dawn.wood@users.noreply.github.com>
Docker Enterprise actively supports the 17.06, 18.03, 18.09, and
19.03 versions, with 17.06 and 18.03 reaching EOL soon.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Move classic overlay networking topic to swarm standalone section
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Redirect old "getting started with overlay networks" to current page
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Update Get started docs
* update part-1, add redirects
* draft updates to part 2 and 3
* tidy up the orchestration topics
* update examples, and other minor edits
* address Stefan's review comments
* moved orchestration to a new node
* fix Ben's review comments
* add email verification step
* Emphasize the CTA in part 3
Deploying stacks using the "Docker Application Bundle" (`.dab`) file
format was introduced as an experimental feature in Docker 1.13 /
17.03, but superseded by support for Docker Compose files in the CLI.
With no development being done on this feature, and no active use of the file
format, support for the DAB file format and the top-level `docker deploy` command
(hidden by default in 19.03), will be removed from the CLI, in favour of
`docker stack deploy` using compose files.
This patch removes documentation for the `docker-compose bundle` subcommand,
which was used to convert compose files into DAB files (and given the above,
will no longer be needed).
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Sebastiaan van Stijn
Usha Mandya
Oliver Frolovs
Usha Mandya
Nicolas De Loof
Metal
Sebastiaan van Stijn
Anca Iordache
Guillaume Tardif
Nick Adcock
Anca Iordache
Akihiro Suda
Roman Anasal
Guillaume Tardif
Brandon Mitchell
James Hodgkinson
James Ratliff
Tibor Vass
Ben De St Paer-Gotch
Jérémie Drouet
Stefan Scherer
Charles Chan
Dawn-Docker Enterprise
Traci Morrison
Traci Morrison
Dawn W Docker
Olly P
KoryKessel-Docker