aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/de/developer
diff options
context:
space:
mode:
authorNicolas Lœuillet <nicolas@loeuillet.org>2016-11-18 09:28:20 +0100
committerGitHub <noreply@github.com>2016-11-18 09:28:20 +0100
commit19d401b15c1151bfa6c2364f31cc1eb87e7c99ef (patch)
tree9c47399f9b1a9ad2228ec365a1fd5e20edc7771f /docs/de/developer
parent9e0a49e6acf60c3dbf3c479cb36d404239dfda89 (diff)
parent50540682ffcaa6acf16f3b17cede3da9694c494f (diff)
downloadwallabag-19d401b15c1151bfa6c2364f31cc1eb87e7c99ef.tar.gz
wallabag-19d401b15c1151bfa6c2364f31cc1eb87e7c99ef.tar.zst
wallabag-19d401b15c1151bfa6c2364f31cc1eb87e7c99ef.zip
Merge pull request #2550 from wallabag/reorder-documentation
Reordered documentation
Diffstat (limited to 'docs/de/developer')
-rw-r--r--docs/de/developer/api.rst2
-rw-r--r--docs/de/developer/asynchronous.rst158
-rw-r--r--docs/de/developer/rabbitmq.rst81
-rw-r--r--docs/de/developer/redis.rst75
4 files changed, 159 insertions, 157 deletions
diff --git a/docs/de/developer/api.rst b/docs/de/developer/api.rst
index bb21154d..9d230e31 100644
--- a/docs/de/developer/api.rst
+++ b/docs/de/developer/api.rst
@@ -1,4 +1,4 @@
1API DoKumentation 1API Dokumentation
2================= 2=================
3 3
4Dank dieser Dokumentation werden wir sehen, wie wir mit der wallabag API interagieren. 4Dank dieser Dokumentation werden wir sehen, wie wir mit der wallabag API interagieren.
diff --git a/docs/de/developer/asynchronous.rst b/docs/de/developer/asynchronous.rst
new file mode 100644
index 00000000..1d241a72
--- /dev/null
+++ b/docs/de/developer/asynchronous.rst
@@ -0,0 +1,158 @@
1Asynchrone Aufgaben
2===================
3
4Um große asynchrone Aufgaben zu starten (etwa für große Importe), können wir RabbitMQ oder Redis nutzen.
5
6Installation von RabbitMQ für asynchrone Aufgaben
7-------------------------------------------------
8
9Voraussetzungen
10^^^^^^^^^^^^^^^
11
12Du musst RabbitMQ auf deinem Server installiert haben.
13
14Installation
15^^^^^^^^^^^^
16
17.. code:: bash
18
19 wget https://www.rabbitmq.com/rabbitmq-signing-key-public.asc
20 apt-key add rabbitmq-signing-key-public.asc
21 apt-get update
22 apt-get install rabbitmq-server
23
24Konfiguration und Start
25^^^^^^^^^^^^^^^^^^^^^^^
26
27.. code:: bash
28
29 rabbitmq-plugins enable rabbitmq_management # (useful to have a web interface, available at http://localhost:15672/ (guest/guest)
30 rabbitmq-server -detached
31
32RabbitMQ stoppen
33^^^^^^^^^^^^^^^^
34
35.. code:: bash
36
37 rabbitmqctl stop
38
39RabbitMQ für wallabag konfigurieren
40^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
41
42Bearbeite deine ``app/config/parameters.yml``-Datei, um die RabbitMQ-Parameter zu ändern. Die Standardwerte sollten in Ordnung sein:
43
44.. code:: yaml
45
46 rabbitmq_host: localhost
47 rabbitmq_port: 5672
48 rabbitmq_user: guest
49 rabbitmq_password: guest
50
51RabbitMQ in wallabag aktivieren
52^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
53
54In den internen Einstellungen, aktiviere RabbitMQ im Import-Abschnitt mit dem Wert 1.
55
56Starte den RabbitMQ-Consumer
57^^^^^^^^^^^^^^^^^^^^^^^^^^^^
58
59Abhängig davon, über welchen Service du importieren möchtest, musst du den entsprechenden (oder mehrere) Cronjob aktivieren:
60
61.. code:: bash
62
63 # für den Pocket-Import
64 bin/console rabbitmq:consumer -e=prod import_pocket -w
65
66 # für den Readability-Import
67 bin/console rabbitmq:consumer -e=prod import_readability -w
68
69 # für den Instapaper-Import
70 bin/console rabbitmq:consumer -e=prod import_instapaper -w
71
72 # für den wallabag v1-Import
73 bin/console rabbitmq:consumer -e=prod import_wallabag_v1 -w
74
75 # für den wallabag v2-Import
76 bin/console rabbitmq:consumer -e=prod import_wallabag_v2 -w
77
78 # für den Firefox-Import
79 bin/console rabbitmq:consumer -e=prod import_firefox -w
80
81 # für den Chrome-Import
82 bin/console rabbitmq:consumer -e=prod import_chrome -w
83
84Redis für asynchrone Aufgaben installieren
85------------------------------------------
86
87Um große asynchrone Aufgaben zu starten (etwa für große Importe), können wir auch Redis nutzen.
88
89Voraussetzungen
90^^^^^^^^^^^^^^^
91
92Du musst Redis auf deinem Server installiert haben.
93
94Installation
95^^^^^^^^^^^^
96
97.. code:: bash
98
99 apt-get install redis-server
100
101Start
102^^^^^
103
104Der Server kann bereits nach der Installation laufen, falls nicht, kannst du ihn wie folgt starten:
105
106.. code:: bash
107
108 redis-server
109
110
111Redis für wallabag konfigurieren
112^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
113
114Bearbeite deine ``app/config/parameters.yml``-Datei, um die Redis-Parameter zu ändern. Die Standardwerte sollten in Ordnung sein:
115
116.. code:: yaml
117
118 redis_host: localhost
119 redis_port: 6379
120
121Redis in wallabag aktivieren
122^^^^^^^^^^^^^^^^^^^^^^^^^^^^
123
124In den internen Einstellungen, aktiviere Redis im Import-Abschnitt mit dem Wert 1.
125
126Starten des Redis-Consumer
127^^^^^^^^^^^^^^^^^^^^^^^^^^
128
129Abhängig davon, über welchen Service du importieren möchtest, musst du den entsprechenden (oder mehrere) Cronjob aktivieren:
130
131.. code:: bash
132
133 # für den Pocket-Import
134 bin/console wallabag:import:redis-worker -e=prod pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log
135
136 # für den Readability-Import
137 bin/console wallabag:import:redis-worker -e=prod readability -vv >> /path/to/wallabag/var/logs/redis-readability.log
138
139 # für den Instapaper-Import
140 bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log
141
142 # für den wallabag v1-Import
143 bin/console wallabag:import:redis-worker -e=prod wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log
144
145 # für den wallabag v2-Import
146 bin/console wallabag:import:redis-worker -e=prod wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log
147
148 # für den Firefox-Import
149 bin/console wallabag:import:redis-worker -e=prod firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log
150
151 # für den Chrome-Import
152 bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-chrome.log
153
154Wenn du den Import nur für einige Artikel nutzen willst, kannst du die Nummer festlegen (hier: 12) und der Consumer wird nach dem zwölften Artikel aufhören:
155
156.. code:: bash
157
158 bin/console wallabag:import:redis-worker -e=prod pocket -vv --maxIterations=12 \ No newline at end of file
diff --git a/docs/de/developer/rabbitmq.rst b/docs/de/developer/rabbitmq.rst
deleted file mode 100644
index 143b64a1..00000000
--- a/docs/de/developer/rabbitmq.rst
+++ /dev/null
@@ -1,81 +0,0 @@
1Installiere RabbitMQ für asynchrone Aufgaben
2============================================
3
4Um asynchrone Aufgaben zu starten (nützlich z.B. für große Imports), können wir RabbitMQ nutzen.
5
6Voraussetzungen
7---------------
8
9Du musst RabbitMQ auf deinem Server installiert haben.
10
11Installation
12~~~~~~~~~~~~
13
14.. code:: bash
15
16 wget https://www.rabbitmq.com/rabbitmq-signing-key-public.asc
17 apt-key add rabbitmq-signing-key-public.asc
18 apt-get update
19 apt-get install rabbitmq-server
20
21Konfiguration und Starten
22~~~~~~~~~~~~~~~~~~~~~~~~~
23
24.. code:: bash
25
26 rabbitmq-plugins enable rabbitmq_management # (useful to have a web interface, available at http://localhost:15672/ (guest/guest)
27 rabbitmq-server -detached
28
29RabbitMQ stoppen
30~~~~~~~~~~~~~~~
31
32.. code:: bash
33
34 rabbitmqctl stop
35
36
37Konfigure RabbitMQ in wallabag
38------------------------------
39
40Bearbeite die Datei ``app/config/parameters.yml``, um die RabbitMQ Konfiguration einzurichten. Die Standardkonfiguration sollte ok sein:
41
42.. code:: yaml
43
44 rabbitmq_host: localhost
45 rabbitmq_port: 5672
46 rabbitmq_user: guest
47 rabbitmq_password: guest
48
49Enable RabbitMQ in wallabag
50---------------------------
51
52In internal settings, in the **Import** section, enable RabbitMQ (with the value 1).
53
54Starte den RabbitMQ Consumer
55----------------------------
56
57Abhängig von welchem Service du importieren möchtest, solltest du einen Cron Job aktivieren (oder mehrere, wenn du viele unterstützen willst):
58
59.. code:: bash
60
61 # for Pocket import
62 bin/console rabbitmq:consumer -e=prod import_pocket -w
63
64 # for Readability import
65 bin/console rabbitmq:consumer -e=prod import_readability -w
66
67 # for Instapaper import
68 bin/console rabbitmq:consumer -e=prod import_instapaper -w
69
70 # for wallabag v1 import
71 bin/console rabbitmq:consumer -e=prod import_wallabag_v1 -w
72
73 # for wallabag v2 import
74 bin/console rabbitmq:consumer -e=prod import_wallabag_v2 -w
75
76 # for Firefox import
77 bin/console rabbitmq:consumer -e=prod import_firefox -w
78
79 # for Chrome import
80 bin/console rabbitmq:consumer -e=prod import_chrome -w
81
diff --git a/docs/de/developer/redis.rst b/docs/de/developer/redis.rst
deleted file mode 100644
index 2505bf24..00000000
--- a/docs/de/developer/redis.rst
+++ /dev/null
@@ -1,75 +0,0 @@
1Installiere Redis für asynchrone Aufgaben
2=========================================
3
4Um asynchrone Aufgaben zu starten (nützlich z.B. für große Imports), können wir Redis nutzen.
5
6Voraussetzungen
7---------------
8
9Du musst Redis auf deinem Server installiert haben.
10
11Installation
12~~~~~~~~~~~~
13
14.. code:: bash
15
16 apt-get install redis-server
17
18Starten
19~~~~~~
20
21Der Redis Service läuft eventuell schon direkt nach der Installation. Falls nicht kannst du ihn wie folgt starten:
22
23.. code:: bash
24
25 redis-server
26
27
28Konfigure Redis in wallabag
29---------------------------
30
31Bearbeite die Datei ``app/config/parameters.yml``, um die RabbitMQ Konfiguration einzurichten. Die Standardkonfiguration sollte ok sein:
32
33.. code:: yaml
34
35 redis_host: localhost
36 redis_port: 6379
37
38Enable Redis in wallabag
39------------------------
40
41In internal settings, in the **Import** section, enable Redis (with the value 1).
42
43Starte den Redis Consumer
44-------------------------
45
46Abhängig von welchem Service du importieren möchtest, solltest du einen Cron Job aktivieren (oder mehrere, wenn du viele unterstützen willst):
47
48.. code:: bash
49
50 # for Pocket import
51 bin/console wallabag:import:redis-worker -e=prod pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log
52
53 # for Readability import
54 bin/console wallabag:import:redis-worker -e=prod readability -vv >> /path/to/wallabag/var/logs/redis-readability.log
55
56 # for Instapaper import
57 bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log
58
59 # for wallabag v1 import
60 bin/console wallabag:import:redis-worker -e=prod wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log
61
62 # for wallabag v2 import
63 bin/console wallabag:import:redis-worker -e=prod wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log
64
65 # for Firefox import
66 bin/console wallabag:import:redis-worker -e=prod firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log
67
68 # for Chrome import
69 bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-chrome.log
70
71Wenn du den Import nur für ein paar Nachrichten und nicht für alle starten willst, kannst du die Nummer (im folgenden Beispiel 12) angeben. Der Redis Worker wird dann nach der 12. Nachricht stoppen:
72
73.. code:: bash
74
75 bin/console wallabag:import:redis-worker -e=prod pocket -vv --maxIterations=12