Repo setup first commit

README-ubuntu-docker.md

@@ -0,0 +1,96 @@
+# Ubuntu 24.04/26.04 Docker Build Environment for Legatus LTS
+
+## ⚠️ Wichtiger Hinweis (2026-08-18)
+
+**Ubuntu 24.04 und 26.04 haben KEINE Qt6-Pakete in den Standard-Repositories.**
+
+Nach umfassender Untersuchung:
+- `apt-cache search qt6` liefert 0 Ergebnisse auf Ubuntu 24.04/26.04
+- beinerji/opt-qt-6.8.2-noble PPA ist unzuverlässig/defekt
+- Qt.io bietet keine einfachen tar.xz-Downloads für CI-Automatisierung
+
+**Empfohlene Lösung für CI**: Verwende **openSUSE Leap 15.5** mit KDE:Qt6 Repository (siehe `Dockerfile-opensuse-qt6.dockerfile`).
+
+Die Ubuntu-Infrastruktur (`Dockerfile-ubuntu26.04.dockerfile`, `jenkins_builder_ubuntu26.sh`, `make_rpm_ubuntu26.py`) ist für zukünftige Ubuntu-Unterstützung vorbereitet.
+
+---
+
+## Qt6 Installation Options
+
+Ubuntu 24.04 hat keine Qt6-Pakete in den Standard-Repos. Es gibt drei Optionen:
+
+### Option 1: Qt von Host mounten (Empfohlen für lokale Entwicklung)
+
+```bash
+# Qt6 auf Host installieren (z.B. unter /opt/Qt)
+# Dann Docker mit mount starten:
+docker run --rm -v $(pwd):/repo -v /opt/Qt:/opt/Qt \
+  -e CMAKE_PREFIX_PATH=/opt/Qt/6.8.2/gcc_64/lib/cmake \
+  -e PATH=/opt/Qt/6.8.2/gcc_64/bin:$PATH \
+  legatus-ubuntu24.04:latest
+```
+
+### Option 2: Qt Offline Installer im Dockerfile
+
+```dockerfile
+# Qt Account Credentials als Build-Args
+ARG QT_USERNAME
+ARG QT_PASSWORD
+
+# Installer herunterladen und im silent mode installieren
+RUN wget -q https://download.qt.io/official_releases/online_installers/qt-unified-linux-x64-online.run && \
+    chmod +x qt-unified-linux-x64-online.run && \
+    echo "[Defaults]" > qt.conf && \
+    echo "CredentialsId=QtAccount" >> qt.conf && \
+    ./qt-unified-linux-x64-online.run --script qt-installer.qs && \
+    rm qt-unified-linux-x64-online.run qt.conf
+```
+
+### Option 3: Pre-built Docker Image verwenden
+
+Ein separates Docker-Image mit vorinstalliertem Qt6 verwenden:
+```bash
+docker pull <your-registry>/legatus-qt6-ubuntu24.04:latest
+```
+
+### Option 4: openSUSE Leap Docker (bereits funktionierend)
+
+Das bestehende `Dockerfile-opensuse-leap.dockerfile` verwendet openSUSE mit Qt6 aus den offiziellen Repos:
+```bash
+docker build -t legatus-opensuse:latest -f jenkins/Dockerfile-opensuse-leap.dockerfile jenkins/
+```
+
+## Build Dependencies
+
+Dieses Dockerfile installiert alle notwendigen Build-Dependencies außer Qt6:
+- build-essential, cmake, ninja-build
+- libboost-all-dev, libgeographic-dev
+- libssl-dev, libcurl4-openssl-dev
+- clang-tidy, clang-format
+
+## Verwendung
+
+```bash
+# Docker Image bauen (ohne Qt6)
+docker build -t legatus-ubuntu24.04:latest -f Dockerfile-ubuntu26.04.dockerfile .
+
+# Mit Qt6 vom Host mounten
+docker run --rm -v $(pwd):/repo -v /opt/Qt:/opt/Qt \
+  -e CMAKE_PREFIX_PATH=/opt/Qt/6.8.2/gcc_64/lib/cmake \
+  legatus-ubuntu24.04:latest \
+  cmake -S /repo/qt-migration-legatus/qt6-after/qt6-migrated-legatus \
+        -B /repo/build -DCMAKE_BUILD_TYPE=Debug
+
+# Build ausführen
+docker run --rm -v $(pwd):/repo -v /opt/Qt:/opt/Qt \
+  -e CMAKE_PREFIX_PATH=/opt/Qt/6.8.2/gcc_64/lib/cmake \
+  legatus-ubuntu24.04:latest \
+  cmake --build /repo/build --parallel $(nproc)
+```
+
+## Hinweis für CI/CD
+
+Für Jenkins/GitLab CI wird empfohlen:
+1. Ein Basis-Image mit Qt6 zu bauen und in einer Registry zu speichern
+2. Oder Qt6 auf dem CI-Host zu installieren und ins Docker-Image zu mounten
+3. Oder das bewährte openSUSE-Image zu verwenden