From ac9dff580cd9f2ce6cb2fbaeb8edf0f4069312aa3decc996fe1c72ec7ab65169 Mon Sep 17 00:00:00 2001 From: Stephan Kulow Date: Fri, 12 Sep 2014 08:03:38 +0000 Subject: [PATCH] Accepting request 248639 from Virtualization Automatic submission by obs-autosubmit OBS-URL: https://build.opensuse.org/request/show/248639 OBS-URL: https://build.opensuse.org/package/show/openSUSE:Factory/docker?expand=0&rev=6 --- README_SUSE.md | 35 ++++++++++++++++++++++++++++------- docker.changes | 5 +++++ 2 files changed, 33 insertions(+), 7 deletions(-) diff --git a/README_SUSE.md b/README_SUSE.md index 237cfe8..fb0ee48 100644 --- a/README_SUSE.md +++ b/README_SUSE.md @@ -106,19 +106,40 @@ At the time of writing, upstream is working on a `libvirt-lxc` driver. ## Storage drivers -Docker images are made by series of stacked layers. The recommended driver is -DeviceMapper one, which is also the default choice. +Docker supports different storage drivers: -The Docker packages ships also an experimental BTRFS driver. To use this driver -Docker daemon must run on a BTRFS partition already prepared by the host system. + * `vfs`: this driver is automatically used when the Docker host filesystem + does not support copy-on-write. This is a simple driver which does not offer + some of the advantages of Docker (like sharing layers, more on that in the + next sections). It is highly reliable but also slow. + * `devicemapper`: this driver relies on the device-mapper thin provisioning + module. It supports copy-on-write, hence it offers all the advantages of + Docker. + * `btrfs`: this driver relies on Btrfs to provide all the features required + by Docker. To use this driver the `/var/lib/docker` directory must be on a + btrfs filesystem. + * `AUFS`: this driver relies on AUFS union filesystem. Neither the upstream + kernel nor the SUSE one supports this filesystem. Hence the AUFS driver is + not built into the SUSE Docker package. -To use the experimental BTRFS driver the Docker daemon must be started with this -command: +It is possible to specify which driver to use by changing the value of the +`DOCKER_OPTS` variable defined inside of the `/etc/sysconfig/docker` file. +This can be done either manually or using &yast; by browsing to: + * System + * /etc/sysconfig Editor + * System + * Management + * DOCKER_OPTS +menu and entering the `-s storage_driver` string. +For example, to force the usage of the `devicemapper` driver +enter the following text: ``` -docker -d -s btrfs +DOCKER_OPTS="-s devicemapper ``` +It is recommended to have `/var/lib/docker` mounted on a different filesystem +to not affect the Docker host OS in case of a filesystem corruption. # Setting up a Docker host diff --git a/docker.changes b/docker.changes index af5ff1b..d45c660 100644 --- a/docker.changes +++ b/docker.changes @@ -1,3 +1,8 @@ +------------------------------------------------------------------- +Thu Sep 4 15:41:39 UTC 2014 - fcastelli@suse.com + +- Updates to SUSE's readme file. + ------------------------------------------------------------------- Mon Aug 25 07:49:48 UTC 2014 - fcastelli@suse.com