docker compose / kubernetes Installation

getthemax Top! Hat funktioniert!

Quote from Tobias

OpenXE Docker – Neues Setup verfügbar

Problem

Der aktuelle Docker-Build im OpenXE-Repo funktioniert nicht mehr, und es fehlt eine einfache Möglichkeit, Forks oder Branches in einer sauberen Umgebung zu testen.

Lösung

Ich habe ein neues Docker-Setup entwickelt, das jetzt als Pull Request #226 vorliegt: https://github.com/OpenXE-org/OpenXE/pull/226

Hauptfeatures

Multi-Repository Support

• Teste beliebige Forks und Branches per Umgebungsvariable
• Lokale Entwicklung mit gemounteten Code
• Beispiel: export REPO_URL=https://github.com/user/OpenXE.git && export BRANCH=feature-xyz

Automatisches Upgrade-System

• Nutzt OpenXEs eigenes upgrade.php für DB-Initialisierung
• Automatische Updates bei jedem Container-Start

Komfort

• Optional: Beispieldaten-Import
• Konfigurierbares Admin-Passwort
• Persistente Daten (userdata + DB)

Schnellstart

Code

# Lokale Entwicklung
docker-compose up -d

# Fork testen
export REPO_URL=https://github.com/Avatarsia/OpenXE.git
export BRANCH=api-doc-2
docker-compose up -d --build

Bisherige Ansätze

Es gibt bereits mehrere Docker-Lösungen:

• Repo docker-compose.yml – funktioniert nicht mehr
• tsgoff/docker-openxe – nächtliche Builds, externes Repo
• getthemax/OpenXE-docker – lokaler Build, externes Repo
• cherrymint – Alpine-basiert, kein vollständiger Stack

Motivation

Konkreter Auslöser war die API-Dokumentation (PR von Avatarsia) – ich wollte den Branch schnell in einer frischen Umgebung testen. Dabei ist mir aufgefallen, dass das aktuelle Docker-Setup kaputt ist und es keinen einheitlichen Workflow gibt.

Ausblick

Langfristig wäre ein Base-Image mit regelmäßigen Builds (GitHub Actions) sinnvoll um lokale Redundanzen zu sparen. Dieser PR ist ein erster Schritt zur Vereinheitlichung.

Feedback erwünscht

Schaut euch den PR an und gebt gerne Feedback! Ziel ist es, einen wartbaren, flexiblen Docker-Workflow für alle zu schaffen – sowohl für Entwicklung als auch Testing und falls möglich im produktiven Einsatz.

Pull Request: https://github.com/OpenXE-org/OpenXE/pull/226

Display More

schau dir auch meinen PR an für den Upgrader, das macht es leichter die einzelnen branches zu wechseln um änderungen zu testen

Quote from Tobias

Umfangreicher PR
Ich würde die Themen gerne segmentieren und mich hier auf das Thema Docker Workflow konzentrieren

war auch mehr als hinweis zu verstehen um das testen einfacher zu machen.
wenn docker läuft wäre das klasse, ich bin nicht so wirklich ein fan von der vbox, aber zur zeit schaue ich was notwenig ist um das ganze php 8.5 kompatibel zu machen

Danke für den PR. Es wäre schön wenn die Docker-Nutzer das mal testen können bevor ich es übernehme.

Vielen Dank für Deine Mühe und den PR.

Dies freut mich gleich in zweifacher Hinsicht. Ich hatte die docker-compose vernachlässigt, da nach meinem Gefühl das ohnehin niemand bzw. kaum jemand benutzt. Eine Integration in Richtung github-Actions hatte ich daher gar nicht erst in Betracht gezogen, halte das aber grundsätzlich für sehr sinnvoll - auch da ich ja Stück für Stück den Javascript-Code modernisiere und dafür vite einsetze.

Auf den ersten Blick habe ich jetzt gesehen, dass der vite-container bei dir rausgeflogen ist. Das würde in der Entwicklung so für mich nicht funktionieren.

Ich begrüße einige deiner Ideen für Entwicklungs- und Test-Umgebungen, würde aber das Auto-Update so wie hier ungern in einem Produktiv-Image haben wollen.

Mein Vorschlag wäre daher, dass wir deinen PR als wirklich guten Start ansehen, aber noch ein paar weitere Schritte gehen, bevor wir den PR mergen.

Um da konkreter werden zu können, muss ich mir aber auch etwas mehr als 15min Zeit nehmen, was ich nicht sofort schaffe. Ich würde mich dazu bald nochmal detaillierter (direkt im PR) zu Wort melden.