Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions deploy/containerlab/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,3 +45,4 @@
Full documentation — topology, addressing, tasks — is in [README.md](README.md).
Verification commands are in [docs/verification.md](docs/verification.md).
Deploying the five test VPCs and verifying cross-site/same-node connectivity is documented in [docs/tenants.md](docs/tenants.md).
The dedicated-placement baseline (`ns80`, `task baseline:twice`) is documented in [docs/baseline.md](docs/baseline.md).
4 changes: 3 additions & 1 deletion deploy/containerlab/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -599,7 +599,9 @@ PublicNAT and PublicService paths and the built-in default. See

See [docs/verification.md](docs/verification.md) for transit fabric, FRR, and galactic-router
health checks, and [docs/tenants.md](docs/tenants.md) for deploying and verifying
the `ns10`/`ns20`/`ns30`/`ns40` test VPCs.
the `ns10`/`ns20`/`ns30`/`ns40` test VPCs. [docs/baseline.md](docs/baseline.md)
covers the dedicated-placement baseline: the `ns80` fixture, its scripted packet
observations and pinned versions (`task baseline:twice`).

`task verify` (and its constituent `task verify:scenarios`) also pings every
VPC's pods end-to-end via `task verify:ns10`/`ns20`/`ns30`/`ns40` —
Expand Down
35 changes: 35 additions & 0 deletions deploy/containerlab/Taskfile.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -434,6 +434,7 @@ tasks:
- task: "deploy:ns40"
- task: "deploy:ns60"
- task: "deploy:ns71"
- task: "deploy:ns80"

"deploy:ns10":
desc: Deploy ns10 test VPC (IPv6-only, fd20 ULA)
Expand Down Expand Up @@ -477,6 +478,15 @@ tasks:
- ./scripts/deploy-ns.sh ns71 sjc
- ./scripts/publish-attachments.sh ns71 sjc

# The dedicated-placement baseline fixture (docs/baseline.md): two VPCs
# with identical guest addresses on dfw's and sjc's compute workers.
"deploy:ns80":
desc: Deploy ns80 test VPCs (overlapping guests on two workers; baseline fixture)
cmds:
- ./scripts/deploy-tenant-policy.sh ns80 dfw sjc
- ./scripts/deploy-ns.sh ns80 dfw sjc
- ./scripts/publish-attachments.sh ns80 dfw sjc

verify:
desc: Run all verification checks
cmds:
Expand Down Expand Up @@ -1296,6 +1306,7 @@ tasks:
- task: "verify:ns20"
- task: "verify:ns30"
- task: "verify:ns40"
- task: "verify:ns80"

# Not idempotent while it runs: it edits ns60's dfw policy and unbinds
# ns30/private-b's ingress for a moment, and restores both on exit.
Expand Down Expand Up @@ -1364,6 +1375,30 @@ tasks:
cmds:
- ./scripts/verify-ns40.sh

"verify:ns80":
desc: Verify ns80 placement, overlapping addresses and cross-site ping in both VPCs
cmds:
- ./scripts/verify-ns80.sh

# The dedicated-placement baseline (docs/baseline.md). Not part of verify:
# each observation takes a few minutes and runs the gateway ingress checks
# again under capture. Evidence lands in bin/baseline/ at the repository
# root.
"baseline:versions":
desc: Check baseline/pins.yaml against the host, the Dockerfiles and the running lab, and record versions
cmds:
- LAB={{.LAB}} ./scripts/baseline-versions.sh {{.CLI_ARGS | default "../../bin/baseline/versions.yaml"}}

"baseline:observe":
desc: Observe today's remote paths on ns80 once, with captures (OUTDIR via task baseline:observe -- DIR)
cmds:
- LAB={{.LAB}} ./scripts/baseline-observe.sh {{.CLI_ARGS | default "../../bin/baseline/observe"}}

"baseline:twice":
desc: Record versions, observe twice, and require identical results matching baseline/reference-results.json
cmds:
- LAB={{.LAB}} ./scripts/baseline-twice.sh {{.CLI_ARGS}}

clean:
desc: Destroy the lab and delete artifacts
cmds:
Expand Down
14 changes: 14 additions & 0 deletions deploy/containerlab/baseline/pins.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# Versions the dedicated-placement baseline (docs/baseline.md) was recorded
# with. scripts/baseline-versions.sh fails when the host tools, the lab's
# Dockerfiles, the fixture or the running lab disagree with a value here.
# Change a pin together with baseline/reference-results.json, never alone.
#
# Host tools
containerlab: 0.75.0
kind: v0.33.0
task: 3.51.1
# Images and components the lab builds or pulls
kindest_node: v1.37.0
frr: 10.7.1
remote_host_base: alpine:3.24
guest_image: ghcr.io/datum-cloud/galactic-debug@sha256:b64e338f845d06f82f2575ae6bb6855da330af7551a8816b7ade2602a85722f2
Loading
Loading