#12: Port übernehmen und löschen als Compare-and-Swap #20

Merged
jochen merged 3 commits from fix/issue-12-cas into master 2026-11-14 22:50:19 +00:00
Collaborator

Fixes #12

Stand vor diesem PR

Der Kern von #12 ist schon seit #15 erledigt: Anlegen und Markieren eines Ports passiert in einer Transaktion (lsp-add ohne --may-exist), und der Marker sagt, wem der Port gehört (Container und Chassis).

Offen war die Lücke zwischen Lesen und Schreiben bei bestehenden Ports:

Fall Folge
Zwei Container mit gleichem lsp_name übernehmen gleichzeitig einen verwaisten Port Beide lesen „frei“ und setzen sich nacheinander als Eigentümer. Am Ende binden beide denselben LSP, und ovn-controller auf beiden Hosts kämpft um ihn.
Container A stoppt, Container B übernimmt den Port (z. B. Umzug auf einen anderen Host mit festem lsp_name) A liest „gehört mir“, B übernimmt, danach löscht A den Port. B läuft dann ohne Port.
Rollback eines fehlgeschlagenen Starts Gleiches Muster: Der Rollback löschte den Port per Name ohne Prüfung.

Lösung

Übernahme und Löschen laufen jeweils als eine OVSDB-Transaktion über ovsdb-client transact:

  1. wait: Die Zeile (per _uuid) hat noch genau die gelesenen external_ids.
  2. Erst dann folgt update der Eigentumsfelder bzw. das Entfernen aus Logical_Switch.ports. Das Entfernen löscht den Port, wie lsp-del es auch tut.

Hat sich etwas geändert, gilt:

  • Die Übernahme scheitert mit der Meldung „was changed concurrently (claimed by another container?)“. Der Container startet nicht, statt sich den Port mit einem anderen zu teilen.
  • Das Löschen im teardown unterbleibt mit einer Warnung.
  • Der Rollback löscht nur einen Port, der noch diesem Container gehört und unverändert ist.

ovn-nbctl bietet keine bedingten Schreibvorgänge, darum ovsdb-client. Das Paket hängt jetzt ausdrücklich von openvswitch-common ab, das ohnehin über openvswitch-switch mitkommt.

Tests

  • Unit-Tests für die Auswertung der Transaktionsergebnisse (wait gescheitert, Erfolg, Commit-Fehler) und für das Map-Format. Insgesamt sind es jetzt 30.
  • Der Integrationstest gegen eine echte NB-DB arbeitet mit einem veralteten Lesestand: Eine zweite Übernahme scheitert, der Port bleibt bei B. Das Löschen mit dem alten Stand unterbleibt, mit dem aktuellen klappt es. Das Löschen eines schon gelöschten Ports bleibt folgenlos.
  • e2e: alle 5 Szenarien grün. Rollback und teardown laufen dabei schon über die neue Transaktion.
  • clippy (inkl. pedantic) und gitleaks: sauber.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto

Fixes #12 ## Stand vor diesem PR Der Kern von #12 ist schon seit #15 erledigt: Anlegen und Markieren eines Ports passiert in **einer** Transaktion (`lsp-add` ohne `--may-exist`), und der Marker sagt, *wem* der Port gehört (Container und Chassis). Offen war die Lücke zwischen Lesen und Schreiben bei **bestehenden** Ports: | Fall | Folge | |---|---| | Zwei Container mit gleichem `lsp_name` übernehmen gleichzeitig einen verwaisten Port | Beide lesen „frei“ und setzen sich nacheinander als Eigentümer. Am Ende binden beide denselben LSP, und ovn-controller auf beiden Hosts kämpft um ihn. | | Container A stoppt, Container B übernimmt den Port (z. B. Umzug auf einen anderen Host mit festem `lsp_name`) | A liest „gehört mir“, B übernimmt, danach löscht A den Port. **B läuft dann ohne Port.** | | Rollback eines fehlgeschlagenen Starts | Gleiches Muster: Der Rollback löschte den Port per Name ohne Prüfung. | ## Lösung Übernahme und Löschen laufen jeweils als **eine** OVSDB-Transaktion über `ovsdb-client transact`: 1. `wait`: Die Zeile (per `_uuid`) hat noch genau die gelesenen `external_ids`. 2. Erst dann folgt `update` der Eigentumsfelder bzw. das Entfernen aus `Logical_Switch.ports`. Das Entfernen löscht den Port, wie `lsp-del` es auch tut. Hat sich etwas geändert, gilt: - Die Übernahme scheitert mit der Meldung „was changed concurrently (claimed by another container?)“. Der Container startet nicht, statt sich den Port mit einem anderen zu teilen. - Das Löschen im teardown unterbleibt mit einer Warnung. - Der Rollback löscht nur einen Port, der noch diesem Container gehört und unverändert ist. `ovn-nbctl` bietet keine bedingten Schreibvorgänge, darum `ovsdb-client`. Das Paket hängt jetzt ausdrücklich von `openvswitch-common` ab, das ohnehin über `openvswitch-switch` mitkommt. ## Tests - Unit-Tests für die Auswertung der Transaktionsergebnisse (wait gescheitert, Erfolg, Commit-Fehler) und für das Map-Format. Insgesamt sind es jetzt 30. - Der Integrationstest gegen eine echte NB-DB arbeitet mit einem **veralteten Lesestand**: Eine zweite Übernahme scheitert, der Port bleibt bei B. Das Löschen mit dem alten Stand unterbleibt, mit dem aktuellen klappt es. Das Löschen eines schon gelöschten Ports bleibt folgenlos. - e2e: alle 5 Szenarien grün. Rollback und teardown laufen dabei schon über die neue Transaktion. - clippy (inkl. pedantic) und gitleaks: sauber. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
Port übernehmen und löschen als Compare-and-Swap (#12)
Some checks failed
ci / rust (push) Failing after 1m42s
ci / deb (push) Has been skipped
ci / e2e (push) Has been skipped
bc2e0e211f
Anlegen+Markieren ist seit #15 eine Transaktion. Übrig war die Lücke
zwischen Lesen und Schreiben bei bestehenden Ports:

- Übernahme (explizites lsp_name): Zwei Container, die gleichzeitig
  denselben verwaisten Port übernehmen, haben beide "frei" gelesen und
  nacheinander gesetzt -- beide binden dann denselben LSP, ovn-controller
  auf beiden Hosts kämpft um ihn.
- Teardown: Liest Container A "gehört mir", übernimmt Container B (z. B.
  beim Umzug auf einen anderen Host) den Port, und löscht A danach, ist
  B's Port weg, während B läuft. Gleiches beim Rollback eines
  fehlgeschlagenen Starts.

Beides läuft jetzt als eine OVSDB-Transaktion über ovsdb-client transact:
eine wait-Operation prüft, dass die Zeile (per _uuid) noch genau die
gelesenen external_ids hat, erst dann folgt update bzw. das Entfernen aus
Logical_Switch.ports (wie lsp-del). Hat sich etwas geändert, scheitert
die Übernahme mit Fehlermeldung, Löschen unterbleibt (Warnung).

- PortInfo trägt die Zeilen-UUID.
- Rollback löscht den selbst angelegten Port nur, wenn er noch diesem
  Container gehört und unverändert ist.
- Paket hängt ausdrücklich von openvswitch-common (ovsdb-client) ab.
- Tests: Auswertung der Transaktionsergebnisse; Integrationstest gegen
  echte NB-DB mit veraltetem Lesestand (Übernahme scheitert, Löschen
  unterbleibt); e2e unverändert grün.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
teardown/rollback/Übernahme nutzen CAS; Doku und Paketabhängigkeit (#12)
All checks were successful
ci / rust (push) Successful in 7m39s
ci / deb (push) Successful in 5m10s
ci / e2e (push) Successful in 19s
c4c5f8ad06
Fixes #12

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
README: CAS beim Übernehmen/Löschen, ovsdb-client als Werkzeug (#12)
All checks were successful
ci / rust (push) Successful in 7m42s
ci / rust (pull_request) Successful in 7m40s
/ gitleaks (pull_request) Successful in 9s
ci / deb (push) Successful in 5m10s
ci / deb (pull_request) Successful in 5m8s
ci / e2e (push) Successful in 20s
ci / e2e (pull_request) Successful in 20s
da11d47ae7
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
jochen approved these changes 2026-11-14 19:59:03 +00:00
jochen merged commit 0072007874 into master 2026-11-14 22:50:19 +00:00
jochen deleted branch fix/issue-12-cas 2026-11-14 22:50:19 +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!20
No description provided.