Skip to main content

Storage Commands

CLI commands for managing storage systems, importing storage, and exposing cluster storage

Storage Commands

The Vantage CLI provides a hierarchical command structure for managing storage:

vantage storage
├── system        # Manage storage system deployments (CephNFS, etc.)
├── import        # Import storage into cluster namespaces
│   ├── nfs       # NFS-specific import commands
│   ├── cephfs    # CephFS-specific import commands
│   └── internal  # Cross-namespace PVC imports
├── expose        # Expose cluster storage to external clients
│   ├── cephfs    # CephFS external expose commands
│   └── nfs       # NFS external expose commands
├── create        # Create a PVC
├── delete        # Delete a PVC
├── get           # Get PVC details
├── list          # List PVCs
└── list-available # List available storage classes

Storage System Commands​

Manage storage system deployments (CephNFS, CephFS infrastructure, etc.).

Create a Storage System​

vantage storage system create <name> \
  --cluster <cluster> \
  --type <system-type> \
  [--namespace <ns>] \
  [--config-json '{"key": "value"}']

Example — deploy a CephNFS system:

vantage storage system create my-nfs \
  --cluster prod-cluster \
  --type cephnfs \
  --namespace vantage-rook-ceph

Get Storage System Details​

vantage storage system get <name> --cluster <cluster>

List All Storage Systems​

vantage storage system list --cluster <cluster>

Update a Storage System​

vantage storage system update <name> \
  --cluster <cluster> \
  --config-json '{"server_count": 2}'

Delete a Storage System​

vantage storage system delete <name> --cluster <cluster> [--force]

Import Commands​

Import storage into cluster namespaces. Organised by storage type.

NFS Import​

Create NFS Import​

vantage storage import nfs create <pvc-name> \
  --cluster <cluster> \
  --nfs-server <hostname-or-ip> \
  --nfs-share <export-path> \
  [--namespace <ns>] \
  [--capacity 100Gi] \
  [--access-mode ReadWriteMany] \
  [--read-only]

Example:

vantage storage import nfs create datasets \
  --cluster prod-cluster \
  --nfs-server nas01.internal \
  --nfs-share /exports/ml-datasets \
  --capacity 1Ti

Create External NFS Import​

Import an NFS server from outside the cluster:

vantage storage import nfs create-external <name> \
  --cluster <cluster> \
  --nfs-server <hostname-or-ip> \
  --nfs-share <export-path> \
  --namespace <ns> \
  [--capacity 100Gi] \
  [--access-mode ReadWriteMany]

CephFS Import​

Create CephFS Import​

vantage storage import cephfs create <pvc-name> \
  --cluster <cluster> \
  --source-pvc <source-pvc-name> \
  --source-namespace <source-ns> \
  [--namespace <ns>] \
  [--capacity 100Gi]

Example:

vantage storage import cephfs create shared-ceph \
  --cluster prod-cluster \
  --source-pvc shared-storage \
  --source-namespace vantage-system

Create External CephFS Import​

Import from an external (non-Rook) Ceph cluster:

vantage storage import cephfs create-external <name> \
  --cluster <cluster> \
  --ceph-monitors "10.0.0.1:6789,10.0.0.2:6789" \
  --ceph-client <client-name> \
  --ceph-client-key "AQD...==" \
  --ceph-fs-name <fs-name> \
  [--ceph-root-path /] \
  --namespace <ns> \
  [--capacity 500Gi]

Internal (Cross-Namespace) Import​

Expose an existing PVC to another namespace:

Create Cross-Namespace Import​

vantage storage import internal create <target-pvc-name> \
  --cluster <cluster> \
  --source-pvc <source-pvc> \
  --source-namespace <source-ns> \
  [--namespace <target-ns>] \
  [--capacity 100Gi] \
  [--access-mode ReadWriteMany] \
  [--read-only]

Example — expose shared-storage to your namespace:

vantage storage import internal create shared-storage \
  --cluster prod-cluster \
  --source-pvc shared-storage \
  --source-namespace vantage-system \
  --capacity 500Gi

Get / List / Delete Cross-Namespace Imports​

vantage storage import internal get <pvc-name> --cluster <cluster> [--namespace <ns>]
vantage storage import internal list --cluster <cluster> [--namespace <ns>]
vantage storage import internal delete <pvc-name> --cluster <cluster> [--namespace <ns>] [--force]

Shared Import Commands​

These commands operate across all import types (NFS, CephFS, internal):

# Get details of any import
vantage storage import get <pvc-name> --cluster <cluster> [--namespace <ns>]

# List all imports in a namespace
vantage storage import list --cluster <cluster> [--namespace <ns>]

# Delete any import
vantage storage import delete <pvc-name> --cluster <cluster> [--namespace <ns>] [--force]

# External import lifecycle
vantage storage import get-external <name> --cluster <cluster>
vantage storage import list-external --cluster <cluster> [--namespace <ns>]
vantage storage import delete-external <name> --cluster <cluster> [--force]
vantage storage import external-status <name> --cluster <cluster>
vantage storage import external-mount-info <name> --cluster <cluster>
vantage storage import external-config <name> --cluster <cluster> [--json]

Expose Commands​

Expose cluster storage to clients outside the Kubernetes cluster.

CephFS External Expose​

# Create
vantage storage expose cephfs create <name> \
  --cluster <cluster> \
  [--ceph-client <client-name>] \
  [--mds-path /volumes/csi] \
  [--osd-pool vantage-cephfs-data] \
  [--expose-monitors] \
  [--monitor-service-type NodePort]

# Get details
vantage storage expose cephfs get <name> --cluster <cluster>

# List all
vantage storage expose cephfs list --cluster <cluster>

# Delete
vantage storage expose cephfs delete <name> --cluster <cluster> [--force]

# Get mount commands
vantage storage expose cephfs mount-commands <name> --cluster <cluster>

# Get credentials
vantage storage expose cephfs credentials <name> --cluster <cluster>

# Get status
vantage storage expose cephfs status <name> --cluster <cluster>

NFS External Expose​

# Create
vantage storage expose nfs create <name> \
  --cluster <cluster> \
  --source-pvc <pvc-name> \
  --source-namespace <ns>

# Get details
vantage storage expose nfs get <name> --cluster <cluster>

# Delete
vantage storage expose nfs delete <name> --cluster <cluster> [--force]

Common Options​

OptionDescription
--cluster, -cCluster name (required)
--namespace, -nTarget namespace (default: derived from your username)
--jsonOutput in JSON format
--force, -fSkip confirmation prompt (delete commands)

Notes​

  • All operations are idempotent — re-importing or re-exposing the same storage returns the existing resource
  • Namespaces are created automatically if they don't exist, with Istio sidecar injection enabled
  • Only resources managed by Vantage (labeled with app.kubernetes.io/managed-by=vantage-storage) can be deleted through these commands
  • The --namespace flag defaults to your user namespace derived from your login email
⌘I