feat(mazenet): per-LAN swarm host pin

Adds nullable LAN.host_uuid (FK swarm_hosts.uuid). Resolution order
when deploying a LAN: lan.host_uuid → topology.target_host_uuid →
master. A LAN is one Docker bridge so the bridge cannot span hosts;
this pin forces every decky in the LAN onto the named host.

LANCreateRequest / LANUpdateRequest accept host_uuid; both validate
that the host exists, returning 400 on unknown UUIDs. PATCH still
gated by the existing pending-only guard, so reassignment of a live
LAN is not yet possible (deferred to mutator support).

LANRow surfaces the field so the frontend can render per-host badges.
This commit is contained in:
2026-04-25 03:04:23 -04:00
parent 36031fa10a
commit 0d92170a57
3 changed files with 98 additions and 0 deletions

View File

@@ -59,6 +59,13 @@ class LAN(SQLModel, table=True):
docker_network_id: Optional[str] = Field(default=None)
subnet: str
is_dmz: bool = Field(default=False)
# Per-LAN swarm host pin. ``None`` means "fall back to
# ``Topology.target_host_uuid``; if that is also None, deploy on the
# master." A LAN is one Docker bridge — bridges don't span hosts —
# so a non-null value forces every decky in this LAN onto that host.
host_uuid: Optional[str] = Field(
default=None, foreign_key="swarm_hosts.uuid", index=True
)
# Canvas layout coordinates (set by the web editor). Nullable so
# generator-emitted LANs don't need auto-layout at generation time.
x: Optional[float] = Field(default=None)
@@ -225,6 +232,7 @@ class LANRow(BaseModel):
subnet: str
is_dmz: bool = False
docker_network_id: Optional[str] = None
host_uuid: Optional[str] = None
x: Optional[float] = None
y: Optional[float] = None
@@ -280,6 +288,7 @@ class LANCreateRequest(BaseModel):
name: str = PydanticField(..., min_length=1, max_length=64)
subnet: Optional[str] = None
is_dmz: bool = False
host_uuid: Optional[str] = None
x: Optional[float] = None
y: Optional[float] = None
expected_version: Optional[int] = None
@@ -289,6 +298,7 @@ class LANUpdateRequest(BaseModel):
name: Optional[str] = None
subnet: Optional[str] = None
is_dmz: Optional[bool] = None
host_uuid: Optional[str] = None
x: Optional[float] = None
y: Optional[float] = None
expected_version: Optional[int] = None

View File

@@ -57,11 +57,20 @@ async def api_create_lan(
)
subnet = allocator.next_free()
if body.host_uuid is not None:
host = await repo.get_swarm_host_by_uuid(body.host_uuid)
if host is None:
raise HTTPException(
status_code=400,
detail=f"swarm host {body.host_uuid!r} not found",
)
payload = {
"topology_id": topology_id,
"name": body.name,
"subnet": subnet,
"is_dmz": body.is_dmz,
"host_uuid": body.host_uuid,
"x": body.x,
"y": body.y,
}
@@ -102,6 +111,13 @@ async def api_update_lan(
await assert_pending_or_409(topology_id)
fields = body.model_dump(exclude_unset=True, exclude={"expected_version"})
if "host_uuid" in fields and fields["host_uuid"] is not None:
host = await repo.get_swarm_host_by_uuid(fields["host_uuid"])
if host is None:
raise HTTPException(
status_code=400,
detail=f"swarm host {fields['host_uuid']!r} not found",
)
try:
await repo.update_lan(
lan_id,