Bereiche
Bereich Docker
Allgemein
Parameter
Anwendungen
- Mattermost
- Unifi-Video
Dies ist eine alte Version des Dokuments!
Image | |
---|---|
Docker Hub | linuxserver/dokuwiki |
GitHub | linuxserver/docker-dokuwiki |
Architektur | x86-64, armhf, arm64 |
Software | |
Projekt | DokuWiki |
GitHub | splitbrain/dokuwiki |
Der Container wird wie folgt mit docker run
eingerichtet und gestartet:
docker run -d \ --name=dokuwiki \ -e PUID=2000 \ -e PGID=2000 \ -e TZ=Europe/London \ -p 80:80 \ -p 443:443 \ -v /path/to/appdata/config:/config \ --restart unless-stopped \ linuxserver/dokuwiki:20XX-XX-XXX-lsXX
Im Hinblick auf mögliche Probleme bei einem unbeabsichtigten Update des Images sollte die Version des Images durch das Anfügen des Versions-Tags (Format 20XX-XX-XXX-lsXX
) gepinnt werden.
Dies sind die wichtigsten Parameter. Sofern sie mit einem „*“ markiert sind, sollte eine Anpassung erfolgen:
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 Format Gebiet/Ort. |
-e APP_URL | Optional: Hier kann der Pfad vorgegeben werden, unter dem das Wiki auf dem Server zu erreichen ist (z.B. http://example.com/wiki statt http://example.com ). |
-p | Port-Zuweisungen für den Zugriff per http (Default 80:80) bzw. https (Default 443:443) |
-v * | Volumes, siehe Unterabschnitt Volumes |
In der Konfiguration werden Volumes in der Regel im folgenden Format angegeben:
<Pfad auf dem Host>:<Pfad im Container>[:<Optionen>]
Die Volumes haben die folgenden Funktionen (maßgeblich ist der Pfad im Container):
Der Container wird wie folgt in der docker-compose.yml
konfiguriert:
version: "2.1" services: dokuwiki: image: linuxserver/dokuwiki:20XX-XX-XXX-lsXX container_name: dokuwiki environment: - PUID=2000 - PGID=2000 - TZ=Europe/Berlin volumes: - /path/to/config:/config ports: - 80:80 - 443:443 restart: unless-stopped
Im Hinblick auf mögliche Probleme bei einem unbeabsichtigten Update des Images sollte die Version des Images durch das Anfügen des Versions-Tags (Format 20XX-XX-XXX-lsXX
) gepinnt werden.
Der Container kann mit den folgenden Eintragungen in der docker-compose.yml
in Træfik integriert werden:
... dokuwiki: image: linuxserver/dokuwiki:20XX-XX-XXX-lsXX container_name: dokuwiki environment: - PUID=2000 - PGID=2000 - TZ=Europe/Berlin volumes: - /path/to/config:/config restart: unless-stopped labels: - traefik.http.routers.dokuwiki.rule=Host(`wiki.example.com`) - "traefik.http.routers.dokuwiki.tls.certResolver=default" - "traefik.http.routers.dokuwiki.tls=true"
Im Hinblick auf mögliche Probleme bei einem unbeabsichtigten Update des Images sollte die Version des Images durch das Anfügen des Versions-Tags (Format 20XX-XX-XXX-lsXX
) gepinnt werden.
Für die Ersteinrichtung des DokuWikis ist in der Installation das Script /install.php
aufzurufen (Aufruf von http[s]://$IP[:$PORT]/install.php
bzw. http[s]://$DOMAIN[:$PORT]/install.php
)
Das Image wird – wie bei linuxserver üblich – häufig aktualisert. Hierbei scheint die Aktualisierung der Basiskomponenten (Linux-Komponenten, Webserver nginx einschließlich PHP) im Vordergrund zu stehen. Änderungen an der Struktur des Images scheinen eher selten zu sein. Beim Bau des Images wird die aktuelle Stable-Version von DokuWiki im Image installiert. Im Changelog erscheinen jedoch nur die vorgenommenen Änderungen an der Struktur des Images.
Sofern sich die DokuWiki-Version im Docker-Image ändert, kann es nach dem Update des Images zu einem nicht mehr lauffähigen System kommen. Die neue Version von DokuWiki kann u.U. Änderungen der Datenstrukturen vorsehen, die eine Anpassung (Migration) der Bestandsdaten aus der Vorversion erforderlich machen. Bei einer „normalen“ Installation ohne den Einsatz von Docker erfolgt diese Migration anlässlich des Upgrades von DokuWiki. Erfolgt das Update von DokuWiki jedoch durch den Austausch der DokuWiki-Software im Rahmen des Updates des Images, dann laufen die notwendigen Migrationsroutinen nicht. In der Folgen passen die Daten dann nicht zur neuen DokuWiki-Version.
Da im Changelog des Images nicht auf eine ggf. neue DokuWiki-Version hingewiesen wird, ist es notwendig, dass bei jeder neuen Imageversion vor dem Einspielen geprüft wird, ob das Image eine neue DokuWiki-Version enthält.
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 DokuWiki-Releases ggf. mit einem Buchstaben für die Bezeichnung des Hotfixes an. Der mit „ls“ beginnende Teil ist die interne Versionsnummer von Linuxservers.io.
Um die Versionsbezeichnung des aktuellen Images zu ermitteln, muss man die Tags-Registerkarte des Repositories auswerten. Die Bezeichnung der aktuellen Version sollte sich regelmäßig im zweiten Eintrag befinden.
Solange sich der erste, DokuWiki-bezogene Teil der Versionsbezeichnung nicht ändert, besteht kein Risiko einer zu den Bestandsdaten inkompatiblen Imageversion.
Beispiel | |
---|---|
Bezeichnung | Anmerkung |
2018-04-22c-ls40 | Image ls40 mit DokuWiki-Release 2018-04-22c “Greebo” - Erstinstallation |
2018-04-22c-ls41 | Image ls41 mit DokuWiki-Release 2018-04-22c “Greebo” Es sind keine Probleme beim Update zu erwarten. |
2020-07-29-ls42 | Image ls42 mit dem neuen DokuWiki-Release 2020-07-29 “Hogfather” Hier kam es aufgrund des neuen DokuWiki-Releases zu massiven Probleme mit den Bestandsdaten. |
2020-07-29-ls43 | Image ls43 mit dem DokuWiki-Release 2020-07-29 “Hogfather” Sofern bereits auf Version ls43 geupdatet wurde, sind keine Probleme beim Update zu erwarten. |
Sofern sich die Bezeichnung des DokuWiki-Releases ändert, sollte anhand des Changelogs geprüft werden, welche Änderungen vorliegen. Zumindest wenn sich das Majorsrelease ändert (Änderung des Datums „2018-04-22“ → „2020-07-29“ und der Namens „Greebo“ → „Hogfather“) ist Vorsicht geboten.
Sofern der verdacht besteht, dass die neue DokuWiki-version nicht mit den Bestandsdaten kompatibel sein könnte, dann kann wie folgt vorgegangen werden: