Couple of minor changes/updates

Addressed a correction suggested by FrenchBen above and removed unnecessary raw tags for example CLIs
This commit is contained in:
Deep Debroy 2017-06-28 10:05:16 -07:00 committed by GitHub
parent 5dc4bd40ea
commit 5431d4abfe
1 changed files with 6 additions and 14 deletions

View File

@ -14,8 +14,8 @@ mode tasks and regular Docker containers can use a volume created with
Cloudstor to mount a persistent data volume. In Docker for AWS, Cloudstor has Cloudstor to mount a persistent data volume. In Docker for AWS, Cloudstor has
two `backing` options: two `backing` options:
- `relocatable` data volumes are backed by EBS. - `relocatable` data volumes which are backed by EBS.
- `shared` data volumes are backed by EFS. - `shared` data volumes which are backed by EFS.
When you use the Docker CLI to create a swarm service along with the persistent When you use the Docker CLI to create a swarm service along with the persistent
volumes used by the service tasks, you can create three different types of volumes used by the service tasks, you can create three different types of
@ -132,22 +132,18 @@ The only option available for EFS is `perfmode`. You can set `perfmode` to
`maxio` for high IO throughput: `maxio` for high IO throughput:
```bash ```bash
{% raw %}
$ docker service create \ $ docker service create \
--replicas 5 \ --replicas 5 \
--name ping3 \ --name ping3 \
--mount type=volume,volume-driver=docker4x/cloudstor:aws-v{{ edition_version }},source={{.Service.Name}}-{{.Task.Slot}}-vol5,destination=/mydata,volume-opt=perfmode=maxio \ --mount type=volume,volume-driver=docker4x/cloudstor:aws,source={{.Service.Name}}-{{.Task.Slot}}-vol5,destination=/mydata,volume-opt=perfmode=maxio \
alpine ping docker.com alpine ping docker.com
{% endraw %}
``` ```
You can also create `shared` Cloudstor volumes using the You can also create `shared` Cloudstor volumes using the
`docker volume create` CLI: `docker volume create` CLI:
```bash ```bash
{% raw %}
$ docker volume create -d "cloudstor:aws" --opt backing=shared mysharedvol1 $ docker volume create -d "cloudstor:aws" --opt backing=shared mysharedvol1
{% endraw %}
``` ```
### Use a unique volume per task using EBS ### Use a unique volume per task using EBS
@ -167,16 +163,14 @@ the following volume options are available:
Example usage: Example usage:
```bash ```bash
{% raw %}
$ docker service create \ $ docker service create \
--replicas 5 \ --replicas 5 \
--name ping3 \ --name ping3 \
--mount type=volume,volume-driver=cloudstor:aws,source={{.Service.Name}}-{{.Task.Slot}}-vol,destination=/mydata,volume-opt=backing=local,volume-opt=size=25,volume-opt=ebstype=gp2 \ --mount type=volume,volume-driver=cloudstor:aws,source={{.Service.Name}}-{{.Task.Slot}}-vol,destination=/mydata,volume-opt=backing=local,volume-opt=size=25,volume-opt=ebstype=gp2 \
alpine ping docker.com alpine ping docker.com
{% endraw %}
``` ```
This example creates and mounts a distinct Cloudstor volume backed by 25 GB EBS The above example creates and mounts a distinct Cloudstor volume backed by 25 GB EBS
volumes of type `gp2` for each task of the `ping3` service. Each task mounts its volumes of type `gp2` for each task of the `ping3` service. Each task mounts its
own volume at `/mydata/` and all files under that mountpoint are unique to the own volume at `/mydata/` and all files under that mountpoint are unique to the
task mounting the volume. task mounting the volume.
@ -198,14 +192,14 @@ $ docker volume create \
--opt ebstype=io1 \ --opt ebstype=io1 \
--opt size=25 \ --opt size=25 \
--opt iops=1000 \ --opt iops=1000 \
--opt backing=local \ --opt backing=relocatable \
mylocalvol1 mylocalvol1
{% endraw %} {% endraw %}
``` ```
Sharing the same `relocatable` Cloudstor volume across multiple tasks of a Sharing the same `relocatable` Cloudstor volume across multiple tasks of a
service or across multiple independent containers is not supported when service or across multiple independent containers is not supported when
`backing=local` is specified. Attempting to do so will result in IO errors. `backing=relocatable` is specified. Attempting to do so will result in IO errors.
### Use a unique volume per task using EFS ### Use a unique volume per task using EFS
@ -215,13 +209,11 @@ you already have too many EBS volumes or want to reduce the amount of time it
takes to transfer volume data across availability zones. takes to transfer volume data across availability zones.
```bash ```bash
{% raw %}
$ docker service create \ $ docker service create \
--replicas 5 \ --replicas 5 \
--name ping2 \ --name ping2 \
--mount type=volume,volume-driver=cloudstor:aws,source={{.Service.Name}}-{{.Task.Slot}}-vol,destination=/mydata \ --mount type=volume,volume-driver=cloudstor:aws,source={{.Service.Name}}-{{.Task.Slot}}-vol,destination=/mydata \
alpine ping docker.com alpine ping docker.com
{% endraw %}
``` ```
Here, each task has mounts its own volume at `/mydata/` and the files under that Here, each task has mounts its own volume at `/mydata/` and the files under that