CI + Port-Ownership absichern (#1, #2) #15

Merged
jochen merged 3 commits from fix/port-ownership into master 2026-11-12 08:39:36 +00:00
Collaborator

Fixes #1
Fixes #2
Fixes #13

Commit 1: Port-Ownership (#1, #2)

Neues Modul src/ports.rs mit der kompletten Entscheidungslogik als reine Funktionen (unit-getestet):

  • Default-LSP-Name ist jetzt <switch>-<12 Zeichen Container-ID> statt <switch>-<containername> → keine Kollision mehr zwischen Hosts (#2).
  • Anlegen + Ownership in einer NB-Transaktion (lsp-add … -- set … external_ids:podman-owned=true podman-container-id=<id> podman-chassis=<system-id>). Kein Zustand „Port existiert, aber unmarkiert“ mehr (deckt auch einen Teil von #12 ab).
  • Existierende Ports werden nur verwendet, wenn
    • sie auf dem eigenen Switch liegen (Portnamen sind NB-weit global),
    • type leer ist → router/localnet/localport/… werden abgelehnt (#1),
    • sie diesem Container gehören, oder (bei explizitem lsp_name) einem nicht mehr aktiven Container (up != true) → Übernahme mit neuem Owner-Stempel,
    • fremd angelegte Ports: nur mit Freigabe external_ids:podman-allowed=true am Port oder --opt ovn_external_ports=allow am Netzwerk, nicht gebunden, requested-chassis passt zu system-id/Hostname.
  • Teardown löscht nur Ports auf dem eigenen Switch, die podman-owned sind und diesem Container gehören.
  • ovn_switch und lsp_name werden validiert ([A-Za-z0-9._:-], ≤128, kein führendes -).
  • Fehlermeldungen von ovn-nbctl enthalten jetzt stderr.
  • cargo fmt + Clippy (type_complexity) bereinigt, damit CI mit -D warnings läuft.

Commit 2: CI (.forgejo/workflows/ci.yml)

Aufbau wie in mdns-bridge (runs-on: docker, rust:1-bookworm): fmt-Check, clippy -D warnings, Unit-Tests, Integrationstest gegen eine frische OVN-Northbound-DB (ovsdb-server im Job), cargo audit, Release-Build als Artefakt.

⚠️ Verhaltensänderungen / Migration

  1. Neue Default-Portnamen. Container ohne lsp_name bekommen beim nächsten Start einen neuen Port (und damit ggf. neue MAC/IP). Alte, mit ovn_keep_ports=true/lsp_cleanup=keep behaltene Ports <switch>-<name> bleiben liegen und müssen manuell entfernt werden. Wer eine stabile Identität über Container-Neuanlagen braucht: lsp_name explizit setzen.
  2. Vorprovisionierte Ports (nicht von podman angelegt) brauchen jetzt eine Freigabe: ovn-nbctl set logical_switch_port <p> external_ids:podman-allowed=true oder Netzwerk mit --opt ovn_external_ports=allow.
  3. Alte, podman-owned Ports ohne podman-container-id werden beim nächsten Setup übernommen und gestempelt, sofern nicht up.

Getestet

  • 19 Unit-Tests (Policy, Parser, Quoting, Namensvalidierung)
  • Integrationstest lokal gegen ovsdb-server mit OVN-NB-Schema (ovn-nbctl 24.03): Anlegen+Stempel, zweites Anlegen → „exists“, gleicher Name auf anderem Switch → abgelehnt, Übernahme, Router-Port → abgelehnt, Teardown-Entscheidung
  • Nicht getestet: kompletter Container-Start mit echtem ovs-vswitchd/ovn-controller (keine Umgebung dafür hier). Bitte einmal auf einem Testhost mit podman run + podman stop durchspielen.

Offen

  • Cargo.lock ist noch nicht eingecheckt (zu groß für den API-Upload). Bitte lokal: cargo generate-lockfile && git add Cargo.lock und im Workflow --locked ergänzen (#13).

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto

Commit 3: Cargo.lock erzeugt und --locked hinzugefügt.

Fixes #1 Fixes #2 Fixes #13 ## Commit 1: Port-Ownership (#1, #2) **Neues Modul `src/ports.rs`** mit der kompletten Entscheidungslogik als reine Funktionen (unit-getestet): - **Default-LSP-Name** ist jetzt `<switch>-<12 Zeichen Container-ID>` statt `<switch>-<containername>` → keine Kollision mehr zwischen Hosts (#2). - **Anlegen + Ownership in einer NB-Transaktion** (`lsp-add … -- set … external_ids:podman-owned=true podman-container-id=<id> podman-chassis=<system-id>`). Kein Zustand „Port existiert, aber unmarkiert“ mehr (deckt auch einen Teil von #12 ab). - **Existierende Ports** werden nur verwendet, wenn - sie auf **dem eigenen Switch** liegen (Portnamen sind NB-weit global), - `type` leer ist → **router/localnet/localport/… werden abgelehnt** (#1), - sie diesem Container gehören, **oder** (bei explizitem `lsp_name`) einem nicht mehr aktiven Container (`up != true`) → Übernahme mit neuem Owner-Stempel, - fremd angelegte Ports: nur mit Freigabe `external_ids:podman-allowed=true` am Port **oder** `--opt ovn_external_ports=allow` am Netzwerk, nicht gebunden, `requested-chassis` passt zu system-id/Hostname. - **Teardown** löscht nur Ports auf dem eigenen Switch, die podman-owned sind **und** diesem Container gehören. - `ovn_switch` und `lsp_name` werden validiert (`[A-Za-z0-9._:-]`, ≤128, kein führendes `-`). - Fehlermeldungen von `ovn-nbctl` enthalten jetzt stderr. - `cargo fmt` + Clippy (`type_complexity`) bereinigt, damit CI mit `-D warnings` läuft. ## Commit 2: CI (`.forgejo/workflows/ci.yml`) Aufbau wie in mdns-bridge (`runs-on: docker`, `rust:1-bookworm`): fmt-Check, clippy `-D warnings`, Unit-Tests, **Integrationstest gegen eine frische OVN-Northbound-DB** (ovsdb-server im Job), `cargo audit`, Release-Build als Artefakt. ## ⚠️ Verhaltensänderungen / Migration 1. **Neue Default-Portnamen.** Container ohne `lsp_name` bekommen beim nächsten Start einen neuen Port (und damit ggf. neue MAC/IP). Alte, mit `ovn_keep_ports=true`/`lsp_cleanup=keep` behaltene Ports `<switch>-<name>` bleiben liegen und müssen manuell entfernt werden. Wer eine stabile Identität über Container-Neuanlagen braucht: `lsp_name` explizit setzen. 2. **Vorprovisionierte Ports** (nicht von podman angelegt) brauchen jetzt eine Freigabe: `ovn-nbctl set logical_switch_port <p> external_ids:podman-allowed=true` oder Netzwerk mit `--opt ovn_external_ports=allow`. 3. Alte, podman-owned Ports ohne `podman-container-id` werden beim nächsten Setup übernommen und gestempelt, sofern nicht `up`. ## Getestet - 19 Unit-Tests (Policy, Parser, Quoting, Namensvalidierung) - Integrationstest lokal gegen ovsdb-server mit OVN-NB-Schema (ovn-nbctl 24.03): Anlegen+Stempel, zweites Anlegen → „exists“, gleicher Name auf anderem Switch → abgelehnt, Übernahme, Router-Port → abgelehnt, Teardown-Entscheidung - **Nicht** getestet: kompletter Container-Start mit echtem ovs-vswitchd/ovn-controller (keine Umgebung dafür hier). Bitte einmal auf einem Testhost mit `podman run` + `podman stop` durchspielen. ## Offen - `Cargo.lock` ist noch nicht eingecheckt (zu groß für den API-Upload). Bitte lokal: `cargo generate-lockfile && git add Cargo.lock` und im Workflow `--locked` ergänzen (#13). 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto ## Commit 3: Cargo.lock erzeugt und --locked hinzugefügt.
- Default-LSP-Name aus Container-ID statt Containername, da Namen nur pro
  Host eindeutig sind, der Logical Switch aber clusterweit (#2)
- Port anlegen und Ownership (podman-owned, podman-container-id,
  podman-chassis) in einer NB-Transaktion setzen
- Vorhandene Ports nur nach Policy verwenden (neues Modul ports.rs, #1):
  nur VIF-Ports (kein router/localnet/...), nur auf dem eigenen Switch,
  nicht in Benutzung durch einen anderen Container; fremd angelegte
  Ports nur nach Freigabe (external_ids:podman-allowed=true oder
  --opt ovn_external_ports=allow) und passendem requested-chassis
- Teardown löscht nur Ports, die diesem Container gehören
- ovn_switch und lsp_name werden validiert (Zeichensatz, Länge, kein '-')
- ovn-nbctl-Fehlermeldungen enthalten stderr
- Unit-Tests für Policy und Parser, Integrationstest gegen echte NB-DB
  (OVN_NB_TEST_DB=...)
- cargo fmt, clippy-Warnungen (type_complexity) behoben

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
CI: Forgejo-Actions-Workflow
All checks were successful
ci / rust (push) Successful in 7m45s
ci / rust (pull_request) Successful in 7m37s
3356c63e56
fmt, clippy -D warnings, Unit-Tests, Integrationstest gegen eine frische
OVN-Northbound-DB, cargo audit, Release-Build als Artefakt.
target/.keep entfernt, .gitignore ignoriert Cargo.lock nicht mehr (#13).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
Add Cargo.lock (#13)
All checks were successful
ci / rust (push) Successful in 8m43s
ci / rust (pull_request) Successful in 8m35s
c723250de1
jochen approved these changes 2026-11-12 08:37:47 +00:00
jochen merged commit b3cd5d1522 into master 2026-11-12 08:39:36 +00:00
jochen deleted branch fix/port-ownership 2026-11-12 08:39:37 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
jochen/netavark-ovs!15
No description provided.