Skip to content

chore(repo): Umzug nach MKU-Solution vorbereiten und durchfuehren #243

Open

Description

@seipekm

Ausgangslage

Das Repository soll von seipekm/VereinOrder nach MKU-Solution/VereinOrder umziehen. Der Transfer selbst ist ein Klick; die Folgen sind es nicht. Dieses Issue haelt fest, was dabei bricht, in welcher Reihenfolge es zu tun ist und was vorher zu entscheiden bleibt.

Alle Befunde sind am heutigen Stand geprueft (main = eaadfbf).

Was der Transfer von selbst mitnimmt

Issues, Pull Requests samt ihrer Nummern, Kommentare, Marken, Meilensteine und die Historie. Alle Verweise der Form #183 in Commit-Nachrichten und Dokumenten bleiben gueltig.

GitHub richtet ausserdem eine Weiterleitung der alten Adresse ein: git pull auf einem bereits eingerichteten Raspberry Pi funktioniert danach weiter, ohne dass dort etwas geaendert wird. Das ist wichtig, weil es den Umzug ueberhaupt erst gefahrlos macht — die Geraete verlieren nicht sofort den Anschluss.

Was der Transfer NICHT mitnimmt

1. Die Container-Pakete — der gefaehrlichste Punkt

Die drei Pakete ghcr.io/seipekm/vereinorder-{backend,frontend,print-worker} gehoeren dem Benutzerkonto, nicht dem Repository. Sie ziehen nicht mit um.

Die CI bildet den Abbildnamen aus dem Eigentuemer des Repositories (.github/workflows/ci.yml:817 und :864, jeweils github.repository_owner). Nach dem Transfer veroeffentlicht sie also in den neuen Namensraum. docker-compose.yml schreibt den Eigentuemer dagegen fest (:71, :144, :180).

Damit entsteht genau die Sorte Fehler, die dieses Projekt am wenigsten vertraegt: Eine Aktualisierung, die Erfolg meldet und nichts tut. scripts/ops/upgrade.sh setzt den Wartungsmodus, erzeugt die PRE_MIGRATION-Sicherung, zieht ghcr.io/seipekm/...:latest — das es weiterhin gibt, nur eingefroren —, startet, prueft prisma migrate status und beendet die Wartung. Alles gruen. Das Geraet laeuft weiter auf dem alten Stand, und niemand merkt es, bis eine erwartete Aenderung fehlt.

2. Der Organisationsname enthaelt Grossbuchstaben

MKU-Solution ist als Teil eines Docker-Abbildnamens ungueltig: Der Pfadanteil einer Abbildkennung muss durchgehend klein geschrieben sein. ghcr.io/MKU-Solution/vereinorder-backend wird abgewiesen.

Die CI reicht den Eigentuemernamen an beiden Stellen roh durch. Beim ersten Veroeffentlichungslauf nach dem Transfer brechen deshalb die Auftraege "Docker-Abbild veroeffentlichen" und "Docker-Abbild zusammenfassen" ab. Bisher fiel das nie auf, weil seipekm zufaellig komplett klein geschrieben ist.

GitHub Actions hat keine eingebaute Funktion zum Kleinschreiben. Ueblicher Weg ist ein vorgelagerter Schritt, der den Wert einmal umwandelt und als Ausgabe bereitstellt; die Alternative ist, mku-solution fest einzutragen. Die zweite Variante ist ehrlicher, solange es genau eine Organisation gibt — sie sagt, was gilt, statt es zu berechnen.

3. Paketsichtbarkeit

Das Repository ist privat, die Pakete muessen oeffentlich sein — sonst braucht der Pi Zugangsdaten fuer docker compose pull. docs/ops/installation.md haelt das als einmaligen Schritt nach dem ersten Veroeffentlichungslauf fest.

Dieser Schritt ist in der Organisation zu wiederholen: Neue Pakete entstehen dort ebenfalls zunaechst privat. Zusaetzlich koennen Organisationen oeffentliche Pakete auf ihrer Ebene untersagen; das ist vorher zu pruefen, nicht beim ersten fehlgeschlagenen Pull auf dem Pi.

4. Actions-Berechtigungen der Organisation

Die Veroeffentlichungsauftraege brauchen packages: write (ci.yml:787, :843). Organisationen setzen die Vorgabe fuer Workflow-Berechtigungen oft auf nur lesend, und sie koennen einschraenken, welche fremden Actions ueberhaupt laufen duerfen — dieser Workflow verwendet unter anderem actions/checkout, docker/login-action, docker/build-push-action und die Geheimnispruefung. Beides vor dem ersten Lauf klaeren.

5. Zweigschutz (#206)

Heutiger Stand, gemessen: 12 namentlich verlangte Pruefungen, strict, enforce_admins aktiv, null verlangte Freigaben. Nach dem Transfer nachpruefen — und besonders darauf achten, ob die Organisation eigene Regelwerke mitbringt, die zusaetzliche Bedingungen setzen.

Warum das zaehlt: In der Sitzung zu #206 ist main schon einmal eingefroren, als der Schutz aktiv war und die CI gleichzeitig ausfiel. Nichts konnte mehr gemergt werden. Eine Organisation, die etwa eine Freigabe durch eine zweite Person verlangt, erzeugt bei einem Einzelmaintainer denselben Zustand dauerhaft.

6. Actions-Minuten

Ein privates Repository verbraucht abgerechnete Minuten. Ein vollstaendiger Lauf hat hier zwoelf Auftraege, darunter sechs Docker-Bauten und zwei Buendeltests; die Laufzeiten der letzten Laeufe summieren sich auf gut eine Viertelstunde je Push. Vor dem ersten arbeitsreichen Tag pruefen, welches Kontingent die Organisation hat.

Das entfaellt vollstaendig, wenn das Repository in der Organisation oeffentlich wird — dann sind Actions kostenfrei, und die Pakete sind ohnehin oeffentlich.

Festverdrahtete Verweise im Repository

Funktional:

  • docker-compose.yml:71, :144, :180 — die drei Abbildnamen
  • .github/workflows/ci.yml:817, :864 — Kleinschreibung, siehe Punkt 2

Dokumentation:

  • docs/ops/installation.md:22 (Clone-Adresse), :213 (Paketuebersicht des Kontos)
  • docs/ops/raspberry-pi-setup.md:42 (Clone-Adresse)
  • scripts/ops/upgrade.sh:265, :272 und scripts/ops/rollback.sh:139, :146 — nur Kommentare und Beispiele, aber es sind die Beispiele, die ein Bediener im Ernstfall liest

docs/product/master-prompt.md bleibt unangetastet. Das Dokument nennt seipekm/VereinOrder an sechs Stellen, ist aber ein historischer Produktauftrag und keine Beschreibung des heutigen Zustands — dieselbe Begruendung wie in #183.

Reihenfolge

Sie ist nicht beliebig. Wer die Compose-Datei vor der ersten erfolgreichen Veroeffentlichung umstellt, macht jeden Pull unmoeglich; wer sie danach vergisst, bekommt die stille Nicht-Aktualisierung aus Punkt 1.

  1. Vorher entscheiden: oeffentlich oder privat (siehe unten).
  2. Transfer durchfuehren.
  3. Organisation einrichten: Workflow-Berechtigungen, erlaubte Actions, Paketsichtbarkeit.
  4. CI auf Kleinschreibung berichtigen und einen Veroeffentlichungslauf erfolgreich durchbringen.
  5. Die drei neuen Pakete oeffentlich stellen und mit dem Repository verknuepfen. Pruefen, dass ein docker pull ohne Anmeldung von einem fremden Rechner aus funktioniert — das ist die Bedingung, unter der der Pi arbeitet.
  6. Erst jetzt docker-compose.yml und die Dokumentation umstellen.
  7. Auf jedem Geraet: git pull (die Weiterleitung traegt), dann ./scripts/ops/upgrade.sh. Danach ueberpruefen, welches Abbild wirklich laeuft (docker compose images), nicht nur, dass das Skript gruen war.
  8. Oertlich: git remote set-url origin, und die Anmeldung des gh-Werkzeugs pruefen.

Zu entscheiden

Oeffentlich oder privat? Oeffentlich erledigt Punkt 3 und Punkt 6 von selbst und macht die Paketfreigabe zur Selbstverstaendlichkeit. Dagegen spricht, was im Repository steht: .env.example mit Beispielpasswoertern, die Betriebsanleitungen fuer ein konkretes Fest, die Befundprotokolle. Nichts davon ist ein Geheimnis im engeren Sinne — die Geheimnispruefung laeuft in der CI —, aber es ist eine bewusste Entscheidung und keine Nebenfolge.

Die alten Pakete: einfrieren oder loeschen? Empfehlung: einen Uebergangszeitraum lang stehen lassen. Solange irgendein Geraet noch nicht umgestellt ist, ist das alte Paket sein einziger Rueckweg. Das Loeschen eines oeffentlichen Pakets laesst sich nicht ruecknehmen. Erst loeschen, wenn nachweislich jede Installation umgezogen ist.

Zeitpunkt. Nicht vor einem Fest. Der Umzug beruehrt genau den Weg, ueber den im Ernstfall aktualisiert und zurueckgerollt wird.

Abgrenzung

Der Transfer selbst ist eine Handlung des Eigentuemers auf GitHub und wird hier nicht automatisiert. Dieses Issue deckt die Vorbereitung, die Aenderungen im Repository und die Nachkontrolle ab.

Die pnpm-Warnung (#237) und der offene Punkt zu .claude/worktrees in .gitignore sind unabhaengig davon.

Activity

  1. added
    dockerContainer und Docker Compose
    operationsInstallation, Betrieb und Wiederherstellung
    on Sep 4, 2026
  2. seipekm commented on Sep 4, 2026

    @seipekm
    MemberAuthor

    Stand der Vorbereitung (alles auf main, Lauf gruen):

    Damit ist alles erledigt, was sich vor dem Transfer im Repository erledigen laesst.

  3. seipekm commented on Sep 4, 2026

    @seipekm
    MemberAuthor

    Transfer durchgefuehrt — Stand der Nachkontrolle

    MKU-Solution/VereinOrder, oeffentlich, main als Vorgabezweig. Die Weiterleitung der alten Adresse traegt (git fetch ueber die alte URL funktioniert), bestehende Geraete verlieren also nicht den Anschluss.

    Erledigt und geprueft

    Die Veroeffentlichung laeuft in der neuen Organisation. Alle neun Auftraege (docker-publish ×6, docker-manifest ×3) erfolgreich. Erzeugt wurde:

    ghcr.io/mku-solution/vereinorder-backend:latest
    ghcr.io/mku-solution/vereinorder-backend:eef3e3a…
    

    kleingeschrieben — die Aenderung aus #245 hat genau das getan, wofuer sie gedacht war. Ohne sie stuende hier ein Abbruch wegen ungueltiger Abbildkennung.

    Die Berechtigungsfrage ist beantwortet. Die Standardberechtigung fuer Workflows steht in der Organisation auf read; der ausdrueckliche packages: write-Block im Workflow sticht sie. Fremde Actions sind nicht eingeschraenkt (allowed_actions: all).

    Die Historie ist unbedenklich. Anlaesslich der Veroeffentlichung geprueft: Die alten Vorgabewerte in der Historie waren Platzhalter (changeme-in-production, ein deutscher Hinweistext), keine echten Zugangsdaten.

    Offen — und beides blockiert den naechsten Schritt

    1. Die drei neuen Pakete sind privat. Ein anonymer Abruf des Manifests liefert HTTP 403, bei allen dreien. Gegenprobe an den alten Paketen unter seipekm: HTTP 200. Die Pruefmethode ist also gueltig und der Befund echt.

    Das ist Punkt 3 dieses Issues, und es ist die Bedingung, unter der der Raspberry Pi arbeitet: Er zieht ohne Zugangsdaten. Solange das so bleibt, wuerde ein Merge von #248 jeden docker compose pull mit denied scheitern lassen.

    Zu tun, von Hand: Die drei Pakete unter https://github.com/orgs/MKU-Solution/packages auf Public stellen und mit dem Repository verknuepfen.

    2. Der Zweigschutz ist nicht mitgekommen. main meldet Branch not protected. Die zwoelf namentlichen Pflichtpruefungen, strict und enforce_admins aus #206 gelten nicht mehr. Das ist keine Organisationsregel, die eingreift — die Einstellung ist beim Transfer schlicht verloren gegangen und wird wiederhergestellt.

    Kein Schaden im Wartezustand

    Die alten Pakete unter seipekm bestehen weiter und sind oeffentlich abrufbar. Laufende Installationen sind nicht betroffen; docker-compose.yml zeigt weiterhin auf sie. Es gilt aber unveraendert: Bis #248 gemergt ist, darf auf keinem Geraet upgrade.sh laufen — sonst zieht es aus dem alten, ab jetzt eingefrorenen Namensraum und meldet dabei Erfolg.

  4. seipekm commented on Sep 4, 2026

    @seipekm
    MemberAuthor

    Umzug aus Sicht des Repositories abgeschlossen

    main steht auf 32dd669 (#248). docker-compose.yml zeigt auf ghcr.io/mku-solution/vereinorder-{backend,frontend,print-worker}.

    Die Pakete sind oeffentlich und benutzbar — mit derselben Methode geprueft wie zuvor der Gegenbefund: Ein anonymer Manifest-Abruf liefert bei allen drei HTTP 200 (vorher 403). Die Marke latest enthaelt beide Plattformen, linux/amd64 und linux/arm64; der Raspberry Pi bekommt also eine Fassung, die zu ihm passt.

    Damit sind die Punkte 1 bis 6 der Reihenfolge erledigt.

    Was noch aussteht

    Schritt 7 — je Geraet. git pull (die Weiterleitung der alten Adresse traegt, das Remote muss nicht zwingend umgestellt werden, sollte aber), danach ./scripts/ops/upgrade.sh.

    Danach zwingend nachsehen, welches Abbild wirklich laeuft:

    docker compose images
    

    Es muss ghcr.io/mku-solution/... zeigen. Sich darauf zu verlassen, dass upgrade.sh gruen gemeldet hat, reicht hier ausdruecklich nicht — genau dieser Fall ist der, der still schiefgeht, und er war der Anlass fuer den ganzen Vorgang.

    Die alten Pakete unter seipekm bleiben zunaechst bestehen und sind weiterhin oeffentlich abrufbar. Sie bekommen ab jetzt keine neuen Fassungen mehr. Solange auch nur ein Geraet nicht umgestellt ist, sind sie sein einziger Rueckweg — deshalb erst loeschen, wenn nachweislich jede Installation umgezogen ist, und dann bewusst: Ein geloeschtes oeffentliches Paket kommt nicht zurueck.

    Ein Befund aus dem Transfer, der noch offen ist

    Der Zweigschutz ist beim Transfer verloren gegangen und noch nicht wiederhergestellt. main meldet Branch not protected; die zwoelf namentlichen Pflichtpruefungen, strict und enforce_admins aus #206 gelten derzeit nicht.

  5. seipekm commented on Sep 4, 2026

    @seipekm
    MemberAuthor

    Zweigschutz wiederhergestellt

    Nach dem Transfer war main ungeschuetzt (Branch not protected). Der Zustand aus #206 ist wieder gesetzt und nachgeprueft:

    Pruefungen: 12   strict: true   enforce_admins: true
    Freigaben:  0    force_push: false   loeschbar: false
    

    Die zwoelf Namen wurden nicht abgetippt, sondern aus einem echten Lauf uebernommen (gh pr checks --json name). Bei Docker-Bündel Aktualisierung (upgrade.sh, PRE_MIGRATION vor Migration) und Geheimnispruefung waere ein Tippfehler in Umlaut oder Klammer eine stille Luecke gewesen: Ein Name, den es nicht gibt, wird nie gruen — und ein Name, der fehlt, wird nie verlangt.

    Dass es genau zwoelf sind, deckt sich mit der Zahl aus #206.

    Kommentare nachgezogen

    Mit 43917c4 (PR #253). Beide Schritte „Registry-Namensraum klein schreiben" trugen den Satz, die Umwandlung sei „heute wirkungslos, weil seipekm bereits klein geschrieben ist". Seit dem Transfer stimmt das nicht mehr — sie ist im Gegenteil die Bedingung dafuer, dass ueberhaupt veroeffentlicht wird.

    Verbliebene Verweise auf den alten Eigentuemer stehen jetzt ausschliesslich in docs/product/master-prompt.md und bleiben dort: historischer Produktauftrag, keine Beschreibung des heutigen Zustands.

    Eine Luecke, die benannt gehoert

    Die CI prueft den Ziehweg nicht. Der Auftrag Docker-Bündel Aktualisierung setzt VEREINORDER_BUILD: "1" — upgrade.sh baut dort oertlich und zieht nie. Der Weg, den jedes Geraet gehen wird (docker compose pull aus ghcr.io/mku-solution/...), ist von keiner Pruefung abgedeckt und war es auch vorher nicht.

    Von aussen belegt ist, was sich ohne Docker belegen laesst: Alle drei Abbilder antworten anonym mit 200, und die Marke latest enthaelt linux/amd64 und linux/arm64.

    Der Rest faellt beim ersten echten Geraet. Deshalb ist der Blick auf docker compose images nach dem ersten upgrade.sh kein Ritual, sondern der einzige Nachweis, den es fuer diesen Schritt gibt.

    Alte Pakete

    Entscheidung: loeschen. Nicht von hier aus moeglich — der verwendete Zugang traegt die Bereiche gist, read:org, repo, workflow; fuer Pakete fehlt delete:packages. Der Schritt bleibt beim Betreiber, unter https://github.com/users/seipekm/packages.

    Zur Reihenfolge, weil sie hier zaehlt: Ein Geraet, das noch nicht umgestellt ist, zieht weiterhin aus dem alten Namensraum. Solange die Pakete stehen, bekommt es eine eingefrorene, aber lauffaehige Fassung; sind sie geloescht, schlaegt sein naechster upgrade.sh fehl. Laufende Container beruehrt das nicht. Am ruhigsten ist die Reihenfolge: erst die Geraete umstellen, dann loeschen.

  6. seipekm commented on Sep 4, 2026

    @seipekm
    MemberAuthor

    Alte Pakete geloescht — geprueft

    Mit derselben Methode wie bei der Freigabepruefung: Ein anonymer Manifest-Abruf liefert bei ghcr.io/seipekm/vereinorder-{backend,frontend,print-worker} jetzt HTTP 403, bei ghcr.io/mku-solution/... unveraendert HTTP 200.

    Der alte Namensraum ist damit fort, der neue traegt.

    Was das aendert

    Der Rueckweg ueber den alten Namensraum existiert nicht mehr. Ein Geraet, das noch nicht umgestellt ist, laeuft weiter — seine Abbilder liegen oertlich vor und restart: always greift auf sie zu —, aber sein naechster ./scripts/ops/upgrade.sh scheitert beim Ziehen, weil docker-compose.yml dort noch auf ghcr.io/seipekm/... zeigt.

    Fuer solche Geraete ist die Umstellung jetzt keine Wahl mehr, sondern die einzige Richtung. Sie ist unveraendert einfach:

    git pull origin main
    export ADMIN_TOKEN='<aktuelles Administrator-JWT>'
    ./scripts/ops/upgrade.sh
    docker compose images

    Der git pull ist der entscheidende erste Schritt: Er bringt die Compose-Datei mit dem neuen Namensraum. Ohne ihn zieht das Skript weiterhin ins Leere. Die Weiterleitung der alten Repository-Adresse traegt, das Remote muss dafuer nicht umgestellt werden.

    Der abschliessende docker compose images ist der einzige echte Nachweis dieses Schrittes — dort muss ghcr.io/mku-solution/... stehen. Die CI kann ihn nicht fuehren: Ihr Buendel-Auftrag setzt VEREINORDER_BUILD: "1" und baut oertlich, statt zu ziehen.

    Stand

    Aus Sicht des Repositories ist der Umzug abgeschlossen und in allen Punkten nachgewiesen. Dieses Issue bleibt offen, bis die Geraete umgestellt sind — das ist der letzte Punkt seiner eigenen Reihenfolge und der einzige, der ausserhalb des Repositories liegt.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    dockerContainer und Docker ComposeoperationsInstallation, Betrieb und Wiederherstellung

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions