Deutsch | English
mRomexis Web App
Der Dienst romexis-app stellt das Planmeca-mRomexis-Webfrontend als separaten Container bereit.
Die Webanwendung wird von Tomcat ausgeliefert und bleibt vom Romexis-Server-Container getrennt.
Versionsanforderung
Die WAR-Datei der mRomexis Web App ist nur in Romexis 6.5.3 und neuer verfügbar.
Erwarteter Payload-Pfad:
/opt/romexis/broker/mromexis-html.war
Während des Image-Builds wird diese WAR-Datei wie folgt nach Tomcat kopiert:
/usr/local/tomcat/webapps/ROOT.war
Ältere Romexis-Payload-Versionen enthalten die WAR-Datei nicht und können daher kein gültiges mRomexis-Web-App-Image bauen.
Laufzeitdienste
romexis-app
Tomcat container serving ROOT.war.
proxy
OpenResty/Nginx proxy exposing the app and rewriting backend proxy requests.
romexis
Romexis backend service used by the web app through the internal proxy target.
Zugriff
Die mRomexis Web App über den konfigurierten Proxy-Port öffnen:
http://localhost:8081
Wenn MROMEXIS_WEB_PORT geändert wird, muss der Port entsprechend angepasst werden.
Proxy-Verhalten
Der Proxy verarbeitet Anforderungen der Webanwendung und schreibt mRomexis-Backend-Proxy-Aufrufe auf den internen Romexis-Dienst um.
Der Proxy vertraut nicht dem vom Browser gelieferten Host aus /proxy?url=....
Stattdessen extrahiert er ausschließlich Pfad und Query-String und leitet die Anfrage weiter an:
http://romexis:8093
Dies vermeidet die Pflege interner IP-Adressen und verhindert, dass der Endpunkt zu einem offenen HTTP-Proxy wird.
Image-Tags
gitea.buchhorster.de/planmeca/romexis-mromexis-app:<version>-amd64
gitea.buchhorster.de/planmeca/romexis-mromexis-app:<version>-arm64
gitea.buchhorster.de/planmeca/romexis-mromexis-app:<version>
gitea.buchhorster.de/planmeca/romexis-mromexis-app:latest
Lokaler Build
Build über das lokale Hilfsskript:
./scripts/build-local.sh mromexis
Oder manuell:
docker buildx build --platform linux/amd64 --provenance=false --sbom=false --build-arg TARGETARCH=amd64 --build-arg ROMEXIS_VERSION=6.5.3.444.203 --build-arg ROMEXIS_PAYLOAD_IMAGE=gitea.buchhorster.de/planmeca/romexis-payload:6.5.3.444.203 -t gitea.buchhorster.de/planmeca/romexis-mromexis-app:6.5.3.444.203-amd64 --load ./romexis-mromexis-app
Fehlersuche
WAR-Datei nicht gefunden
Wenn der Build beim Kopieren von mromexis-html.war fehlschlägt, muss geprüft werden, ob die ausgewählte Romexis-Payload-Version 6.5.3 oder neuer ist.
docker run --rm --entrypoint find gitea.buchhorster.de/planmeca/romexis-payload:6.5.3.444.203 /opt/romexis -name 'mromexis-html.war'
Webanwendung startet, Backend-Aufrufe schlagen jedoch fehl
Proxy-Protokolle prüfen:
docker compose logs -f proxy
Prüfen, ob der Romexis-Backend-Dienst intern erreichbar ist:
docker compose exec proxy wget -O- http://romexis:8093/ || true
Romexis Docker Wiki
English
Getting Started
- Project Overview
- Architecture
- Quick Start
- Synology Quick Start
- Use with Docker + WSL in Windows
- Compose Runtime
- Configuration
- Container Images
Runtime Services
- Romexis Admin
- Romexis Client
- mRomexis Web App
- Runtime Layout
- Backup and Restore
- Troubleshooting
- Security
Build System
Database
Migration
Development
Source Documents
Deutsch
Erste Schritte
- Projektübersicht
- Architektur
- Schnellstart
- Synology Quick Start
- Nutzung mit Docker + WSL unter Windows
- Compose-Runtime
- Konfiguration
- Container-Images
Runtime-Dienste
- Romexis Admin
- Romexis Client
- mRomexis Web App
- Runtime-Layout
- Sicherung und Wiederherstellung
- Fehlerbehebung
- Sicherheit
Build-System
Datenbank
Migration
Entwicklung
Quelldokumente
Romexis Docker Project Wiki / Romexis-Docker-Projekt-Wiki
English Home · Deutsche Startseite · English source documents · Deutsche Quelldokumente · Security · Sicherheit
Internal operations and development wiki / Internes Betriebs- und Entwicklungswiki