Skip to content

Commit c61b565

Browse files
committed
docs/deprecated: remove "disabled by default" for AuFS, overlay
These drivers have been removed in docker 24.0, so it's no longer possible to enable them. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
1 parent 9f537a7 commit c61b565

1 file changed

Lines changed: 9 additions & 45 deletions

File tree

docs/deprecated.md

Lines changed: 9 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -525,12 +525,12 @@ option was no longer used.
525525
**Deprecated in Release: v19.03**
526526
**Removed in Release: v24.0**
527527

528-
The `aufs` storage driver is deprecated in favor of `overlay2`, and will
529-
be removed in a future release. Users of the `aufs` storage driver are
530-
recommended to migrate to a different storage driver, such as `overlay2`, which
531-
is now the default storage driver.
528+
The `aufs` storage driver is deprecated in favor of `overlay2`, and has been
529+
removed in a Docker Engine v24.0. Users of the `aufs` storage driver must
530+
migrate to a different storage driver, such as `overlay2`, before upgrading
531+
to Docker Engine v24.0.
532532

533-
The `aufs` storage driver facilitates running Docker on distros that have no
533+
The `aufs` storage driver facilitated running Docker on distros that have no
534534
support for OverlayFS, such as Ubuntu 14.04 LTS, which originally shipped with
535535
a 3.14 kernel.
536536

@@ -539,58 +539,22 @@ is available to all supported distros (as they are either on kernel 4.x, or have
539539
support for multiple lowerdirs backported), there is no reason to continue
540540
maintenance of the `aufs` storage driver.
541541

542-
#### Disabled by default in v23.0
543-
544-
Docker already prevented deprecated storage drivers from being automatically
545-
selected on new installations, but continued to use these drivers when upgrading
546-
existing installations. Starting with the v23.0 release, the Docker Engine will
547-
fail to start if a deprecated storage driver is used (see [moby#43378](https://github.com/moby/moby/pull/43378):
548-
549-
```console
550-
failed to start daemon: error initializing graphdriver: prior storage driver
551-
aufs is deprecated and will be removed in a future release; update the the daemon
552-
configuration and explicitly choose this storage driver to continue using it;
553-
visit https://docs.docker.com/go/storage-driver/ for more information.
554-
```
555-
556-
To continue using the storage driver, update the daemon configuration to use
557-
explicitly use the given storage driver. Users are encouraged to migrate to
558-
different storage driver.
559-
560542
### Legacy overlay storage driver
561543

562544
**Deprecated in Release: v18.09**
563545
**Removed in Release: v24.0**
564546

565547
The `overlay` storage driver is deprecated in favor of the `overlay2` storage
566548
driver, which has all the benefits of `overlay`, without its limitations (excessive
567-
inode consumption). The legacy `overlay` storage driver will be removed in a future
568-
release. Users of the `overlay` storage driver should migrate to the `overlay2`
569-
storage driver.
549+
inode consumption). The legacy `overlay` storage driver has been removed in
550+
Docker Engine v24.0. Users of the `overlay` storage driver should migrate to the
551+
`overlay2` storage driver before upgrading to Docker Engine v24.0.
570552

571553
The legacy `overlay` storage driver allowed using overlayFS-backed filesystems
572554
on pre 4.x kernels. Now that all supported distributions are able to run `overlay2`
573555
(as they are either on kernel 4.x, or have support for multiple lowerdirs
574556
backported), there is no reason to keep maintaining the `overlay` storage driver.
575557

576-
#### Disabled by default in v23.0
577-
578-
Docker already prevented deprecated storage drivers from being automatically
579-
selected on new installations, but continued to use these drivers when upgrading
580-
existing installations. Starting with the v23.0 release, the Docker Engine will
581-
fail to start if a deprecated storage driver is used (see [moby#43378](https://github.com/moby/moby/pull/43378):
582-
583-
```console
584-
failed to start daemon: error initializing graphdriver: prior storage driver
585-
overlay is deprecated and will be removed in a future release; update the the daemon
586-
configuration and explicitly choose this storage driver to continue using it;
587-
visit https://docs.docker.com/go/storage-driver/ for more information.
588-
```
589-
590-
To continue using the storage driver, update the daemon configuration to use
591-
explicitly use the given storage driver. Users are encouraged to migrate to
592-
different storage driver.
593-
594558
### Device mapper storage driver
595559

596560
**Deprecated in Release: v18.09**
@@ -602,7 +566,7 @@ recommended to migrate to a different storage driver, such as `overlay2`, which
602566
is now the default storage driver.
603567

604568
The `devicemapper` storage driver facilitates running Docker on older (3.x) kernels
605-
that have no support for other storage drivers (such as overlay2, or AUFS).
569+
that have no support for other storage drivers (such as overlay2, or btrfs).
606570

607571
Now that support for `overlay2` is added to all supported distros (as they are
608572
either on kernel 4.x, or have support for multiple lowerdirs backported), there

0 commit comments

Comments
 (0)