From 4d6438285b6a688a01bf89fead673181c3ec974c Mon Sep 17 00:00:00 2001 From: cproudlock Date: Fri, 8 May 2026 17:23:37 -0400 Subject: [PATCH] playbook: document USB-C 5 Gbps NIC bridge override on netplan task The "Configure static IP for PXE interface" task writes a flat single-NIC netplan config. Live PXE server (10.9.100.1) overrides this with a bridge config bonding the USB-C 5 Gbps NIC and the onboard NIC into br-pxe, because the onboard NIC alone cannot sustain the imaging throughput required by the floor. Add a comment block above the task warning that re-running it on a box already using the bridge config will replace the bridge with a flat single-iface config and likely break the PXE LAN. The full bridge YAML is included for reference. Recovery is via /etc/netplan/50-cloud-init.yaml.pre-gold-swap (preserved by netplan backup). Co-Authored-By: Claude Opus 4.7 (1M context) --- playbook/pxe_server_setup.yml | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/playbook/pxe_server_setup.yml b/playbook/pxe_server_setup.yml index 0f89046..2d9fb0b 100644 --- a/playbook/pxe_server_setup.yml +++ b/playbook/pxe_server_setup.yml @@ -1047,6 +1047,29 @@ name: apache2 state: reloaded + # Single-NIC fresh-deploy default. Boxes that need higher throughput + # (e.g. WJF prod uses a USB-C 5 Gbps NIC) override this with a bridge + # config bonding the USB NIC + onboard NIC into br-pxe. Live override + # currently deployed on 10.9.100.1 (do NOT re-run this task there + # without first reviewing /etc/netplan/50-cloud-init.yaml.pre-gold-swap): + # + # network: + # version: 2 + # renderer: networkd + # ethernets: + # enp128s31f6: { dhcp4: no } + # enx34c8d6b11010: { dhcp4: no } + # bridges: + # br-pxe: + # interfaces: [enp128s31f6, enx34c8d6b11010] + # addresses: [10.9.100.1/24] + # parameters: + # stp: false + # + # Re-running THIS task on a box already using the bridge config will + # replace the bridge with a single-iface flat config and likely break + # the PXE LAN. Skip this task or restore the .pre-gold-swap backup + # before applying. - name: "Configure static IP for PXE interface" copy: dest: /etc/netplan/50-cloud-init.yaml