Releases und Rollouts

Images bauen, Shops auf Versionen bringen, Kanäle edge und stable, automatische Rollbacks.

Ein Release ist ein Docker-Image-Tag. Jedes Image kennt seine Version (APP_VERSION), jede Health-Route meldet sie – die Plattform zeigt, was wirklich läuft.

#Bauen

Der Workflow .github/workflows/images.yml baut alle Images (storefront, shop-admin, medusa, platform, backup) für arm64:

  • Push auf main → Tags main, latest, sha-<kurz>
  • Git-Tag v2026.10.1 → Tag v2026.10.1

#Ausrollen

bash
pnpm platform shop release testshop sha-61f372f    # ein Shop
pnpm platform stack deploy platform sha-61f372f    # die Plattform

Ein Shop mit anderer gemeldeter Version bekommt in der Plattform das Badge „erwartet …“ (Deploy läuft noch, Pull fehlgeschlagen o. Ä.).

#Kanäle

KanalVerhalten
Edgeneuester Build, sofort
Stabledas als „stable“ markierte Release, im nächtlichen Update-Fenster, ein Shop nach dem anderen
Festkeine automatischen Updates

Jeder Wechsel ist ein Rollout: Danach wird die Gesundheit beobachtet; ein fehlgeschlagenes Update rollt von selbst auf die vorige Version zurück.

Achtung

Medusa führt Migrationen beim Start aus und sie laufen nur vorwärts. Zurück nur auf Releases mit gleichem Datenbankschema – oder ein Backup einspielen.

#Stack-Dateien

Neue Umgebungsvariablen oder Dienste in den Compose-Dateien erreichen einen Shop erst mit shop release (die automatischen Updates ändern nur den Image-Tag).

Zuletzt aktualisiert am 21. Oktober 2026

ZurückAdd-ons bauenWeiter Backups und Wiederherstellungstest