docs/fr/developer/docker.rst

   1 Exécuter wallabag avec docker-compose
   2 =====================================
   3
   4 Pour faire tourner votre propre instance de développement de wallabag, vous pouvez
   5 utiliser les fichiers docker pré-configurés.
   6
   7 Pré-requis
   8 ----------
   9
  10 Soyez sur d'avoir `Docker
  11 <https://docs.docker.com/installation/ubuntulinux/>`__ et `Docker
  12 Compose <https://docs.docker.com/compose/install/>`__ installés et à jour sur votre
  13 système.
  14
  15 Changer de SGBD
  16 ---------------
  17
  18 Par défaut, wallabag fonctionne avec une base de données SQLite.
  19 Depuis que wallabag supporte Postgresql et MySQL, les conteneurs Docker sont
  20 aussi disponibles pour ces SGBD.
  21
  22 Dans ``docker-compose.yml``, en fonction de votre SGBD, décommentez :
  23
  24 - la définition du conteneur (le block racine ``postgres`` ou ``mariadb``)
  25 - le conteneur ``links`` dans le conteneur ``php``
  26 - le conteneur ``env_file`` dans le conteneur ``php``
  27
  28 Pour que les commandes Symfony (par exemple ``wallabag:install``) continuent de
  29 fonctionner sur votre système, vous devez aussi :
  30
  31 - charger le bon fichier d'environnement dans votre ligne de commandes (``source``),
  32 pour que les variables comme ``SYMFONY__ENV__DATABASE_HOST`` existent.
  33 - ajouter une ligne ``127.0.0.1 rdbms`` dans votre fichier ``hosts``
  34
  35 Exécuter wallabag
  36 -----------------
  37
  38 #. Forker et cloner le projet
  39 #. Editer ``app/config/parameters.yml`` pour remplacer les propriétés ``database_*``
  40     par les lignes commentées (celles avec des valeurs préfixées par ``env.``)
  41 #. ``composer install`` pour installer les dépendances
  42 #. ``php bin/console wallabag:install`` pour créer le schéma de la BDD
  43 #. ``docker-compose up`` pour démarrer les conteneurs
  44 #. Enfin, se rendre sur http://localhost:8080/ pour accéder à une installation
  45     tout propre de wallabag.
  46
  47 Il est possible de rencontrer des problèmes de droits UNIX, de mauvais chemins
  48 dans les fichiers de cache, etc…
  49 Les opérations comme vider le cache ou restaurer les permissions des fichiers
  50 peuvent être fréquemment nécessaires, n'ayez crainte !