fabric-storage

Instructions

When invoked, generate code to configure storage on FABRIC nodes. There are three storage types:

1. Local Disk — Default VM disk, sized via disk parameter in add_node()
2. NVMe — High-performance Intel P4510 NVMe SSD added as a component
3. Persistent Storage — Project-level volumes that persist across slices

Help the user choose the right storage type and generate the full setup code including formatting and mounting.

API Reference

Local Disk (Default)

Configured at node creation time:

node = slice.add_node(name="node1", disk=100)  # 100 GB local disk

NVMe Component

# Add NVMe to a node
node.add_component(model="NVME_P4510", name="nvme1")

# After slice submit, get storage object
storage = node.get_storage("nvme1")

# Get device name (e.g., /dev/vdb)
device_name = storage.get_device_name()

# Auto-configure NVMe (partition, format, mount)
storage.configure_nvme(mount_point="")  # Default: /mnt/{device_name}

Finding sites with NVMe:

fablib.get_random_site(
    filter_function=lambda x: x["nvme_available"] > 0
)

Persistent Storage

# Attach a pre-created persistent storage volume
node.add_storage(
    name: str,                # Name of the storage volume (must be pre-created in project)
    auto_mount: bool = False, # Auto-mount at /mnt/<name>
) -> Component

# After submit, get storage object and device name
storage = node.get_storage("volume-name")
device_name = storage.get_device_name()

Persistent storage volumes are created at the project level via the FABRIC portal, not through FABlib API.

Patterns

NVMe Storage Setup (Using configure_nvme)

from fabrictestbed_extensions.fablib.fablib import FablibManager

fablib = FablibManager()

# Find a site with NVMe
site = fablib.get_random_site(
    filter_function=lambda x: x["nvme_available"] > 0
)

slice = fablib.new_slice(name="nvme-experiment")

node = slice.add_node(
    name="storage-node",
    site=site,
    cores=4,
    ram=16,
    disk=50,
    image="default_ubuntu_24",
)
node.add_component(model="NVME_P4510", name="nvme1")

slice.submit()