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) <noreply@anthropic.com>
This commit is contained in:
@@ -1047,6 +1047,29 @@
|
|||||||
name: apache2
|
name: apache2
|
||||||
state: reloaded
|
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"
|
- name: "Configure static IP for PXE interface"
|
||||||
copy:
|
copy:
|
||||||
dest: /etc/netplan/50-cloud-init.yaml
|
dest: /etc/netplan/50-cloud-init.yaml
|
||||||
|
|||||||
Reference in New Issue
Block a user