docs/de/developer/docker.rst

   1 Lasse wallabag in docker-compose laufen
   2 =======================================
   3
   4 Um deine eigene Entwicklungsinstanz von wallabag laufen zu lassen,
   5 möchtest du vielleicht die vorkonfigurierten docker compose Dateien
   6 nutzen.
   7
   8 Voraussetzungen
   9 ---------------
  10
  11 Stelle sicher `Docker
  12 <https://docs.docker.com/installation/ubuntulinux/>`__ und `Docker
  13 Compose <https://docs.docker.com/compose/install/>`__ auf deinem
  14 System verfügbar und aktuell zu haben.
  15
  16 Wechsel des DBMS
  17 ----------------
  18
  19 Standardmäßig startet wallabag mit einer SQLite Datenbank.
  20 Da wallabag Unterstützung für Postgresql und MySQL bietet, gibt es
  21 auch docker Container für diese.
  22
  23 In der ``docker-compose.yml`` kommentierst du für das gewählte DBMS
  24 aus:
  25
  26 - die Container Definition (``postgres`` oder ``mariadb`` root
  27   Level Block)
  28 - den Container Link in dem ``php`` Container
  29 - die Container Umgebungsdatei in dem ``php`` Container
  30
  31 Um mit Symfony Kommandos auf deinem Host auszuführen (wie z.B.
  32 ``wallabag:install``), sollst du außerdem:
  33
  34 - die richtige Umgebungsdatei auf deiner Kommandozeile einlesen,
  35   sodass Variablen wie ``SYMFONY__ENV__DATABASE_HOST`` existieren
  36 - eine Zeile ``127.0.0.1 rdbms`` in deiner ``hosts`` Datei auf dem
  37   System erstellen
  38
  39 wallabag laufen lassen
  40 ----------------------
  41
  42 #. Forke und klone das Projekt
  43 #. Bearbeite ``app/config/parameters.yml`` um ``database_*``
  44    Eigenschaften mit den kommentierten zu ersetzen (mit Werten
  45    mit ``env.`` Präfix)
  46 #. ``composer install`` die Projektabhängigkeiten
  47 #. ``php app/console wallabag:install``, um das Schema zu erstellen
  48 #. ``docker-compose up`` um die Container laufen zu lassen
  49 #. Schließlich öffne http://localhost:8080/, um dein frisch
  50    installiertes wallabag zu finden.
  51
  52 In den verschiedenen Schritten wirst du vielleicht in verschiendene
  53 Probleme laufen wie UNIX Berechtigungsprobleme, falschen Pfaden im
  54 generierten Cache, etc.…
  55 Operationen wie das Löschen der Cachedateien oder das Ändern der
  56 Dateibesitzer können öfter gebraucht werden, darum habe keine Angst
  57 sie anzupassen.