DigitalOcean¶
Block Storage
DO Block Storage>¶
The DOBS plug-in can be installed with the following command:
$ docker plugin install rexray/dobs \
DOBS_REGION=sfo2 \
DOBS_TOKEN=0907868f343d86076f261958123638248ae2321434dd4f1b74773ddb9320de43
Requirements¶
The DOBS plug-in requires that your DigitalOcean droplet is running in a region that supports block storage.
NOTE: DigitalOcean volumes cannot be created if their name contains an underscore.
Docker will automatically append prefixes with underscores to your volume names when
they are created as part of a compose file, so if you're creating volumes with this plugin
using compose (or stack deploy), be sure to set DOBS_CONVERTUNDERSCORES
to true
.
Privileges¶
The DOBS plug-in requires the following privileges:
Type | Value |
---|---|
network | host |
mount | /dev |
allow-all-devices | true |
capabilities | CAP_SYS_ADMIN |
Configuration¶
The following environment variables can be used to configure the DOBS plug-in:
Environment Variable | Description | Default | Required |
---|---|---|---|
DOBS_CONVERTUNDERSCORES |
Set to true if the plugin will create volumes at DigitalOcean via e.g. a docker-compose.yml file |
false |
|
DOBS_REGION |
The region where volumes should be created | ✓ | |
DOBS_STATUSINITIALDELAY |
Time duration used to wait when polling volume status | 100ms |
|
DOBS_STATUSMAXATTEMPTS |
Number of times the status of a volume will be queried before giving up | 10 |
|
DOBS_STATUSTIMEOUT |
Maximum length of time that polling for volume status can occur | 2m |
|
DOBS_TOKEN |
Your DigitalOcean access token | ✓ | |
HTTP_PROXY |
Address of HTTP proxy server to gain access to API endpoint |