From Fedora Project Wiki

Atomic Storage Clients


Kubernetes provides a mechanism for providing storage to Pods via volumes. Volumes support several underlying storage protocols, but clients are needed to support each type. Native GlusterFS and Ceph clients will be added to the Atomic host base to support these Volume types.


  • Name: mmicene
  • Email:
  • Release notes owner:

Current status

Detailed Description

By design, Docker container internal storage is ephemeral in nature and data is lost when a container is stopped. Kubernetes uses Volumes to provide a means for Pods keep data for extended periods of time and between container restarts.

A Volume in Kubernetes represents a real piece of underlying storage capacity in the infrastructure. Persistent Volumes are a way for users to "claim" a Volume without knowing the details of the particular storage environment. Persistent volumes are intended for "network volumes" like NFS shares, iSCSI devices, GlusterFS volumes, or Ceph devices. Persistent Volumes also exist past the Pod lifecycle.

In order to access the underlying storage, the appropriate drivers must be available to Kubernetes on the Atomic host. We will add the appropriate packages to support the following Volume types:

  • GlusterFS
  • RBD (Ceph Block Device)

Both projects currently have packages available and accepted in Fedora for general use. No new packaging should be required.

Benefit to Fedora

Kubernetes Volume support is currently limited to NFS and iSCSI. Adding these two open source software defined storage clients will expand the capabilities of the Atomic platform to more use cases.


  • Proposal owners:
    • Add GlusterFS client Fedora packages to Atomic package list
    • Add Ceph client Fedora packages to Atomic package list
      • The Ceph packaging will be changing to reduce the number of dependencies. This may cause some bloat in the image until fixed.
  • Other developers: N/A (not a System Wide Change)
  • Release engineering: N/A (not a System Wide Change)
  • Policies and guidelines: N/A (not a System Wide Change)
  • Trademark approval: N/A (not needed for this Change)

Upgrade/compatibility impact

This is additional functionality, not a replacement for existing. Can be safely ignored if not needed. N/A (not a System Wide Change)

How To Test

  • 0. Access to an appropriate storage cluster (gluster or ceph)
  • 1. Configure kubernetes on an Atomic host or cluster of hosts.
  • 2. Mount storage on hosts with native client
  • 3. Create a physical volume in the mount point in kubernetes
  • 4. Create a volume in kubernetes
  • 5. Use volume in pod definition

N/A (not a System Wide Change)

User Experience

N/A (not a System Wide Change)


Native client packages are owned by someone else, but are currently maintained for F23 and not slated for removal in F24. N/A (not a System Wide Change)

Contingency Plan

  • Contingency mechanism: (What to do? Who will do it?) N/A (not a System Wide Change)
  • Contingency deadline: N/A (not a System Wide Change)
  • Blocks release? N/A (not a System Wide Change), Yes/No
  • Blocks product? product


N/A (not a System Wide Change)

Release Notes