diff options
author | Nicolas Lœuillet <nicolas@loeuillet.org> | 2016-11-18 09:28:20 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2016-11-18 09:28:20 +0100 |
commit | 19d401b15c1151bfa6c2364f31cc1eb87e7c99ef (patch) | |
tree | 9c47399f9b1a9ad2228ec365a1fd5e20edc7771f /docs/de/developer | |
parent | 9e0a49e6acf60c3dbf3c479cb36d404239dfda89 (diff) | |
parent | 50540682ffcaa6acf16f3b17cede3da9694c494f (diff) | |
download | wallabag-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.rst | 2 | ||||
-rw-r--r-- | docs/de/developer/asynchronous.rst | 158 | ||||
-rw-r--r-- | docs/de/developer/rabbitmq.rst | 81 | ||||
-rw-r--r-- | docs/de/developer/redis.rst | 75 |
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 @@ | |||
1 | API DoKumentation | 1 | API Dokumentation |
2 | ================= | 2 | ================= |
3 | 3 | ||
4 | Dank dieser Dokumentation werden wir sehen, wie wir mit der wallabag API interagieren. | 4 | Dank 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 @@ | |||
1 | Asynchrone Aufgaben | ||
2 | =================== | ||
3 | |||
4 | Um große asynchrone Aufgaben zu starten (etwa für große Importe), können wir RabbitMQ oder Redis nutzen. | ||
5 | |||
6 | Installation von RabbitMQ für asynchrone Aufgaben | ||
7 | ------------------------------------------------- | ||
8 | |||
9 | Voraussetzungen | ||
10 | ^^^^^^^^^^^^^^^ | ||
11 | |||
12 | Du musst RabbitMQ auf deinem Server installiert haben. | ||
13 | |||
14 | Installation | ||
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 | |||
24 | Konfiguration 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 | |||
32 | RabbitMQ stoppen | ||
33 | ^^^^^^^^^^^^^^^^ | ||
34 | |||
35 | .. code:: bash | ||
36 | |||
37 | rabbitmqctl stop | ||
38 | |||
39 | RabbitMQ für wallabag konfigurieren | ||
40 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
41 | |||
42 | Bearbeite 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 | |||
51 | RabbitMQ in wallabag aktivieren | ||
52 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
53 | |||
54 | In den internen Einstellungen, aktiviere RabbitMQ im Import-Abschnitt mit dem Wert 1. | ||
55 | |||
56 | Starte den RabbitMQ-Consumer | ||
57 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
58 | |||
59 | Abhä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 | |||
84 | Redis für asynchrone Aufgaben installieren | ||
85 | ------------------------------------------ | ||
86 | |||
87 | Um große asynchrone Aufgaben zu starten (etwa für große Importe), können wir auch Redis nutzen. | ||
88 | |||
89 | Voraussetzungen | ||
90 | ^^^^^^^^^^^^^^^ | ||
91 | |||
92 | Du musst Redis auf deinem Server installiert haben. | ||
93 | |||
94 | Installation | ||
95 | ^^^^^^^^^^^^ | ||
96 | |||
97 | .. code:: bash | ||
98 | |||
99 | apt-get install redis-server | ||
100 | |||
101 | Start | ||
102 | ^^^^^ | ||
103 | |||
104 | Der 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 | |||
111 | Redis für wallabag konfigurieren | ||
112 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
113 | |||
114 | Bearbeite 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 | |||
121 | Redis in wallabag aktivieren | ||
122 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
123 | |||
124 | In den internen Einstellungen, aktiviere Redis im Import-Abschnitt mit dem Wert 1. | ||
125 | |||
126 | Starten des Redis-Consumer | ||
127 | ^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
128 | |||
129 | Abhä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 | |||
154 | Wenn 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 @@ | |||
1 | Installiere RabbitMQ für asynchrone Aufgaben | ||
2 | ============================================ | ||
3 | |||
4 | Um asynchrone Aufgaben zu starten (nützlich z.B. für große Imports), können wir RabbitMQ nutzen. | ||
5 | |||
6 | Voraussetzungen | ||
7 | --------------- | ||
8 | |||
9 | Du musst RabbitMQ auf deinem Server installiert haben. | ||
10 | |||
11 | Installation | ||
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 | |||
21 | Konfiguration 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 | |||
29 | RabbitMQ stoppen | ||
30 | ~~~~~~~~~~~~~~~ | ||
31 | |||
32 | .. code:: bash | ||
33 | |||
34 | rabbitmqctl stop | ||
35 | |||
36 | |||
37 | Konfigure RabbitMQ in wallabag | ||
38 | ------------------------------ | ||
39 | |||
40 | Bearbeite 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 | |||
49 | Enable RabbitMQ in wallabag | ||
50 | --------------------------- | ||
51 | |||
52 | In internal settings, in the **Import** section, enable RabbitMQ (with the value 1). | ||
53 | |||
54 | Starte den RabbitMQ Consumer | ||
55 | ---------------------------- | ||
56 | |||
57 | Abhä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 @@ | |||
1 | Installiere Redis für asynchrone Aufgaben | ||
2 | ========================================= | ||
3 | |||
4 | Um asynchrone Aufgaben zu starten (nützlich z.B. für große Imports), können wir Redis nutzen. | ||
5 | |||
6 | Voraussetzungen | ||
7 | --------------- | ||
8 | |||
9 | Du musst Redis auf deinem Server installiert haben. | ||
10 | |||
11 | Installation | ||
12 | ~~~~~~~~~~~~ | ||
13 | |||
14 | .. code:: bash | ||
15 | |||
16 | apt-get install redis-server | ||
17 | |||
18 | Starten | ||
19 | ~~~~~~ | ||
20 | |||
21 | Der 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 | |||
28 | Konfigure Redis in wallabag | ||
29 | --------------------------- | ||
30 | |||
31 | Bearbeite 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 | |||
38 | Enable Redis in wallabag | ||
39 | ------------------------ | ||
40 | |||
41 | In internal settings, in the **Import** section, enable Redis (with the value 1). | ||
42 | |||
43 | Starte den Redis Consumer | ||
44 | ------------------------- | ||
45 | |||
46 | Abhä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 | |||
71 | Wenn 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 | ||