From 86b9bbdb7876df226c1f3ae59e32946eb9d9cef4 Mon Sep 17 00:00:00 2001 From: Lars Stommer Date: Sat, 24 Oct 2026 21:02:32 +0200 Subject: [PATCH] Configure Strato ~/Karatewiki deployment, dynamic wgServer fix, and update docs --- .gitea/workflows/deploy-prod.yml | 57 +++++++++++++++++++++++++++++--- AGENTS.md | 2 +- config/LocalSettings.php | 12 ++++++- docs/ARCHITECTURE_AND_STATUS.md | 42 ++++++++++++++++------- docs/DEPLOYMENT.md | 5 +-- 5 files changed, 98 insertions(+), 20 deletions(-) diff --git a/.gitea/workflows/deploy-prod.yml b/.gitea/workflows/deploy-prod.yml index 1207fbb..98c31b7 100644 --- a/.gitea/workflows/deploy-prod.yml +++ b/.gitea/workflows/deploy-prod.yml @@ -8,10 +8,12 @@ jobs: deploy: runs-on: ubuntu-latest steps: - - name: Deploy Karatewiki to production standby (Raspberry Pi 5) + - name: Deploy Karatewiki to Strato (~/Karatewiki) & Pi Standby + env: + DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }} run: | set -e - echo "=== Deploying Karatewiki to PRODUCTION (Pi Standby) ===" + echo "=== [1/2] Deploying Karatewiki to PRODUCTION Standby (Raspberry Pi 5) ===" REPO="http://192.168.2.144:3000/Lars/karatewiki.git" TARGET="/home/lars/docker/karatewiki" mkdir -p "$TARGET" @@ -72,5 +74,52 @@ jobs: docker compose logs mediawiki --tail 150 || true exit 1 fi - echo "PROD MediaWiki API OK (http://192.168.2.49:3008)" - echo "=== Karatewiki PROD deploy complete ===" + echo "PROD Standby MediaWiki API OK (http://192.168.2.49:3008)" + + echo "=== [2/2] Deploying Karatewiki Config & Extensions to Strato (~/Karatewiki) ===" + SSH_KEY_FILE="" + cleanup_key() { + if [ -n "${TEMP_KEY:-}" ] && [ -f "${TEMP_KEY:-}" ]; then + rm -f "$TEMP_KEY" + fi + } + trap cleanup_key EXIT + + if [ -n "${DEPLOY_SSH_KEY:-}" ]; then + TEMP_KEY="$(mktemp)" + chmod 600 "$TEMP_KEY" + printf '%s\n' "$DEPLOY_SSH_KEY" > "$TEMP_KEY" + SSH_KEY_FILE="$TEMP_KEY" + elif [ -f "$HOME/.ssh/strato_fewo" ]; then + SSH_KEY_FILE="$HOME/.ssh/strato_fewo" + fi + + if [ -n "$SSH_KEY_FILE" ]; then + STRATO_HOST="51539426.ssh.w1.strato.hosting" + STRATO_USER="stu100093250" + mkdir -p "$HOME/.ssh" + ssh-keyscan -H "$STRATO_HOST" >> "$HOME/.ssh/known_hosts" 2>/dev/null || true + SSH_OPTS=(-i "$SSH_KEY_FILE" -o BatchMode=yes -o StrictHostKeyChecking=accept-new) + + tar -czf - \ + config/LocalSettings.php \ + config/php-uploads.ini \ + assets/ \ + extensions-custom/KarateMedia/ \ + | ssh "${SSH_OPTS[@]}" "${STRATO_USER}@${STRATO_HOST}" ' + set -e + TMP_DEPLOY="$(mktemp -d)" + tar -xzf - -C "$TMP_DEPLOY" + cp "$TMP_DEPLOY/config/LocalSettings.php" ~/Karatewiki/LocalSettings.php + cp "$TMP_DEPLOY/config/php-uploads.ini" ~/Karatewiki/php.ini + cp "$TMP_DEPLOY/config/php-uploads.ini" ~/Karatewiki/.user.ini + cp -r "$TMP_DEPLOY/assets/"* ~/Karatewiki/resources/assets/ + rm -rf ~/Karatewiki/extensions/KarateMedia + cp -r "$TMP_DEPLOY/extensions-custom/KarateMedia" ~/Karatewiki/extensions/KarateMedia + rm -rf "$TMP_DEPLOY" + /opt/RZphp84/bin/php-cli ~/Karatewiki/maintenance/run.php update --quick + ' + echo "=== Strato ~/Karatewiki erfolgreich aktualisiert! ===" + else + echo "WARNUNG: Kein DEPLOY_SSH_KEY gefunden – Strato-Update uebersprungen." + fi diff --git a/AGENTS.md b/AGENTS.md index dfd949a..2028ab9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,6 @@ # Karatewiki (Goju-Kai Dojo) – Agenten-Leitfaden -Dieses Repository verwaltet die MediaWiki-Konfiguration ([`config/LocalSettings.php`](config/LocalSettings.php)), das Docker-Setup (MediaWiki 1.43 LTS + MariaDB 11.8) und unsere eigenen Erweiterungen ([`extensions-custom/KarateMedia`](extensions-custom/KarateMedia)) für das Vereins-Wiki des Goju-Kai Dojo (`https://www.gojukai-dojo.de`). +Dieses Repository verwaltet die MediaWiki-Konfiguration ([`config/LocalSettings.php`](config/LocalSettings.php)), das Docker-Setup (MediaWiki 1.46 + MariaDB 11.8) und unsere eigenen Erweiterungen ([`extensions-custom/KarateMedia`](extensions-custom/KarateMedia)) für das Vereins-Wiki des Goju-Kai Dojo (`https://www.gojukai-dojo.de`). ## 📚 Pflichtlektüre beim Start einer neuen Session (z.B. auf einem anderen PC) diff --git a/config/LocalSettings.php b/config/LocalSettings.php index 5488c12..e4bc43f 100644 --- a/config/LocalSettings.php +++ b/config/LocalSettings.php @@ -35,7 +35,17 @@ $wgLanguageCode = 'de'; $wgScriptPath = ''; $wgScriptExtension = '.php'; -$wgServer = getenv( 'MW_SERVER' ) ?: ( $wgServer ?? 'https://www.gojukai-dojo.de' ); +if ( getenv( 'MW_SERVER' ) ) { + $wgServer = getenv( 'MW_SERVER' ); +} elseif ( empty( $wgServer ) ) { + if ( !empty( $_SERVER['HTTP_HOST'] ) ) { + $isHttps = ( !empty( $_SERVER['HTTPS'] ) && $_SERVER['HTTPS'] !== 'off' ) + || ( ( $_SERVER['HTTP_X_FORWARDED_PROTO'] ?? '' ) === 'https' ); + $wgServer = ( $isHttps ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST']; + } else { + $wgServer = 'https://www.gojukai-dojo.de'; + } +} $wgStylePath = "$wgScriptPath/skins"; $wgResourceBasePath = $wgScriptPath; diff --git a/docs/ARCHITECTURE_AND_STATUS.md b/docs/ARCHITECTURE_AND_STATUS.md index 3b2c907..1dd8c6e 100644 --- a/docs/ARCHITECTURE_AND_STATUS.md +++ b/docs/ARCHITECTURE_AND_STATUS.md @@ -95,12 +95,13 @@ In der bisherigen `LocalSettings.php` auf Strato waren **zwei** veraltete Video- ## 3. Architektur- & Design-Entscheidungen ### Entscheidung 1: Kein MediaWiki-Core im Git-Repository -Da am MediaWiki-Core niemals manuell herumgepatcht wurde, wird der MediaWiki-Core **nicht** in Gitea eingecheckt. Stattdessen kommt der Core im Docker-Betrieb direkt aus dem offiziellen Multi-Arch-Image `mediawiki:1.43` (LTS). Das hält das Git-Repository winzig (< 100 KB) und erlaubt zukünftige MediaWiki- oder PHP-Versionssprünge durch Ändern einer einzigen Versionsnummer im [`Dockerfile`](../Dockerfile). +Da am MediaWiki-Core niemals manuell herumgepatcht wurde, wird der MediaWiki-Core **nicht** in Gitea eingecheckt. Stattdessen kommt der Core im Docker-Betrieb direkt aus dem offiziellen Multi-Arch-Image `mediawiki:1.46` (`1.46.2`). Das hält das Git-Repository winzig (< 100 KB) und erlaubt zukünftige MediaWiki- oder PHP-Versionssprünge durch Ändern einer einzigen Versionsnummer im [`Dockerfile`](../Dockerfile). -### Entscheidung 2: Eigene Kombi-Extension `KarateMedia` statt Drittanbieter-Video-Plugins +### Entscheidung 2: Eigene Kombi-Extension `KarateMedia` & Vereins-Anmeldeseite Anstatt erneut fremde Video-Plugins zu installieren, haben wir unter [`extensions-custom/KarateMedia/`](../extensions-custom/KarateMedia/) eine eigene, exakt auf das Karate-Wiki zugeschnittene MediaWiki-Extension entwickelt: * **100 % Abwärtskompatibel:** Sie implementiert sowohl den Parser-Hook `` ([`KarateMediaHooks.php`](../extensions-custom/KarateMedia/src/KarateMediaHooks.php)) für die 87 alten Seiten als auch den `MediaHandler` ([`KarateVideoHandler.php`](../extensions-custom/KarateMedia/src/KarateVideoHandler.php)) für die ~71 Seiten mit `[[Datei:*.mp4|mini|...]]`. Es muss **keine einzige Wiki-Seite** umgeschrieben werden! * **Mehrwert fürs Karate-Training:** Unter jedem Video rendert `KarateMedia` automatisch kompakte Steuerbuttons für **`1x` | `0.5x` | `0.25x` | `Loop`** ([`karatemedia.js`](../extensions-custom/KarateMedia/resources/karatemedia.js)), damit Kata- und Bunkai-Techniken direkt in Zeitlupe und Endlosschleife studiert werden können. +* **Moderne Vereins-Anmeldeseite & Direkter Login-Redirect:** Unangemeldete Besucher werden ohne Zwischenseite (`Special:Badtitle` / „Anmeldung erforderlich“) sofort per `302`-Redirect auf `Spezial:Anmelden` geleitet. Dort erscheint eine maßgeschneiderte Anmelde-Card im Design von Goju-Kai Dojo Heilbronn e.V. mit dem offiziellen Vektor-Vereinslogo ([`assets/logo-light.svg`](../assets/logo-light.svg) auf dunklem Header, [`assets/logo.svg`](../assets/logo.svg) in der hellen Wiki-Seitenleiste) und dem direkten Link zum Beantragen von Zugangsdaten im Vereinsshop (`https://shop.karate.hn/produkt/zugang-zu-vereinseigenem-karatewiki-20`). ### Entscheidung 3: Fehlertolerante `LocalSettings.php` für Docker UND Strato Die neue [`config/LocalSettings.php`](../config/LocalSettings.php) ist so aufgebaut, dass sie: @@ -148,20 +149,37 @@ Details zum Deployment stehen in [`docs/DEPLOYMENT.md`](DEPLOYMENT.md). Kurzfass --- -## 6. Aktueller Arbeitsstand & Nächste Schritte (Roadmap) +## 6. Neue Strato-Parallelinstallation (`~/Karatewiki` & `~/karatewiki-shared`) + +Um auf Strato ohne Ausfallzeit des bestehenden Systems (`~/Karate_Wiki_135`) auf die neueste MediaWiki-Version (`1.46.2`), PHP `8.4` und MariaDB `11.8` umzustellen und gleichzeitig den über Jahre angesammelten Dateimüll (3,5 GB Temp-/Archiv-/Waisen-Dateien) zu beseitigen, wurde folgende saubere Struktur auf Strato aufgebaut: + +* **Neues Anwendungsverzeichnis (versionsunabhängig):** `~/Karatewiki` (MediaWiki `1.46.2`, PHP `8.4` via `.htaccess`, `MsUpload` für Drag-&-Drop-Mehrfach-Uploads bis `500M`, `KarateMedia` sowie Datei- und Beschleuniger-Caching). +* **Zentrales, bereinigtes Medien- & Secrets-Verzeichnis:** `~/karatewiki-shared/` + * `~/karatewiki-shared/images` (per Symlink in `~/Karatewiki/images` eingebunden): Enthält **ausschließlich die 566 tatsächlich im Wiki verlinkten Mediendateien (4,79 GB)** per Hardlink (0 Byte zusätzlicher Speicherplatzverbrauch, 0 Byte Altlasten). + * `~/karatewiki-shared/LocalSettings.secrets.php` (`chmod 600`, per Symlink in `~/Karatewiki/LocalSettings.secrets.php` eingebunden). +* **Neue MariaDB 11.8 Datenbank auf Strato:** + * **Host:** `database-5021739551.webspace-host.com` + * **Datenbank:** `dbs16266664` + * **Benutzer:** `dbu3366014` + * **Tabellen-Präfix:** `Karate_` +* **Altsystem (`~/Karate_Wiki_135` + alte MySQL 5.7 DB `dbs1754262`):** Bleibt während der gesamten Testphase auf einer Testdomain zu 100 % unverändert als sofortiges Fallback bestehen, bis die Hauptdomain `www.gojukai-dojo.de` im Strato-Kundenmenü auf `/Karatewiki` umgestellt wird. + +--- + +## 7. Aktueller Arbeitsstand & Nächste Schritte (Roadmap) ### ✅ Bereits erledigt: - [x] Rein lesende Bestandsaufnahme des Strato-Produktivsystems (`Karate_Wiki_135`) und der MySQL-Datenbank (`dbs1754262`). - [x] Auswertung aller 1.028 Wiki-Seiten und Identifikation aller Video-Einbindungen (87× ``, ~71× `[[Datei:*.mp4]]`). - [x] Auswertung des Medienbestands: Von 8,3 GB `images/` auf Strato sind **566 Dateien (4,79 GB)** tatsächlich auf Seiten eingebunden (Rest: 1,8 GB `temp/`, 514 MB `archive/`, 648 MB verwaiste Uploads). - [x] Entwicklung der eigenen Extension **`KarateMedia`** (`extensions-custom/KarateMedia/`) als Ersatz für `Html5mediator` und `EmbedVideo` (inkl. Zeitlupe `0.5x`/`0.25x` und `Loop`). -- [x] Bereinigung und Modernisierung der `LocalSettings.php` (`config/LocalSettings.php`). -- [x] Aufbau der Docker-Konfiguration für MediaWiki 1.43 LTS + MariaDB 11.8 (`Dockerfile`, `docker-compose.yml`, `docker-compose.dev-env.yml`). -- [x] Gemeinsames Medien-Volume (`karatewiki-dev_dev-karatewiki-images`) konfiguriert, damit die 4,79 GB Mediendateien auf dem Raspberry Pi nicht doppelt für Dev und Prod abgelegt werden. -- [x] Erfolgreicher Erst-Import aller 1.028 Seiten, Datenbank-Upgrade von MediaWiki 1.35.1 auf **1.43.11 LTS** und Sync aller **566 verdrahteten Mediendateien (4,79 GB)** auf den Raspberry Pi 5 (`http://192.168.2.49:3093`). -- [x] Erfolgreicher Funktionstest von `` (z.B. *Tensho*) und `[[Datei:*.mp4]]` (z.B. *Seienchin*) inklusive Zeitlupen-Steuerung auf `http://192.168.2.49:3093`. +- [x] Gestaltung der modernen **Goju-Kai Dojo Heilbronn e.V. Vereins-Anmeldeseite** (`Spezial:Anmelden`) inkl. Direkt-Redirect für geschützte Seiten, offiziellem Vektor-Logo (`logo.svg` / `logo-light.svg`) von `karate.hn` und Shop-Link. +- [x] Bereinigung und Modernisierung der `LocalSettings.php` (`config/LocalSettings.php`) inkl. `MsUpload`-Integration (Multi-File Drag & Drop bis 500 MB) und Performance-Caching. +- [x] Aufbau der Docker-Konfiguration und Upgrade auf **MediaWiki 1.46.2** + MariaDB 11.8 (`Dockerfile`, `docker-compose.yml`, `docker-compose.dev-env.yml`). +- [x] Gemeinsames Medien-Volume (`karatewiki-dev_dev-karatewiki-images`) auf dem Raspberry Pi 5 (`http://192.168.2.49:3093`) eingerichtet und erfolgreich getestet. +- [x] Aufbau der neuen Strato-Parallelinstallation unter `~/Karatewiki` mit zentralem Medienordner `~/karatewiki-shared/images` (4,79 GB bereinigt) und neuer MariaDB 11.8 (`dbs16266664` auf `database-5021739551.webspace-host.com`). -### 🔜 Offene Punkte / Nächste Schritte: -- [ ] **1. Optionale Drittanbieter-Extensions prüfen:** Entscheiden, welche der früheren Zusatz-Extensions (`MsUpload`, `UploadWizard`, `MobileFrontend`, `LinkTitles`, `EditUser`) in MediaWiki 1.43 weiterhin benötigt werden, und diese im `Dockerfile` ergänzen. -- [ ] **2. Gewünschte Vereins-Modifikationen umsetzen:** Neue Features und Anpassungen auf dem `develop`-Branch entwickeln und unter `http://192.168.2.49:3093` testen. -- [ ] **3. Langfristige Betriebsentscheidung (Pi vs. Strato):** Entscheiden, ob das Wiki künftig komplett über die eigene Infrastruktur (deutlich schnellere Performance!) betrieben oder zurück nach Strato ausgerollt werden soll. +### 🔜 Nächste Schritte: +- [ ] **1. Testdomain bei Strato auf `/Karatewiki` zeigen lassen:** Im Strato-Kundenmenü eine Testdomain/Subdomain auf das Verzeichnis `/Karatewiki` richten und Login, Videos und `MsUpload` live auf Strato prüfen. +- [ ] **2. Domain-Umschaltung (`www.gojukai-dojo.de`):** Nach erfolgreichem Test die Hauptdomain `www.gojukai-dojo.de` im Strato-Kundenmenü von `/Karate_Wiki_135` auf `/Karatewiki` umstellen. +- [ ] **3. Altlasten-Bereinigung nach Bewährungsphase:** Sobald `/Karatewiki` im Live-Betrieb stabil läuft, kann das alte Verzeichnis `~/Karate_Wiki_135` (inkl. 3,5 GB Dateimüll) und die alte MySQL 5.7 Datenbank `dbs1754262` gelöscht werden (die 566 Hardlinks in `~/karatewiki-shared/images` bleiben dabei vollständig erhalten!). diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md index 912d72c..fd5ecb2 100644 --- a/docs/DEPLOYMENT.md +++ b/docs/DEPLOYMENT.md @@ -5,7 +5,8 @@ **Runner:** Gitea Actions (`/home/lars/gitea-runner/`), Label `ubuntu-latest` **Repo (intern):** `http://192.168.2.144:3000/Lars/karatewiki.git` **Repo (extern):** `https://gitea.stommer.de/Lars/karatewiki.git` -**Strato-Produktivsystem:** `51539426.ssh.w1.strato.hosting` (`/Karate_Wiki_135`, Domain `https://www.gojukai-dojo.de`) +**Strato-Produktivsystem (Neu, MediaWiki 1.46.2):** `51539426.ssh.w1.strato.hosting` (`~/Karatewiki`, geteilte Medien in `~/karatewiki-shared/images`, MariaDB 11.8 `dbs16266664` auf `database-5021739551.webspace-host.com`) +**Strato-Altsystem (Fallback, MediaWiki 1.35.1):** `51539426.ssh.w1.strato.hosting` (`~/Karate_Wiki_135`, MySQL 5.7 `dbs1754262` auf `rdbms.strato.de`) Unter `/home/lars/docker/` legt der Gitea-Runner auf dem Raspberry Pi 5 diese zwei Verzeichnisse an: @@ -25,7 +26,7 @@ Unter `/home/lars/docker/` legt der Gitea-Runner auf dem Raspberry Pi 5 diese zw | Workflow | Trigger | Zweck | |----------|---------|--------| | `deploy-dev.yml` | Push `develop` | Deploy nach `/home/lars/docker/karatewiki-dev`, Schema-Check/Update, Healthcheck `localhost:3093/api.php` | -| `deploy-prod.yml` | Push `main` | Deploy nach `/home/lars/docker/karatewiki`, Schema-Check/Update, Healthcheck `localhost:3008/api.php` | +| `deploy-prod.yml` | Push `main` | Deploy nach `/home/lars/docker/karatewiki` (Pi-Standby) **und** automatisches Deployment von `LocalSettings.php`, `assets/` und `extensions/KarateMedia/` nach Strato (`~/Karatewiki`) | Gearbeitet wird auf `develop`. Ein Push auf `develop` baut automatisch den Development-Container auf dem Raspberry Pi 5 (`http://192.168.2.49:3093`). Ein Merge-Commit `develop` → `main` (`git merge --no-ff develop` auf `main`) und anschließender Push von `main` aktualisiert die Production-/Standby-Instanz (`http://192.168.2.49:3008`).