provider/docker: Add docker_volume resource

This commit is contained in:
Colin Hebert 2016-01-15 17:33:17 +00:00 committed by James Nugent
parent 9806e6ea9a
commit 5f2147a9d5

38
r/volume.html.markdown Normal file
View file

@ -0,0 +1,38 @@
---
layout: "docker"
page_title: "Docker: docker_volume"
sidebar_current: "docs-docker-resource-volume"
description: |-
Creates and destroys docker volumes.
---
# docker\_volume
Creates and destroys a volume in Docker. This can be used alongside
[docker\_container](/docs/providers/docker/r/container.html)
to prepare volumes that can be shared across containers.
## Example Usage
```
# Creates a docker volume "shared_volume".
resource "docker_volume" "shared_volume" {
name = "shared_volume"
}
# Reference the volume with ${docker_volume.shared_volume.name}
```
## Argument Reference
The following arguments are supported:
* `name` - (Optional, string) The name of the Docker volume (generated if not provided).
* `driver` - (Optional, string) Driver type for the volume (defaults to local).
* `driver_opts` - (Optional, map of strings) Options specific to the driver.
## Attributes Reference
The following attributes are exported in addition to the above configuration:
* `mountpoint` (string) - The mountpoint of the volume.