Skip to main content

CephFS

Attach a CephFS filesystem from an internal PVC, an external Ceph cluster, or a system storage class.

CephFS

Attach a CephFS filesystem from an internal PVC, an external Ceph cluster, or a system storage class.

TimeAbout 5 minutes
You will needA Kubernetes cluster in ready state
OutcomeA CephFS mount available to workloads

CephFS mounts connect your Kubernetes workloads to a Ceph distributed filesystem. Vantage supports three source modes depending on where your Ceph storage lives.

Prerequisites

A Kubernetes cluster in Connected state.

Additional prerequisites depend on the source mode, see below.

Create a CephFS mount

Open Storage

Go to Clusters, select your Kubernetes cluster, then click the Storage tab.

Select the CephFS tab

Click CephFS at the top of the Storage page.

Click Create CephFS

Select a namespace

Choose the namespace this mount will be available in.

Enter a name

Lowercase letters, numbers, and hyphens.

Choose a source mode

Fill in the required fields for your chosen mode:

Internal: Backed by an existing PVC on the cluster:

  • Source Namespace: The namespace of the backing PVC.
  • Source PVC: Select the PVC.

External: Connects directly to a standalone Ceph cluster:

  • Ceph Monitors: One host:port address per line (e.g. ceph-mon.example.com:6789).
  • Client Name: The Ceph client identity (e.g. admin).
  • Client Key: The client's CephX authentication key. Click the eye icon to reveal.
  • Filesystem Name: The name of the CephFS filesystem to mount.
  • Root Path: The path within the filesystem to mount as root (e.g. /).

System: Uses a cluster-level Ceph integration managed by your cluster administrator:

  • System Type: Choose cephfs (filesystem) or cephnfs (NFS gateway backed by Ceph).
  • Storage Class: Select the storage class that corresponds to the system Ceph integration.

Set advanced options (optional)

  • Access Modes: Control read/write access. Default is ReadWriteMany.
  • Read Only: Force read-only access.
  • Mount Options: Additional mount flags, one per line.
  • Config: Raw JSON for additional CephFS CSI driver configuration.

Click Create

Success looks like this: the CephFS filesystem is attached, and workloads can read and write to the mounted path.

The System source mode requires cluster-level Ceph configuration by a cluster administrator. If you don't see the storage class you need, contact your cluster admin.

Ask AI
Ask a question about Vantage Compute...