DigitalOcean

Block Storage


Overview

Thanks to the efforts of our tremendous community, libStorage also has built-in support for DigitalOcean!

DO Block Storage

The DigitalOcean Block Storage (DOBS) driver registers a driver named dobs with the libStorage service registry and is used to attach and mount DigitalOcean block storage devices to DigitalOcean instances.

Requirements

The DigitalOcean block storage driver has the following requirements:

Configuration

The following is an example with all possible fields configured. For a running example see the Examples section.

dobs:
  token:  123456
  region: nyc1
  statusMaxAttempts: 10
  statusInitialDelay: 100ms
  statusTimeout: 2m
  convertUnderscores: false

Configuration Notes

Note

The DigitalOcean service currently only supports block storage volumes in specific regions. Make sure to use a supported region.

The standard environment variable for the DigitalOcean access token is DIGITALOCEAN_ACCESS_TOKEN. However, the environment variable mapped to this driver's dobs.token property is DOBS_TOKEN. This choice was made to ensure that the driver must be explicitly configured for access instead of detecting a default token that may not be intended for the driver.

Examples

Below is a full config.yml that works with DOBS

libstorage:
  # The libstorage.service property directs a libStorage client to direct its
  # requests to the given service by default. It is not used by the server.
  service: dobs
  server:
    services:
      dobs:
        driver: dobs
        dobs:
          token: 123456
          region: nyc1