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
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,10 @@ internal/plumbing/ebpf/xmitdrops/xmitdrops_bpfel.go
internal/plumbing/ebpf/xmitdrops/xmitdrops_bpfel.o
internal/plumbing/ebpf/xmitdrops/xmitdrops_bpfeb.go
internal/plumbing/ebpf/xmitdrops/xmitdrops_bpfeb.o
tests/handoffs/probe/handoff_bpfel.go
tests/handoffs/probe/handoff_bpfel.o
tests/handoffs/probe/handoff_bpfeb.go
tests/handoffs/probe/handoff_bpfeb.o

# Same convention as above, for the containerlab-only pass-through XDP
# program (deploy/containerlab/Taskfile.yaml's build:lab-xdp-passthrough,
Expand Down
3 changes: 2 additions & 1 deletion Taskfile.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,7 @@ tasks:
cmds:
- python3 hack/docs/generate_api.py --check
build:ebpf:
desc: Regenerate the eBPF uSID, edge gateway DSR, NAT egress, XDP dispatcher and XDP transmit drop programs (requires clang)
desc: Regenerate the eBPF uSID, edge gateway DSR, NAT egress, XDP dispatcher, XDP transmit drop and Local handoff probe programs (requires clang)
run: once
deps: [require-clang]
cmds:
Expand All @@ -131,6 +131,7 @@ tasks:
- go generate ./internal/plumbing/ebpf/natprog/...
- go generate ./internal/plumbing/ebpf/xdpdispatch/...
- go generate ./internal/plumbing/ebpf/xmitdrops/...
- go generate ./tests/handoffs/probe/...
require-clang:
internal: true
run: once
Expand Down
1 change: 1 addition & 0 deletions deploy/containerlab/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,3 +46,4 @@ Full documentation — topology, addressing, tasks — is in [README.md](README.
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).
The Local handoff checks (`ns80-tap`, `task handoff:twice`) are documented in [docs/handoffs.md](docs/handoffs.md).
38 changes: 38 additions & 0 deletions deploy/containerlab/Taskfile.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -1399,6 +1399,44 @@ tasks:
cmds:
- LAB={{.LAB}} ./scripts/baseline-twice.sh {{.CLI_ARGS}}

# The Local handoff checks (docs/handoffs.md). Not part of deploy or
# verify: handoff:twice deploys ns80-tap, observes twice, measures and
# removes ns80-tap again.
"deploy:ns80-tap":
desc: Deploy the Local handoff fixture (TAP guests in both ns80 VPCs and an Envoy stand-in) on dfw
cmds:
- ./scripts/handoff-fixture.sh up

"delete:ns80-tap":
desc: Remove the Local handoff fixture from dfw
cmds:
- ./scripts/handoff-fixture.sh down

"handoff:probe":
desc: Build handoff-probe (tests/handoffs) for the Local handoff checks
dir: ../..
cmds:
- task build:ebpf
- CGO_ENABLED=0 go build -o bin/handoff-probe ./tests/handoffs/cmd/handoff-probe

"handoff:observe":
desc: Prove the Local handoffs once, with captures (needs ns80-tap; OUTDIR via task handoff:observe -- DIR)
deps: ["handoff:probe"]
cmds:
- LAB={{.LAB}} ./scripts/handoff-observe.sh {{.CLI_ARGS | default "../../bin/handoffs/observe"}}

"handoff:measure":
desc: Measure the Local handoffs' MTU limits and offload behavior (needs ns80-tap)
deps: ["handoff:probe"]
cmds:
- LAB={{.LAB}} ./scripts/handoff-measure.sh {{.CLI_ARGS | default "../../bin/handoffs/measure"}}

"handoff:twice":
desc: Deploy ns80-tap, observe twice, measure, remove ns80-tap, and compare with handoffs/expected-results.json
deps: ["handoff:probe"]
cmds:
- LAB={{.LAB}} ./scripts/handoff-twice.sh {{.CLI_ARGS}}

clean:
desc: Destroy the lab and delete artifacts
cmds:
Expand Down
6 changes: 4 additions & 2 deletions deploy/containerlab/docs/baseline.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,10 @@ on two physical workers. Services run on dedicated edge nodes, and workloads
run on compute nodes. Later work on the Galactic Worker reuses this fixture
and compares its results against the reference recorded here.

The fixture has no TAP-backed guest. The tenant TAP capture point belongs to
[#1444](https://github.com/datum-cloud/galactic/issues/1444).
The fixture has no TAP-backed guest. The tenant TAP guests and their capture
points are in the separate `ns80-tap` fixture of the
[Local handoff checks](handoffs.md), which is deployed only while those checks
run.

## Fixture

Expand Down
258 changes: 258 additions & 0 deletions deploy/containerlab/docs/handoffs.md

Large diffs are not rendered by default.

Loading
Loading