Using profiles

List profiles

CIO comes installed with some example profiles. List the installed profiles with.

$ cio profile ls
PROFILE                                  DATE
MYSQL                                    Sat Aug 24 15:16:01 2019
BRONZE                                   Sat Aug 24 15:16:01 2019
SMALL                                    Sat Aug 24 15:16:01 2019
INFS                                     Sat Aug 24 15:16:01 2019
SILVER                                   Sat Aug 24 15:16:01 2019
MEDIUM                                   Sat Aug 24 15:16:01 2019
MINIO                                    Sat Aug 24 15:16:01 2019
GOLD                                     Sat Aug 24 15:16:01 2019
NGINX                                    Sat Aug 24 15:16:01 2019
LARGE                                    Sat Aug 24 15:16:01 2019

Inspect profile

Display GOLD profile

$ cio profile info GOLD
---
capacity: 20
directory: /cio/volumes
iops:
  min: 1000
  max: 2000
level: 2
local: no
provision: thin
type: ssd
service:
  autoexpand:
    enabled: no
    threshold: 80
    increment: 25
    limit: 3
  compression:
    enabled: no
    algorithm: lzo
  encryption:
    enabled: no
  replication:
    enabled: no
    destination: none
    interval: 120
    type: synchronous
  snapshot:
    enabled: no
    interval: 60
    max: 10

Save GOLD profile to file TEST in your current working directory.

$ cio profile info GOLD > TEST

Save profile

Edit profile TEST with your editor and save it to the cio datastore.

$ cio profile add TEST

Create volume

You can create a volume with the TEST profile using the --opt flag in a docker volume create command.

$ docker volume create --driver cio --name test --opt profile=TEST

Use with volume option in docker run command.

$ docker run -it --mount source=test,target=/tmp,volume-driver=cio,volume-opt=profile=TEST \
--name test alpine sh

Use with --mount flag in a docker service create command.

$ docker service create \
--mount source=test,target=/var/lib/mysql,volume-driver=cio,volume-opt=profile=TEST \
--replicas 1 \
--detach=false \
-e MYSQL_ROOT_PASSWORD=mysecret \
--name mysql \
mysql

To use a profile in a cio volume create command, simply reference it using the -p or --profile flag:

$ cio volume create test --profile TEST

Remove profile

To remove a profile from the cio datastore use cio profile rm:

$ cio profile rm TEST