fabric-resource-discovery

Instructions

When the user asks about FABRIC sites, resources, available hardware, images, or capacity, generate code to discover and query testbed resources. This skill is also auto-invoked when context suggests the user needs resource information.

Always assume FABlib is already initialized as fablib. If unsure, prepend initialization code.

API Reference

Site Discovery

# List all sites with details
fablib.list_sites(
    output=None,       # "text", "pandas", "json", "list" (default: pandas in notebook)
    fields=None,       # List of field names to display
    quiet=False,       # Suppress printed output
    filter_function=None,  # Lambda to filter sites
    pretty_names=True,     # Use human-readable field names
    start=None,        # datetime: future availability window start
    end=None,          # datetime: future availability window end
)

# List hosts at sites
fablib.list_hosts(
    output=None,
    fields=None,
    quiet=False,
    filter_function=None,
)

# Get a random site (useful for testing)
fablib.get_random_site(
    avoid=None,           # List of site names to avoid
    filter_function=None, # Lambda to filter eligible sites
    update=True,          # Refresh resource data
) -> str

# Get multiple random sites
fablib.get_random_sites(
    count=1,
    avoid=None,
    filter_function=None,
    update=True,
) -> list[str]

Image Discovery

# Get available OS images
fablib.get_image_names() -> dict[str, dict]
# Returns: {"image_name": {"default_user": "...", "description": "..."}, ...}

Common Images

• default_ubuntu_24 — Ubuntu 24.04 (default if not specified)
• default_ubuntu_22 — Ubuntu 22.04
• default_ubuntu_20 — Ubuntu 20.04
• default_centos_9_stream — CentOS 9 Stream
• default_centos_8 — CentOS 8
• default_rocky_9 — Rocky Linux 9
• default_rocky_8 — Rocky Linux 8
• default_debian_12 — Debian 12
• default_fedora_41 — Fedora 41

Component Model Constants

Use these string values with node.add_component(model=...):