Conrad Schulz
1ed8766be3
All checks were successful
Docker Build & Push / build (push) Successful in 1m58s
83 lines
2.5 KiB
Markdown
83 lines
2.5 KiB
Markdown
# Install Instructions
|
||
|
||
```
|
||
$ sudo docker-compose up -d
|
||
```
|
||
|
||
## CI/CD
|
||
|
||
Dieses Repo nutzt **Woodpecker CI** (via `.woodpecker.yml`) für automatische Docker-Builds.
|
||
|
||
| Event | Aktion |
|
||
|---|---|
|
||
| Push auf `main` | Build + Push → `192.168.178.6:8083/cschulz/rd13_media_wiki:latest` |
|
||
| Pull Request auf `main` | Build only (dry-run, kein Push) |
|
||
|
||
**Forgejo Actions ist deaktiviert** (`[actions] ENABLED = false` in `app.ini`).
|
||
Der "waiting"-Status im Forgejo-Actions-Tab kann ignoriert werden – Woodpecker übernimmt alle CI-Aufgaben.
|
||
|
||
Benötigte Woodpecker-Secrets:
|
||
- `RD13_MW_DOCKER_BUILD_TOKEN` – Forgejo Access Token mit `write:packages` Scope
|
||
|
||
## Setup and use our own Tile Server
|
||
This is needed to use maps in extensions.
|
||
|
||
Dieses Repo ist auf einen externen Martin Tile Server ausgelegt.
|
||
|
||
### Voraussetzung
|
||
- Martin ist erreichbar (z. B. https://tiles.rd13server.de)
|
||
- tileserver-gl liefert gerenderte Raster-Styles unter /styles/<style_id>
|
||
- Der Proxy routet /styles/osm-intl, /styles/world, /styles/europa-detail und /styles/satelite-world an tileserver-gl.
|
||
|
||
### LocalSettings Konfiguration
|
||
In LocalSettings.php:
|
||
|
||
```php
|
||
wfLoadExtension( 'Kartographer' );
|
||
$wgKartographerMapServer = 'https://tiles.rd13server.de/styles';
|
||
$wgKartographerStyles = [
|
||
'world',
|
||
'europa-detail',
|
||
'satelite-world',
|
||
'osm-intl',
|
||
];
|
||
$wgKartographerDfltStyle = 'world';
|
||
$wgKartographerSrcsetScales = [ 1 ];
|
||
```
|
||
|
||
Kartographer baut daraus URLs wie `https://tiles.rd13server.de/styles/world/{z}/{x}/{y}.png`.
|
||
|
||
Beispiel fuer einen anderen Stil auf derselben Seite:
|
||
|
||
```wiki
|
||
<mapframe mapstyle="europa-detail" text="Detailkarte" zoom="12" latitude="48.137" longitude="11.576" width="420" height="300" />
|
||
```
|
||
|
||
### Schnelltest im Wiki
|
||
```wiki
|
||
<mapframe text="Muenchen" zoom="12" latitude="48.137" longitude="11.576" width="420" height="300" />
|
||
```
|
||
|
||
# Update of Media Wiki
|
||
|
||
## Update of the MediaWiki Core
|
||
|
||
Um ein neues Docker-Image mit der neusten Version zu bauen, kann man entweder einen neuen Commit auf `main` pushen (Woodpecker CI baut und pushed das Image automatisch), oder den Build-Workflow händisch in Woodpecker über die UI auslösen.
|
||
|
||
Nach dem das neue Images gebaut ist, kann es mit gepulled und gestartet werden.
|
||
Hierfür kann man folgende Kommandos nehmen.
|
||
|
||
```
|
||
$ sudo docker-compose down
|
||
$ sudo docker-compose pull
|
||
$ sudo docker-compose up -d
|
||
```
|
||
|
||
Tried to update to 1.39 from 1.35.5 did not work. Maybe a step by step update is needed now from 1.35.9
|
||
|
||
## Update of Plugins
|
||
|
||
This is in the best case done with composer.
|
||
|
||
### How to bring Plugins into the composer workflow
|
||
|