feat: add FlatRacoon manifest, containerlab topology, and K8s job

Add bgp-backbone-lab.manifest.ncl for orchestrator module discovery.
Create minimal 3-router eBGP topology (spine + 2 leaves) using FRRouting.
Add K8s Job manifest for in-cluster containerlab deployment.
Update justfile with deploy/destroy recipes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Jonathan D.A. Jewell

bgp-backbone-lab.manifest.ncl

@@ -0,0 +1,17 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# bgp-backbone-lab module manifest for FlatRacoon orchestrator
+
+{
+  name = "bgp-backbone-lab",
+  version = "0.1.0",
+  layer = 'network,
+  description = "BGP backbone lab with containerlab topology for eBGP peering simulation using FRRouting",
+  repo = "github.com/hyperpolymath/bgp-backbone-lab",
+  requires = ["containerlab"],
+  provides = ["bgp-peering", "backbone-routing", "route-reflection"],
+  config_schema = "configs/schema.ncl",
+  health_endpoint = null,
+  metrics_endpoint = null,
+  deployment_mode = "kubectl",
+  namespace = "bgp-lab",
+}

justfile

@@ -1,12 +1,33 @@
-# SPDX-License-Identifier: PMPL-1.0
-# Justfile - hyperpolymath standard task runner
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# Justfile - BGP backbone lab deployment automation
 
 default:
     @just --list
 
-# Build the project
+# Deploy BGP lab topology via containerlab
+deploy:
+    @echo "Deploying BGP backbone lab..."
+    containerlab deploy --topo topologies/flatracoon-bgp.clab.yml
+    @echo "BGP lab deployed"
+
+# Destroy BGP lab topology
+destroy:
+    @echo "Destroying BGP backbone lab..."
+    containerlab destroy --topo topologies/flatracoon-bgp.clab.yml
+    @echo "BGP lab destroyed"
+
+# Deploy via K8s Job (for in-cluster deployment)
+deploy-k8s:
+    kubectl apply -f manifests/containerlab-job.yaml
+    @echo "K8s containerlab job submitted"
+
+# Show topology status
+status:
+    containerlab inspect --topo topologies/flatracoon-bgp.clab.yml 2>/dev/null || echo "Not deployed"
+
+# Build the project (ABI/FFI compilation)
 build:
-    @echo "Building..."
+    @echo "Building ABI definitions..."
 
 # Run tests
 test:
@@ -30,4 +51,3 @@ check: lint test
 # Prepare a release
 release VERSION:
     @echo "Releasing {{VERSION}}..."
-

manifests/containerlab-job.yaml

@@ -0,0 +1,58 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# K8s Job to deploy the containerlab BGP topology
+apiVersion: batch/v1
+kind: Job
+metadata:
+  name: bgp-lab-deploy
+  namespace: bgp-lab
+  labels:
+    app.kubernetes.io/name: bgp-backbone-lab
+    app.kubernetes.io/component: topology-deployer
+    app.kubernetes.io/part-of: flatracoon
+spec:
+  backoffLimit: 3
+  ttlSecondsAfterFinished: 3600
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: bgp-backbone-lab
+    spec:
+      restartPolicy: Never
+      serviceAccountName: containerlab-runner
+      containers:
+        - name: containerlab
+          image: ghcr.io/srl-labs/containerlab:latest
+          command:
+            - containerlab
+            - deploy
+            - --topo
+            - /topology/flatracoon-bgp.clab.yml
+          volumeMounts:
+            - name: topology
+              mountPath: /topology
+              readOnly: true
+            - name: docker-sock
+              mountPath: /var/run/docker.sock
+          securityContext:
+            privileged: true
+      volumes:
+        - name: topology
+          configMap:
+            name: bgp-topology
+        - name: docker-sock
+          hostPath:
+            path: /var/run/docker.sock
+            type: Socket
+---
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: bgp-lab
+  labels:
+    app.kubernetes.io/part-of: flatracoon
+---
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: containerlab-runner
+  namespace: bgp-lab

topologies/flatracoon-bgp.clab.yml

@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# FlatRacoon BGP backbone lab - minimal 3-router eBGP topology
+# Spine + 2 leaf routers using FRRouting
+
+name: flatracoon-bgp
+
+topology:
+  nodes:
+    spine:
+      kind: linux
+      image: frrouting/frr:latest
+      env:
+        FRR_DEFAULTS: traditional
+      binds:
+        - configs/spine-frr.conf:/etc/frr/frr.conf
+      exec:
+        - ip addr add 10.0.1.1/30 dev eth1
+        - ip addr add 10.0.2.1/30 dev eth2
+        - ip addr add fd00:bgp::1/128 dev lo
+
+    leaf1:
+      kind: linux
+      image: frrouting/frr:latest
+      env:
+        FRR_DEFAULTS: traditional
+      binds:
+        - configs/leaf1-frr.conf:/etc/frr/frr.conf
+      exec:
+        - ip addr add 10.0.1.2/30 dev eth1
+        - ip addr add 172.16.1.1/24 dev eth2
+        - ip addr add fd00:bgp::2/128 dev lo
+
+    leaf2:
+      kind: linux
+      image: frrouting/frr:latest
+      env:
+        FRR_DEFAULTS: traditional
+      binds:
+        - configs/leaf2-frr.conf:/etc/frr/frr.conf
+      exec:
+        - ip addr add 10.0.2.2/30 dev eth1
+        - ip addr add 172.16.2.1/24 dev eth2
+        - ip addr add fd00:bgp::3/128 dev lo
+
+  links:
+    - endpoints: ["spine:eth1", "leaf1:eth1"]
+    - endpoints: ["spine:eth2", "leaf2:eth1"]