Hier werden die Unterschiede zwischen zwei Versionen gezeigt.
Beide Seiten, vorherige Überarbeitung Vorherige Überarbeitung Nächste Überarbeitung | Vorherige Überarbeitung | ||
thoschwiki:docker:apps:dokuwiki [02.08.2020 19:27] thosch Tabellenzeile mit Architektur ergänzt |
thoschwiki:docker:apps:dokuwiki [08.03.2022 10:03] (aktuell) thosch [Integration in Træfik] Version-Pinning angepasst. |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | ====== DokuWiki ====== | + | ====== DokuWiki |
- | + | ||
+ | {{page> | ||
^ Image ^^ | ^ Image ^^ | ||
Zeile 9: | Zeile 8: | ||
^ Architektur | x86-64, armhf, arm64 | | ^ Architektur | x86-64, armhf, arm64 | | ||
^ **Software** ^^ | ^ **Software** ^^ | ||
- | ^ Projekt | [[github> | + | ^ Projekt |
+ | ^ GitHub | ||
===== docker run ===== | ===== docker run ===== | ||
Zeile 25: | Zeile 25: | ||
-v / | -v / | ||
--restart unless-stopped \ | --restart unless-stopped \ | ||
- | linuxserver/ | + | linuxserver/ |
</ | </ | ||
+ | Im Hinblick auf [[thoschwiki: | ||
+ | |||
+ | ==== Parameter ==== | ||
+ | |||
+ | Dies sind die wichtigsten Parameter. Sofern sie mit einem " | ||
+ | |||
+ | ^ Parameter ^ Funktion | | ||
+ | | -e PUID= * | Vorgabe des //Users// , mit dem die Daten auf dem Docker-Host in die gemounteten Verzeichnisse geschrieben werden. | | ||
+ | | -e PGID= * | Vorgabe des //Gruppe// , mit der die Daten auf dem Docker-Host in die gemounteten Verzeichnisse geschrieben werden. | | ||
+ | | -e TZ= * | Vorgabe der lokalen Zeitzone im [[wpde> | ||
+ | | -p | Port-Zuweisungen für den Zugriff per '' | ||
+ | | -v * | Volumes, siehe [[# | ||
+ | |||
+ | ==== Volumes ==== | ||
+ | |||
+ | In der Konfiguration werden Volumes in der Regel im folgenden Format angegeben: | ||
+ | |||
+ | < | ||
+ | |||
+ | Die Volumes haben die folgenden Funktionen (maßgeblich ist der Pfad im Container): | ||
+ | |||
+ | ^ Pfad im Container ^ Funktion ^ | ||
+ | | /config | In bzw. unterhalb dieses Ordners befinden sich die Konfigurationsdateien des // | ||
+ | |||
+ | Sofern sitespezifische Interwiki-Link-Icons benutzen werden sollen, ist eine [[thoschwiki: | ||
===== docker-compose | ===== docker-compose | ||
Der Container wird wie folgt in der '' | Der Container wird wie folgt in der '' | ||
- | <code> | + | <file - docker-compose-yml> |
version: " | version: " | ||
services: | services: | ||
dokuwiki: | dokuwiki: | ||
- | image: linuxserver/ | + | image: linuxserver/ |
container_name: | container_name: | ||
environment: | environment: | ||
Zeile 48: | Zeile 73: | ||
- 443:443 | - 443:443 | ||
restart: unless-stopped | restart: unless-stopped | ||
- | </code> | + | </file> |
+ | |||
+ | Im Hinblick auf [[thoschwiki: | ||
+ | |||
+ | Sofern sitespezifische Interwiki-Link-Icons benutzen werden sollen, ist eine [[thoschwiki: | ||
- | ==== Integration in Træfik ==== | + | ===== Integration in Træfik |
Der Container kann mit den folgenden Eintragungen in der '' | Der Container kann mit den folgenden Eintragungen in der '' | ||
Zeile 59: | Zeile 88: | ||
dokuwiki: | dokuwiki: | ||
- | image: linuxserver/ | + | image: linuxserver/ |
container_name: | container_name: | ||
environment: | environment: | ||
Zeile 73: | Zeile 102: | ||
- " | - " | ||
</ | </ | ||
+ | |||
+ | Im Hinblick auf [[thoschwiki: | ||
+ | |||
+ | Sofern sitespezifische Interwiki-Link-Icons benutzen werden sollen, ist eine [[thoschwiki: | ||
+ | |||
+ | |||
+ | |||
+ | ===== Konfiguration der Anwendung ===== | ||
+ | |||
+ | Für die Ersteinrichtung des // | ||
+ | |||
+ | ===== Persistieren von sitespezifischen Interwiki-Link-Icons ===== | ||
+ | |||
+ | Das DokuWiki unterstütz das Konzept der [[doku> | ||
+ | |||
+ | Diese Grafikdateien sind im Verzeichnis '' | ||
+ | |||
+ | Um dieses Problem zu lösen, habe ich ein zusätzliches Volume eingeführt, | ||
+ | |||
+ | ==== Vorbereitende Arbeiten ==== | ||
+ | |||
+ | Das Mounten des Volumes nach ''/ | ||
+ | |||
+ | Das Volume ist daher mit dem systemseitigen Grafiken initial zu " | ||
+ | |||
+ | - einen zusätzlichen, | ||
+ | - per '' | ||
+ | - den Hilfs-Container beendet und zerstört | ||
+ | |||
+ | <code bash> | ||
+ | #!/bin/sh | ||
+ | # | ||
+ | # Helper script to copy the icons from an complete container into | ||
+ | # the volume which will contain and persist the icons | ||
+ | |||
+ | echo "Start Container..." | ||
+ | |||
+ | # Minimal container w/o port etc. and mounted ' | ||
+ | docker run \ | ||
+ | --name=dokuwikihelper \ | ||
+ | -d \ | ||
+ | --rm \ | ||
+ | -e PUID=2000 \ | ||
+ | -e PGID=2000 \ | ||
+ | -e TZ=Europe/ | ||
+ | -v / | ||
+ | linuxserver/ | ||
+ | |||
+ | |||
+ | echo | ||
+ | echo " | ||
+ | # Copy icons to mounted volume | ||
+ | # ('cp -a / | ||
+ | docker exec -it dokuwikihelper cp -a / | ||
+ | # Change owner to ' | ||
+ | # to prevent that ' | ||
+ | docker exec -it dokuwikihelper chown abc:abc -R /images | ||
+ | |||
+ | echo | ||
+ | echo "ls -axl / | ||
+ | ls -axl / | ||
+ | |||
+ | echo | ||
+ | echo " | ||
+ | docker stop dokuwikihelper | ||
+ | |||
+ | echo "Die eigenen Icons sind noch nach / | ||
+ | echo "bzw. / | ||
+ | echo "ggf. die Dateirechte anzupassen." | ||
+ | |||
+ | </ | ||
+ | |||
+ | |||
+ | ==== Änderungen der Volume-Definition ==== | ||
+ | |||
+ | Es ergeben sich damit die folgenden Volumes: | ||
+ | |||
+ | ^ Pfad im Container ^ Funktion ^ | ||
+ | | /config | In bzw. unterhalb dieses Ordners befinden sich die Konfigurationsdateien des // | ||
+ | | / | ||
+ | |||
+ | Die Definition der Volumes in der '' | ||
+ | |||
+ | < | ||
+ | volumes: | ||
+ | - / | ||
+ | - / | ||
+ | </ | ||
+ | |||
+ | ===== Update des Images ===== | ||
+ | |||
+ | Das Image wird -- wie bei [[dockerhub> | ||
+ | |||
+ | Sofern sich die // | ||
+ | |||
+ | <note tip> | ||
+ | Die beschriebenen Problem mit der // | ||
+ | |||
+ | Bei Verwendung des Labels werden nur Images geladen, die die vorgebene // | ||
+ | |||
+ | Ändert sich die // | ||
+ | </ | ||
+ | ==== Identifikation kritischer Updates ==== | ||
+ | |||
+ | Da im Changelog des Images nicht auf eine ggf. neue // | ||
+ | |||
+ | Aufgrund der Struktur der Versionsbezeichnung ist dies leicht möglich. Die Versionsbezeichnung baut sich wie folgt auf: | ||
+ | |||
+ | JJJJ-MM-TT[x]-lsXX | ||
+ | |||
+ | Die ersten acht (bis neun) durch zwei Bindestriche strukturierten Zeichen geben das Datum des // | ||
+ | |||
+ | Um die Versionsbezeichnung des aktuellen Images zu ermitteln, muss man die [[dockerhub> | ||
+ | |||
+ | Solange sich der erste, // | ||
+ | |||
+ | ^ Beispiel ^^ | ||
+ | ^ Bezeichnung ^ Anmerkung ^ | ||
+ | | 2018-04-22c-ls40 | Image //ls40// mit // | ||
+ | | 2018-04-22c-ls41 | Image //ls41// mit // | ||
+ | | 2020-07-29-ls42 | Image //ls42// mit dem **neuen** // | ||
+ | | 2020-07-29-ls43 | Image //ls43// mit dem // | ||
+ | |||
+ | Sofern sich die Bezeichnung des // | ||
+ | |||
+ | ==== Einspielen kritischer Updates ==== | ||
+ | |||
+ | |||
+ | Sofern der Verdacht besteht, dass die neue // | ||
+ | |||
+ | - Die neuen Version des Images zunächst in eine //getrennte Testinstanz einspielen// | ||
+ | - | ||
+ | - | ||
+ | - | ||
+ |