Through shared volumes (also known as a global namespace), a single volume’s filesystem is concurrently available to multiple containers running on multiple hosts.

You do not need to use shared volumes to have your data accessible on any host in the cluster. Any PX volumes can be exclusively accessed from any host as long as they are not simultaneously accessed. Shared volumes are for providing simultaneous (concurrent or shared) access to a volume from multiple hosts at the same time.

A typical pattern is for a single container to have one or more volumes. Conversely, many scenarios would benefit from multiple containers being able to access the same volume, possibly from different hosts. Accordingly, the shared volume feature enables a single volume to be read/write accessible by multiple containers. Example use cases include:

  • A technical computing workload sourcing its input and writing its output to a shared volume.
  • Scaling a number of Wordpress containers based on load while managing a single shared volume.
  • Collecting logs to a central location

Usage of shared volumes for databases is not recommended, since they have a small metadata overhead.

Create shared volumes

To create a Portworx shared volume, use the pxctl command or docker volume create.

# pxctl volume create my_shared_vol --shared --size=5 --repl=3
Shared volume successfully created: 944424689751331159
# pxctl volume list
ID			            NAME		        SIZE	   HA	  SHARED	STATUS
944424689751331159	    my_shared_vol	    5.0 GiB	   3	  yes	    up - detached

Note the “SHARED” status of the volume, in the above output.

You can also use docker volume create as

# docker volume create --driver pxd --opt shared=true --opt size=10G demovol

Use shared volumes

Shared volumes are accessed in the same way any volume would be used in Docker. For example:

host1# docker run -it --name box1  -v my_shared_vol:/data --volume-driver=pxd  busybox sh

Share a volume from different hosts

A shared volume can be accessed by containers on different hosts. Any host in the cluster can access a shared volume by name. For example:

host2# docker run -it --name box1  -v my_shared_vol:/data --volume-driver=pxd  busybox sh

All writes and modifications to files and directories will be immediately available to consumers of the shared volume. Concurrency of files is handled by the volume’s filesystem.

Use shared volumes via NFS

Any nodes outside of the Portworx cluster can access a shared volume through NFS with the following format:

mount HOSTNAME:/var/lib/osd/pxns/my_shared_vol  /local_mnt