Move storage docs into /storage (#5884)

_data/toc.yaml

@@ -278,35 +278,33 @@ guides:
       title: IPv6 with Docker
 - sectiontitle: Manage application data
   section:
-    - path: /engine/admin/volumes/
+    - path: /storage/
       title: Storage overview
-    - path: /engine/admin/volumes/volumes/
+    - path: /storage/volumes/
       title: Volumes
-    - path: /engine/admin/volumes/bind-mounts/
+    - path: /storage/bind-mounts/
       title: Bind mounts
-    - path: /engine/admin/volumes/tmpfs/
+    - path: /storage/tmpfs/
       title: tmpfs mounts
-    - path: /engine/admin/troubleshooting_volume_errors/
+    - path: /storage/troubleshooting_volume_errors/
       title: Troubleshoot volume problems
     - sectiontitle: Store data within containers
       section:
-      - path: /engine/userguide/storagedriver/
-        title: Storage driver overview
-      - path: /engine/userguide/storagedriver/imagesandcontainers/
-        title: About images, containers, and storage drivers
-      - path: /engine/userguide/storagedriver/selectadriver/
+      - path: /storage/storagedriver/
+        title: About storage drivers
+      - path: /storage/storagedriver/select-storage-driver/
         title: Select a storage driver
-      - path: /engine/userguide/storagedriver/aufs-driver/
+      - path: /storage/storagedriver/aufs-driver/
         title: Use the AUFS storage driver
-      - path: /engine/userguide/storagedriver/btrfs-driver/
+      - path: /storage/storagedriver/btrfs-driver/
         title: Use the Btrfs storage driver
-      - path: /engine/userguide/storagedriver/device-mapper-driver/
+      - path: /storage/storagedriver/device-mapper-driver/
         title: Use the Device mapper storage driver
-      - path: /engine/userguide/storagedriver/overlayfs-driver/
+      - path: /storage/storagedriver/overlayfs-driver/
         title: Use the OverlayFS storage driver
-      - path: /engine/userguide/storagedriver/zfs-driver/
+      - path: /storage/storagedriver/zfs-driver/
         title: Use the ZFS storage driver
-      - path: /engine/userguide/storagedriver/vfs-driver/
+      - path: /storage/storagedriver/vfs-driver/
         title: Use the VFS storage driver
 - sectiontitle: Run your app in production
   section:

engine/userguide/storagedriver/index.md

@@ -1,43 +0,0 @@
----
-description: Learn how to select the proper storage driver for your container.
-keywords: container, storage, driver, aufs, btrfs, devicemapper, zfs, overlay, overlay2
-title: Docker storage drivers
----
-
-Ideally, very little data is written to a container's writable layer, and you
-use Docker volumes to write data. However, some workloads require you to be able
-to write to the container's writable layer. This is where storage drivers come
-in.
-
-Docker uses a series of different storage drivers to manage the filesystems
-within images and running containers. These storage drivers are different from
-[Docker volumes](/engine/tutorials/dockervolumes.md), which manage storage
-which can be shared among multiple containers.
-
-Docker relies on driver technology to manage the storage and interactions
-associated with images and the containers that run them. This section contains
-the following pages:
-
-* [About images, containers, and storage drivers](imagesandcontainers.md)
-* [Select a storage driver](selectadriver.md)
-* [AUFS storage driver in practice](aufs-driver.md)
-* [Btrfs storage driver in practice](btrfs-driver.md)
-* [Device Mapper storage driver in practice](device-mapper-driver.md)
-* [OverlayFS in practice](overlayfs-driver.md)
-* [ZFS storage in practice](zfs-driver.md)
-
-If you are new to Docker containers make sure you read
-[about images, containers, and storage drivers](imagesandcontainers.md) first.
-It explains key concepts and technologies that can help you when working with
-storage drivers.
-
-### Acknowledgment
-
-The Docker storage driver material was created in large part by our guest author
-Nigel Poulton with a bit of help from Docker's own Jérôme Petazzoni. In his
-spare time Nigel creates
-[IT training videos](http://www.pluralsight.com/author/nigel-poulton) and co-hosts
-the weekly
-[In Tech We Trust podcast](http://intechwetrustpodcast.com/). Follow him on
-[Twitter](https://twitter.com/nigelpoulton).
-

storage/bind-mounts.md

@@ -2,6 +2,8 @@
 description: Using bind mounts
 title: Use bind mounts
 keywords: storage, persistence, data persistence, mounts, bind mounts
+redirect_from:
+- /engine/admin/volumes/bind-mounts/
 ---
 
 Bind mounts have been around since the early days of Docker. Bind mounts have
@@ -438,4 +440,4 @@ $ docker run -d \
 
 - Learn about [volumes](volumes.md).
 - Learn about [tmpfs mounts](tmpfs.md).
-- Learn about [storage drivers](/engine/userguide/storagedriver.md).
+- Learn about [storage drivers](/storage/storagedriver/).

storage/index.md

@@ -2,6 +2,8 @@
 description: Overview of persisting data in containers
 title: Manage data in Docker
 keywords: storage, persistence, data persistence, volumes, mounts, bind mounts
+redirect_from:
+- engine/admin/volumes/
 ---
 
 It is possible to store data within the writable layer of a container, but there
@@ -12,7 +14,7 @@ are some downsides:
 - A container's writable layer is tightly coupled to the host machine
   where the container is running. You can't easily move the data somewhere else.
 - Writing into a container's writable layer requires a
-  [storage driver](/engine/userguide/storagedriver.md) to manage the
+  [storage driver](/storage/storagedriver/) to manage the
   filesystem. The storage driver provides a union filesystem, using the Linux
   kernel. This extra abstraction reduces performance as compared to using
   _data volumes_, which write directly to the host filesystem.
@@ -175,6 +177,6 @@ If you use either bind mounts or volumes, keep the following in mind:
 - Learn more about [volumes](volumes.md).
 - Learn more about [bind mounts](bind-mounts.md).
 - Learn more about [tmpfs mounts](tmpfs.md).
-- Learn more about [storage drivers](/engine/userguide/storagedriver.md), which
+- Learn more about [storage drivers](/storage/storagedriver/), which
   are not related to bind mounts or volumes, but allow you to store data in a
   container's writable layer.

storage/storagedriver/aufs-driver.md

@@ -2,6 +2,8 @@
 description: Learn how to optimize your use of AUFS driver.
 keywords: 'container, storage, driver, AUFS '
 title: Use the AUFS storage driver
+redirect_from:
+- /engine/userguide/storagedriver/aufs-driver/
 ---
 
 AUFS is a *union filesystem*. The `aufs` storage driver was previously the default
@@ -226,7 +228,7 @@ The following generic performance best practices also apply to AUFS.
 
 ## Related information
 
+* [Volumes](/storage/volumes.md)
 * [Understand images, containers, and storage drivers](imagesandcontainers.md)
 * [Select a storage driver](selectadriver.md)
-* [Btrfs storage driver in practice](btrfs-driver.md)
-* [Device Mapper storage driver in practice](device-mapper-driver.md)
+

storage/storagedriver/btrfs-driver.md

@@ -2,6 +2,8 @@
 description: Learn how to optimize your use of Btrfs driver.
 keywords: 'container, storage, driver, Btrfs '
 title: Use the BTRFS storage driver
+redirect_from:
+- /engine/userguide/storagedriver/btrfs-driver/
 ---
 
 Btrfs is a next generation copy-on-write filesystem that supports many advanced
@@ -311,7 +313,6 @@ storage driver.
 
 ## Related Information
 
+* [Volumes](/storage/volumes.md)
 * [Understand images, containers, and storage drivers](imagesandcontainers.md)
 * [Select a storage driver](selectadriver.md)
-* [AUFS storage driver in practice](aufs-driver.md)
-* [Device Mapper storage driver in practice](device-mapper-driver.md)

storage/storagedriver/device-mapper-driver.md

@@ -2,6 +2,8 @@
 description: Learn how to optimize your use of device mapper driver.
 keywords: container, storage, driver, device mapper
 title: Use the Device Mapper storage driver
+redirect_from:
+- /engine/userguide/storagedriver/device-mapper-driver/
 ---
 
 Device Mapper is a kernel-based framework that underpins many advanced
@@ -813,8 +815,6 @@ storage driver.
 
 ## Related Information
 
+* [Volumes](/storage/volumes.md)
 * [Understand images, containers, and storage drivers](imagesandcontainers.md)
 * [Select a storage driver](selectadriver.md)
-* [AUFS storage driver in practice](aufs-driver.md)
-* [Btrfs storage driver in practice](btrfs-driver.md)
-* [daemon reference](../../reference/commandline/dockerd.md#storage-driver-options)

storage/storagedriver/index.md

@@ -1,10 +1,11 @@
 ---
 description: Learn the technologies that support storage drivers.
 keywords: container, storage, driver, AUFS, btfs, devicemapper,zvfs
-title: About images, containers, and storage drivers
+title: About storage drivers
 redirect_from:
 - /en/latest/terms/layer/
 - /engine/installation/userguide/storagedriver/
+- /engine/userguide/storagedriver/imagesandcontainers/
 ---
 
 To use storage drivers effectively, it's important to know how Docker builds and
@@ -12,6 +13,13 @@ stores images, how these images are used by containers. You can use this
 information to make informed choices about the best way to persist data from
 your applications and avoid performance problems along the way.
 
+> **Note**: Storage drivers allow you to persist data in the writable layer of
+> your container. This is the least efficient way to persist data.
+> [Volumes](/storage/volumes/) or [bind mounts](/storage/bind-mounts/) provide
+> much better read and write performance, and volumes provide more security
+> and isolation than either storage drivers or bind mounts. Neither volumes nor
+> bind mounts use most of the concepts described in this topic.
+
 ## Images and layers
 
 A Docker image is built up from a series of layers. Each layer represents an
@@ -417,7 +425,5 @@ For detailed information about data volumes, see
 
 ## Related information
 
+* [Volumes](/storage/volumes.md)
 * [Select a storage driver](selectadriver.md)
-* [AUFS storage driver in practice](aufs-driver.md)
-* [Btrfs storage driver in practice](btrfs-driver.md)
-* [Device Mapper storage driver in practice](device-mapper-driver.md)

storage/storagedriver/overlayfs-driver.md

@@ -2,11 +2,13 @@
 description: Learn how to optimize your use of OverlayFS driver.
 keywords: container, storage, driver, OverlayFS
 title: Use the OverlayFS storage driver
+redirect_from:
+- /engine/userguide/storagedriver/overlayfs-driver/
 ---
 
 OverlayFS is a modern *union filesystem* that is similar to AUFS, but faster
-and with a simpler implementation. Docker provides a storage driver for
-OverlayFS.
+and with a simpler implementation. Docker provides two storage drivers for
+OverlayFS: the original `overlay`, and the newer and more stable `overlay2`.
 
 This topic refers to the Linux kernel driver as `OverlayFS` and to the Docker
 storage driver as `overlay` or `overlay2`.

storage/storagedriver/select-storage-driver.md

@@ -1,7 +1,10 @@
 ---
 description: Learn how to select the proper storage driver for your container.
-keywords: container, storage, driver, AUFS, btfs, devicemapper,zvfs
-title: Select a storage driver
+keywords: container, storage, driver, aufs, btrfs, devicemapper, zfs, overlay, overlay2
+title: Docker storage drivers
+redirect_from:
+- /engine/userguide/storagedriver/
+- /engine/userguide/storagedriver/selectadriver/
 ---
 
 Ideally, very little data is written to a container's writable layer, and you
@@ -236,3 +239,6 @@ to physical or logical disks on the Docker host.
 * [`overlay` and `overlay2` storage drivers in practice](overlayfs-driver.md)
 * [`btrfs` storage driver in practice](btrfs-driver.md)
 * [`zfs` storage driver in practice](zfs-driver.md)
+
+
+

storage/storagedriver/vfs-driver.md

@@ -2,6 +2,8 @@
 description: Learn how to optimize your use of VFS driver.
 keywords: 'container, storage, driver, vfs'
 title: Use the VFS storage driver
+redirect_from:
+- /engine/userguide/storagedriver/vfs-driver/
 ---
 
 The VFS storage driver is not a union filesystem; instead, each layer is a
@@ -130,9 +132,6 @@ same amount of room on disk. This is one of the disadvantages of using the
 
 ## Related information
 
+* [Volumes](/storage/volumes.md)
 * [Understand images, containers, and storage drivers](imagesandcontainers.md)
-* [Select a storage driver](selectadriver.md)
-* [AUFS storage driver in practice](aufs-driver.md)
-* [OverlayFS storage driver in practice](overlayfs-driver.md)
-* [Btrfs storage driver in practice](btrfs-driver.md)
-* [Device Mapper storage driver in practice](device-mapper-driver.md)
+

storage/storagedriver/zfs-driver.md

@@ -2,6 +2,8 @@
 description: Learn how to optimize your use of ZFS driver.
 keywords: 'container, storage, driver, ZFS '
 title: Use the ZFS storage driver
+redirect_from:
+- /engine/userguide/storagedriver/zfs-driver/
 ---
 
 ZFS is a next generation filesystem that supports many advanced storage

storage/tmpfs.md

@@ -2,6 +2,8 @@
 description: Using tmpfs mounts
 title: Use tmpfs mounts
 keywords: storage, persistence, data persistence, tmpfs
+redirect_from:
+- /engine/admin/volumes/tmpfs/
 ---
 
 [Volumes](volumes.md) and [bind mounts](bind-mounts.md) are mounted into the
@@ -143,4 +145,4 @@ docker run -d \
 
 - Learn about [volumes](volumes.md)
 - Learn about [bind mounts](bind-mounts.md)
-- Learn about [storage drivers](/engine/userguide/storagedriver.md)
+- Learn about [storage drivers](/storage/storagedriver/)

storage/troubleshooting_volume_errors.md

@@ -2,6 +2,8 @@
 description: Troubleshooting volume errors
 keywords: cadvisor, troubleshooting, volumes, bind-mounts
 title: Troubleshoot volume errors
+redirect_from:
+- /engine/admin/troubleshooting_volume_errors/
 ---
 
 This topic discusses errors which may occur when you use Docker volumes or bind

storage/volumes.md

@@ -5,6 +5,7 @@ keywords: storage, persistence, data persistence, volumes
 redirect_from:
 - /engine/tutorials/dockervolumes/
 - /engine/userguide/dockervolumes/
+- /engine/admin/volumes/volumes/
 ---
 
 Volumes are the preferred mechanism for persisting data generated by and used
@@ -411,4 +412,4 @@ $ docker run -d \
 
 - Learn about [bind mounts](bind-mounts.md).
 - Learn about [tmpfs mounts](tmpfs.md).
-- Learn about [storage drivers](/engine/userguide/storagedriver.md).
+- Learn about [storage drivers](/storage/storagedriver/).