moby--moby/volume
Brian Goff fc7b904dce Add new `HostConfig` field, `Mounts`.
`Mounts` allows users to specify in a much safer way the volumes they
want to use in the container.
This replaces `Binds` and `Volumes`, which both still exist, but
`Mounts` and `Binds`/`Volumes` are exclussive.
The CLI will continue to use `Binds` and `Volumes` due to concerns with
parsing the volume specs on the client side and cross-platform support
(for now).

The new API follows exactly the services mount API.

Example usage of `Mounts`:

```
$ curl -XPOST localhost:2375/containers/create -d '{
  "Image": "alpine:latest",
  "HostConfig": {
    "Mounts": [{
      "Type": "Volume",
      "Target": "/foo"
      },{
      "Type": "bind",
      "Source": "/var/run/docker.sock",
      "Target": "/var/run/docker.sock",
      },{
      "Type": "volume",
      "Name": "important_data",
      "Target": "/var/data",
      "ReadOnly": true,
      "VolumeOptions": {
	"DriverConfig": {
	  Name: "awesomeStorage",
	  Options: {"size": "10m"},
	  Labels: {"some":"label"}
	}
      }]
    }
}'
```

There are currently 2 types of mounts:

  - **bind**: Paths on the host that get mounted into the
    container. Paths must exist prior to creating the container.
  - **volume**: Volumes that persist after the
    container is removed.

Not all fields are available in each type, and validation is done to
ensure these fields aren't mixed up between types.

Signed-off-by: Brian Goff <cpuguy83@gmail.com>
2016-09-13 09:55:35 -04:00
..
drivers test: fix trivial code convention noncompliance 2016-09-12 07:36:52 +00:00
local Add requested comments about old buggy behavior 2016-08-18 10:07:22 -04:00
store test: fix trivial code convention noncompliance 2016-09-12 07:36:52 +00:00
testutils test: fix trivial code convention noncompliance 2016-09-12 07:36:52 +00:00
validate.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
validate_test.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
validate_test_unix.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
validate_test_windows.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
volume.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
volume_copy.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
volume_copy_unix.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
volume_copy_windows.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
volume_propagation_linux.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
volume_propagation_linux_test.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
volume_propagation_unsupported.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
volume_test.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
volume_unix.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00
volume_windows.go Add new `HostConfig` field, `Mounts`. 2016-09-13 09:55:35 -04:00