[github/wallabag/wallabag.git] / docs / fr / developer / docker.rst

Exécuter wallabag avec docker-compose
=====================================

Pour faire tourner votre propre instance de développement de wallabag, vous pouvez
utiliser les fichiers docker pré-configurés.

Pré-requis
----------

Soyez sur d'avoir `Docker
<https://docs.docker.com/installation/ubuntulinux/>`__ et `Docker
Compose <https://docs.docker.com/compose/install/>`__ installés et à jour sur votre
système.

Changer de SGBD
---------------

Par défaut, wallabag fonctionne avec une base de données SQLite.
Depuis que wallabag supporte Postgresql et MySQL, les conteneurs Docker sont
aussi disponibles pour ces SGBD.

Dans ``docker-compose.yml``, en fonction de votre SGBD, décommentez :

- la définition du conteneur (le block racine ``postgres`` ou ``mariadb``)
- le conteneur ``links`` dans le conteneur ``php``
- le conteneur ``env_file`` dans le conteneur ``php``

Pour que les commandes Symfony (par exemple ``wallabag:install``) continuent de
fonctionner sur votre système, vous devez aussi :

- charger le bon fichier d'environnement dans votre ligne de commandes (``source``),
pour que les variables comme ``SYMFONY__ENV__DATABASE_HOST`` existent.
- ajouter une ligne ``127.0.0.1 rdbms`` dans votre fichier ``hosts``

Exécuter wallabag
-----------------

#. Forker et cloner le projet
#. Editer ``app/config/parameters.yml`` pour remplacer les propriétés ``database_*``
    par les lignes commentées (celles avec des valeurs préfixées par ``env.``)
#. ``composer install`` pour installer les dépendances
#. ``php bin/console wallabag:install`` pour créer le schéma de la BDD
#. ``docker-compose up`` pour démarrer les conteneurs
#. Enfin, se rendre sur http://localhost:8080/ pour accéder à une installation
    tout propre de wallabag.

Il est possible de rencontrer des problèmes de droits UNIX, de mauvais chemins
dans les fichiers de cache, etc…
Les opérations comme vider le cache ou restaurer les permissions des fichiers
peuvent être fréquemment nécessaires, n'ayez crainte !
Commit	Line	Data
	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 !