From 9d8975f6b6e1998cff86a0198b247a5c1708bc59 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Fri, 17 Feb 2017 13:12:09 +0100 Subject: Moved :it: documentation into it folder --- docs/it/developer/asynchronous.rst | 162 +++++++++++++++++++++++++++++++++++++ 1 file changed, 162 insertions(+) create mode 100644 docs/it/developer/asynchronous.rst (limited to 'docs/it/developer/asynchronous.rst') diff --git a/docs/it/developer/asynchronous.rst b/docs/it/developer/asynchronous.rst new file mode 100644 index 00000000..d753bd23 --- /dev/null +++ b/docs/it/developer/asynchronous.rst @@ -0,0 +1,162 @@ +Compiti Asincroni +================= + +Per avviare compiti asincroni (utile ad esempio per grandi importazioni), Possiamo usare RabbitMQ o Redis. + +Installare RabbitMQ per compiti asincroni +----------------------------------------- + +Requisiti +^^^^^^^^^ + +Dovete avere RabbitMQ installato sul vostro server. + +Installazione +^^^^^^^^^^^^^ + +.. code:: bash + + wget https://www.rabbitmq.com/rabbitmq-signing-key-public.asc + apt-key add rabbitmq-signing-key-public.asc + apt-get update + apt-get install rabbitmq-server + +Configurazione ed avvio +^^^^^^^^^^^^^^^^^^^^^^^ + +.. code:: bash + + rabbitmq-plugins enable rabbitmq_management # (useful to have a web interface, available at http://localhost:15672/ (guest/guest) + rabbitmq-server -detached + +Fermare RabbitMQ +^^^^^^^^^^^^^^^^ + +.. code:: bash + + rabbitmqctl stop + + +Configurare RabbitMQ in wallabag +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Modificate il vostro file ``app/config/parameters.yml`` per modificare la configurazione di RabbitMQ. Quella di default dovrebbe andare bene: + +.. code:: yaml + + rabbitmq_host: localhost + rabbitmq_port: 5672 + rabbitmq_user: guest + rabbitmq_password: guest + rabbitmq_prefetch_count: 10 # read http://www.rabbitmq.com/consumer-prefetch.html + +Abilitare RabbitMQ su wallabag +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Su Strumenti, nella sezione **Importa**, abilitate RabbitMQ (con il valore 1). + +Avviare RabbitMQ consumer +^^^^^^^^^^^^^^^^^^^^^^^^^ + +Dipendendo da quale servizio vogliate importare, dovrete abilitare uno (o più se volete supportare molti) o più cronjob: + +.. code:: bash + + # per importare da Pocket + bin/console rabbitmq:consumer -e=prod import_pocket -w + + # per importare da Readability + bin/console rabbitmq:consumer -e=prod import_readability -w + + # per importare da Instapaper + bin/console rabbitmq:consumer -e=prod import_instapaper -w + + # per importare da wallabag v1 + bin/console rabbitmq:consumer -e=prod import_wallabag_v1 -w + + # per importare da wallabag v2 + bin/console rabbitmq:consumer -e=prod import_wallabag_v2 -w + + # per importare da Firefox + bin/console rabbitmq:consumer -e=prod import_firefox -w + + # per importare da Chrome + bin/console rabbitmq:consumer -e=prod import_chrome -w + +Installare Redis per compiti asincroni +-------------------------------------- + +Per avviare compiti asincroni (utile ad esempio per grandi importazioni), Possiamo usare Redis. + +Requisiti +^^^^^^^^^ + +Dovete avere Redis installato sul vostro server. + +Installazione +^^^^^^^^^^^^^ + +.. code:: bash + + apt-get install redis-server + + +Avvio +^^^^^ + +Il server dovrebbe già essere attivo dopo l'installazione, altrimenti potete avviarlo usando: + +.. code:: bash + + redis-server + + +Configurare Redis su wallabag +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Modificate il vostro file ``app/config/parameters.yml`` per modificare la configurazione di Redis. Quella di default dovrebbe andare bene: + +.. code:: yaml + + redis_host: localhost + redis_port: 6379 + +Abilitare Redis su wallabag +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Su Strumenti, nella sezione **Importa**, abilitate Redis (con il valore 1). + +Avviare Redis consumer +^^^^^^^^^^^^^^^^^^^^^^ + +Dipendendo da quale servizio vogliate importare, dovrete abilitare uno (o più se volete supportare molti) o più cronjob: + +.. code:: bash + + # per importare da Pocket + bin/console wallabag:import:redis-worker -e=prod pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log + + # per importare da Readability + bin/console wallabag:import:redis-worker -e=prod readability -vv >> /path/to/wallabag/var/logs/redis-readability.log + + # per importare da Instapaper + bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log + + # per importare da wallabag v1 + bin/console wallabag:import:redis-worker -e=prod wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log + + # per importare da wallabag v2 + bin/console wallabag:import:redis-worker -e=prod wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log + + # per importare da Firefox + bin/console wallabag:import:redis-worker -e=prod firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log + + # per importare da Chrome + bin/console wallabag:import:redis-worker -e=prod chrome -vv >> /path/to/wallabag/var/logs/redis-chrome.log + +Se volete avviare l'importazione solamente per alcuni messaggi e non tutti, potete specificare questo numero (qui 12) e il programma si fermerà dopo il dodicesimo messaggio: + +.. code:: bash + + bin/console wallabag:import:redis-worker -e=prod pocket -vv --maxIterations=12 + -- cgit v1.2.3