fabric-recipes

Instructions

When invoked, generate code for deploying common applications and services on FABRIC. Available recipes:

1. Apache Web Server — Multi-tier web service with firewall
2. Ollama LLM — Local large language model inference on GPU nodes
3. Pegasus/HTCondor — Scientific workflow engine across multiple sites
4. DHCP Server — Dynamic IP allocation on L2 networks
5. BGP Peering — PEERING client for BGP route advertisement
6. pmacctd — NetFlow/sFlow traffic accounting
7. Sub-Interfaces — VLAN-tagged virtual interfaces

Help the user choose the right recipe and generate complete code.

Patterns

Apache Web Server

from fabrictestbed_extensions.fablib.fablib import FablibManager
from ipaddress import IPv4Network

fablib = FablibManager()

site = fablib.get_random_site()
slice = fablib.new_slice(name="apache-web-server")

subnet = IPv4Network("192.168.1.0/24")
net = slice.add_l2network(name="net1", subnet=subnet)

server = slice.add_node(name="server", site=site, image="default_ubuntu_20")
server_iface = server.add_component(model="NIC_Basic", name="nic1").get_interfaces()[0]
server_iface.set_mode("auto")
net.add_interface(server_iface)

client = slice.add_node(name="client", site=site, image="default_ubuntu_20")
client_iface = client.add_component(model="NIC_Basic", name="nic1").get_interfaces()[0]
client_iface.set_mode("auto")
net.add_interface(client_iface)

slice.submit()

server = slice.get_node(name="server")

# Install Apache
server.execute("sudo apt-get update && sudo apt-get install -y apache2")

# Configure firewall
server.execute("sudo ufw allow 'Apache' && sudo ufw allow ssh && echo 'y' | sudo ufw enable")

# Custom document root
apache_root = "/home/ubuntu/apache_contents"
server.execute(f"mkdir -p {apache_root}")
server.execute(
    f"sudo sed -i 's,/var/www/html,{apache_root},g' "
    "/etc/apache2/sites-available/000-default.conf"
)
server.execute("sudo service apache2 restart")

# Upload content
server.execute(f"echo '<h1>Hello FABRIC</h1>' > {apache_root}/index.html")

# Test from client
server_addr = server.get_interface(network_name="net1").get_ip_addr()
client = slice.get_node(name="client")
stdout, _ = client.execute(f"curl http://{server_addr}")
print(stdout)