fabric-containers

Instructions

When invoked, generate code for container-based workloads on FABRIC. Two main capabilities:

1. Docker — Container deployment using post-boot scripts or runtime commands
2. Kubernetes — Multi-node K8s cluster with Flannel CNI across FABRIC sites

Help the user choose the right approach and generate complete setup code.

API Reference

Docker Images

FABRIC provides Docker-ready OS images:

• docker_rocky_8 — Rocky Linux 8 with Docker pre-configured
• docker_ubuntu_20 — Ubuntu 20.04 with Docker pre-configured

Post-Boot Docker Setup

node.add_post_boot_upload_directory('node_tools', '.')
node.add_post_boot_execute('node_tools/enable_docker.sh {{ _self_.image }}')

Post-Boot Docker Compose

node.add_post_boot_upload_directory('docker_containers', '.')
node.add_post_boot_execute('cd docker_containers/my_app ; docker compose up -d')

Patterns

Docker Container Deployment

from fabrictestbed_extensions.fablib.fablib import FablibManager

fablib = FablibManager()

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

node = slice.add_node(
    name="docker-node",
    site=fablib.get_random_site(),
    cores=4,
    ram=16,
    disk=100,
    image="docker_rocky_8",
)
node.add_fabnet()

# Enable Docker via post-boot
node.add_post_boot_upload_directory('node_tools', '.')
node.add_post_boot_execute('node_tools/enable_docker.sh {{ _self_.image }}')

slice.submit()

# Run a container
node = slice.get_node(name="docker-node")

stdout, stderr = node.execute(
    "docker run -d -it "
    "--name my_container "
    "fabrictestbed/slice-vm-rocky8-multitool:0.0.1"
)

# View containers
stdout, stderr = node.execute("docker ps -a")
print(stdout)

# Execute commands in container
stdout, stderr = node.execute("docker exec my_container ip addr list")
print(stdout)

Docker Compose via Post-Boot

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

node = slice.add_node(
    name="app-node",
    site=fablib.get_random_site(),
    cores=4,
    ram=16,
    disk=100,
    image="docker_rocky_8",
)

# Upload and start Docker + application
node.add_post_boot_upload_directory('node_tools', '.')
node.add_post_boot_execute('node_tools/enable_docker.sh {{ _self_.image }}')
node.add_post_boot_upload_directory('docker_containers', '.')
node.add_post_boot_execute('cd docker_containers/my_app ; docker compose up -d')

slice.submit()