Repository navigation
Description
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,:272undscripts/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.
- Vorher entscheiden: oeffentlich oder privat (siehe unten).
- Transfer durchfuehren.
- Organisation einrichten: Workflow-Berechtigungen, erlaubte Actions, Paketsichtbarkeit.
- CI auf Kleinschreibung berichtigen und einen Veroeffentlichungslauf erfolgreich durchbringen.
- Die drei neuen Pakete oeffentlich stellen und mit dem Repository verknuepfen. Pruefen, dass ein
docker pullohne Anmeldung von einem fremden Rechner aus funktioniert — das ist die Bedingung, unter der der Pi arbeitet. - Erst jetzt
docker-compose.ymlund die Dokumentation umstellen. - 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. - Oertlich:
git remote set-url origin, und die Anmeldung desgh-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
fix(ci): Registry-Namensraum in beiden Docker-Auftraegen klein schrei…
chore(ci): Actions auf node24-faehige Fassungen anheben (#246) (#247)
chore(ops): Verweise auf MKU-Solution vorbereiten (#243)
seipekm commentedon Sep 4, 2026
Stand der Vorbereitung (alles auf
main, Lauf gruen):67c807f(fix(ci): Registry-Namensraum klein schreiben (#243) #245). Heute wirkungslos, nach dem Transfer zwingend. Aufmainnachgewiesen: Die CI erzeugt weiterhinghcr.io/seipekm/vereinorder-*mitlatestund Commit-SHA.eef3e3a(chore(ci): Actions laufen auf abgekuendigtem Node 20 #246). Damit kann beim ersten Veroeffentlichungslauf in der Organisation kein Laufzeitfehler mehr mit einem Fassungsfehler zusammenfallen.Damit ist alles erledigt, was sich vor dem Transfer im Repository erledigen laesst.
seipekm commentedon Sep 4, 2026
Transfer durchgefuehrt — Stand der Nachkontrolle
MKU-Solution/VereinOrder, oeffentlich,mainals Vorgabezweig. Die Weiterleitung der alten Adresse traegt (git fetchueber 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: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 ausdruecklichepackages: 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 unterseipekm: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 pullmitdeniedscheitern lassen.Zu tun, von Hand: Die drei Pakete unter
https://github.com/orgs/MKU-Solution/packagesauf Public stellen und mit dem Repository verknuepfen.2. Der Zweigschutz ist nicht mitgekommen.
mainmeldetBranch not protected. Die zwoelf namentlichen Pflichtpruefungen,strictundenforce_adminsaus #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
seipekmbestehen weiter und sind oeffentlich abrufbar. Laufende Installationen sind nicht betroffen;docker-compose.ymlzeigt weiterhin auf sie. Es gilt aber unveraendert: Bis #248 gemergt ist, darf auf keinem Geraetupgrade.shlaufen — sonst zieht es aus dem alten, ab jetzt eingefrorenen Namensraum und meldet dabei Erfolg.chore(ops): Verweise auf MKU-Solution vorbereiten (#243) (#248)
seipekm commentedon Sep 4, 2026
Umzug aus Sicht des Repositories abgeschlossen
mainsteht auf32dd669(#248).docker-compose.ymlzeigt aufghcr.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(vorher403). Die Markelatestenthaelt beide Plattformen,linux/amd64undlinux/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:
Es muss
ghcr.io/mku-solution/...zeigen. Sich darauf zu verlassen, dassupgrade.shgruen 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
seipekmbleiben 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.
mainmeldetBranch not protected; die zwoelf namentlichen Pflichtpruefungen,strictundenforce_adminsaus #206 gelten derzeit nicht.docs(ci): Kommentare zur Kleinschreibung an den Umzug anpassen (#243) (…
seipekm commentedon Sep 4, 2026
Zweigschutz wiederhergestellt
Nach dem Transfer war
mainungeschuetzt (Branch not protected). Der Zustand aus #206 ist wieder gesetzt und nachgeprueft:Die zwoelf Namen wurden nicht abgetippt, sondern aus einem echten Lauf uebernommen (
gh pr checks --json name). BeiDocker-Bündel Aktualisierung (upgrade.sh, PRE_MIGRATION vor Migration)undGeheimnispruefungwaere 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, weilseipekmbereits 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.mdund 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 AktualisierungsetztVEREINORDER_BUILD: "1"—upgrade.shbaut dort oertlich und zieht nie. Der Weg, den jedes Geraet gehen wird (docker compose pullausghcr.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 Markelatestenthaeltlinux/amd64undlinux/arm64.Der Rest faellt beim ersten echten Geraet. Deshalb ist der Blick auf
docker compose imagesnach dem erstenupgrade.shkein 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 fehltdelete:packages. Der Schritt bleibt beim Betreiber, unterhttps://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.shfehl. Laufende Container beruehrt das nicht. Am ruhigsten ist die Reihenfolge: erst die Geraete umstellen, dann loeschen.seipekm commentedon Sep 4, 2026
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}jetztHTTP 403, beighcr.io/mku-solution/...unveraendertHTTP 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: alwaysgreift auf sie zu —, aber sein naechster./scripts/ops/upgrade.shscheitert beim Ziehen, weildocker-compose.ymldort noch aufghcr.io/seipekm/...zeigt.Fuer solche Geraete ist die Umstellung jetzt keine Wahl mehr, sondern die einzige Richtung. Sie ist unveraendert einfach:
Der
git pullist 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 imagesist der einzige echte Nachweis dieses Schrittes — dort mussghcr.io/mku-solution/...stehen. Die CI kann ihn nicht fuehren: Ihr Buendel-Auftrag setztVEREINORDER_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.