1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/runconfig
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
..
fixtures Move the runconfig.Parse() function into the runconfig/opts package. 2016-01-04 12:06:29 -05:00
opts validate build-arg 2016-09-12 18:02:21 +08:00
compare.go Add engine-api types to docker 2016-09-07 11:05:58 -07:00
compare_test.go Add engine-api types to docker 2016-09-07 11:05:58 -07:00
config.go Add new HostConfig field, Mounts. 2016-09-13 09:55:35 -04:00
config_test.go Add engine-api types to docker 2016-09-07 11:05:58 -07:00
config_unix.go Add engine-api types to docker 2016-09-07 11:05:58 -07:00
config_windows.go Add engine-api types to docker 2016-09-07 11:05:58 -07:00
errors.go Add new HostConfig field, Mounts. 2016-09-13 09:55:35 -04:00
hostconfig.go Add engine-api types to docker 2016-09-07 11:05:58 -07:00
hostconfig_solaris.go Add engine-api types to docker 2016-09-07 11:05:58 -07:00
hostconfig_test.go Add engine-api types to docker 2016-09-07 11:05:58 -07:00
hostconfig_unix.go Add engine-api types to docker 2016-09-07 11:05:58 -07:00
hostconfig_windows.go Add engine-api types to docker 2016-09-07 11:05:58 -07:00
streams.go Improve performance/reduce allocs of bytespipe 2016-04-05 13:06:04 -04:00