Skip to content

Commit 170618e

Browse files
softarksamdark
softark
authored and
samdark
committed
guide-ja/* revised [ci skip] (#231)
1 parent 15d7c9c commit 170618e

File tree

10 files changed

+27
-22
lines changed

10 files changed

+27
-22
lines changed

‎docs/guide-ja/driver-amqp-interop.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@ AMQP Interop
33

44
このドライバは RabbitMQ のキューによって動作します。
55

6-
[amqp interop](https://github.com/queue-interop/queue-interop#amqp-interop) 互換のトランスポート、例えば `enqueue/amqp-lib` パッケージを必要とします。
6+
[amqp interop](https://github.com/queue-interop/queue-interop#amqp-interop) 互換のトランスポート、
7+
例えば `enqueue/amqp-lib` パッケージを必要とします。
78

89
利点:
910

@@ -58,5 +59,5 @@ yii queue/listen [timeout]
5859

5960
`listen` コマンドが無限にキューを調べ続けるデーモンを起動します。キューに新しいタスクがあると、即座に取得され、実行されます。
6061
`timeout` パラメータはキューを調べる間のスリープの秒数を指定するものです。
61-
62-
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、最も効率的な方法です。
62+
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、
63+
最も効率的な方法です。

‎docs/guide-ja/driver-amqp.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,5 +39,5 @@ yii queue/listen [timeout]
3939

4040
`listen` コマンドが無限にキューを調べ続けるデーモンを起動します。キューに新しいタスクがあると、即座に取得され、実行されます。
4141
`timeout` パラメータはキューを調べる間のスリープの秒数を指定するものです。
42-
43-
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、最も効率的な方法です。
42+
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、
43+
最も効率的な方法です。

‎docs/guide-ja/driver-beanstalk.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,8 +32,8 @@ yii queue/listen [timeout]
3232

3333
`listen` コマンドは無限にキューを調べ続けるデーモンを起動します。キューに新しいタスクがあると、即座に取得され、実行されます。
3434
`timeout` パラメータはキューを調べる間のスリープの秒数を指定するものです。
35-
36-
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、最も効率的な方法です。
35+
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、
36+
最も効率的な方法です。
3737

3838
```sh
3939
yii queue/run

‎docs/guide-ja/driver-db.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -83,8 +83,8 @@ yii queue/listen [timeout]
8383

8484
`listen` コマンドは無限にキューを調べ続けるデーモンを起動します。キューに新しいタスクがあると、即座に取得され、実行されます。
8585
`timeout` パラメータはキューを調べる間のスリープの秒数を指定するものです。
86-
87-
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、最も効率的な方法です。
86+
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、
87+
最も効率的な方法です。
8888

8989
```sh
9090
yii queue/run

‎docs/guide-ja/driver-file.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,8 @@ yii queue/listen [timeout]
3030

3131
`listen` コマンドは無限にキューを調べ続けるデーモンを起動します。キューに新しいタスクがあると、即座に取得され、実行されます。
3232
`timeout` パラメータはキューを調べる間のスリープの秒数を指定するものです。
33-
34-
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、最も効率的な方法です。
33+
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、
34+
最も効率的な方法です。
3535

3636
```sh
3737
yii queue/run

‎docs/guide-ja/driver-gearman.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,6 @@ yii queue/listen [timeout]
3232

3333
`listen` コマンドは無限にキューを調べ続けるデーモンを起動します。キューに新しいタスクがあると、即座に取得され、実行されます。
3434
`timeout` パラメータはキューを調べる間のスリープの秒数を指定するものです。
35-
3635
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、最も効率的な方法です。
3736

3837
```sh

‎docs/guide-ja/driver-redis.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,8 +41,8 @@ yii queue/listen [timeout]
4141

4242
`listen` コマンドは無限にキューを調べ続けるデーモンを起動します。キューに新しいタスクがあると、即座に取得され、実行されます。
4343
`timeout` パラメータはキューを調べる間のスリープの秒数を指定するものです。
44-
45-
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、最も効率的な方法です。
44+
このコマンドを [supervisor](worker.md#supervisor) または [systemd](worker.md#systemd) によって適切にデーモン化するのが、
45+
最も効率的な方法です。
4646

4747
```sh
4848
yii queue/run

‎docs/guide-ja/retryable.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,8 @@
22
========================
33

44
ジョブの実行は失敗する可能性があります。下手に書かれたコードによる内部的なエラーによって失敗する場合は、
5-
まずもってコードを守成すべきです。しかし、また、サービスやリソースが利用できないなど、外部的な問題によって
5+
まずもってコードを修正すべきです。
6+
しかし、また、サービスやリソースが利用できないなど、外部的な問題によって
67
ジョブの実行が失敗する場合もあります。その場合は例外やタイムアウトになり得ます。
78

89
後者の場合においては、いくらか時間をおいて再試行できる方が良いでしょう。そうするための方法がいくつかあります。
@@ -24,7 +25,8 @@
2425

2526
`ttr` オプションはジョブ実行のために予約される時間を設定します。ジョブの実行がこの時間より長くかかっている場合、
2627
実行は停止され、後で再試行するためにキューに戻されます。ジョブが例外を投げたときも、同じことが生じます。
27-
`attempts` オプションが試行の最大回数を設定します。この数に達してもまだ完了しない場合、ジョブは終了したものとしてキューから削除されます。
28+
`attempts` オプションが試行の最大回数を設定します。
29+
この数に達してもまだ完了しない場合、ジョブは終了したものとしてキューから削除されます。
2830

2931
これらのオプションはキューの中の全てのジョブに適用されます。この振る舞いを特定のジョブについて変更したい場合は、
3032
次の方法を参照して下さい。
@@ -60,7 +62,8 @@ class SomeJob extends BaseObject implements RetryableJobInterface
6062
イベント・ハンドラ
6163
------------------
6264

63-
TTR と失敗したジョブの再試行回数を制御する第三の方法は、`Queue::EVENT_BEFORE_PUSH` と `Queue::EVENT_AFTER_ERROR` のイベントを利用するものです。
65+
TTR と失敗したジョブの再試行回数を制御する第三の方法は、`Queue::EVENT_BEFORE_PUSH` と
66+
`Queue::EVENT_AFTER_ERROR` のイベントを利用するものです。
6467

6568
TTR は `Queue::EVENT_BEFORE_PUSH` イベントによって設定することが出来ます。
6669

@@ -82,7 +85,8 @@ Yii::$app->queue->on(Queue::EVENT_AFTER_ERROR, function (ErrorEvent $event) {
8285
});
8386
```
8487

85-
イベント・ハンドラは `RetryableJobInterface` のメソッドの後で実行され、従って、最も高い優先度を持ちます。
88+
イベント・ハンドラは `RetryableJobInterface` のメソッドの後で実行され、従って、
89+
最も高い優先度を持ちます。
8690

8791
制約
8892
----

‎docs/guide-ja/usage.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -155,7 +155,8 @@ Yii::$app->queue->on(Queue::EVENT_AFTER_ERROR, function ($event) {
155155
イベントのロギング
156156
------------------
157157

158-
queue コンポーネントは [Yii の内蔵ロガー](http://www.yiiframework.com/doc-2.0/guide-runtime-logging.html) を使ってキューのイベントを記録する `LogBehavior` を提供しています。
158+
queue コンポーネントは [Yii の内蔵ロガー](http://www.yiiframework.com/doc-2.0/guide-runtime-logging.html)
159+
を使ってキューのイベントを記録する `LogBehavior` を提供しています。
159160

160161
これを有効にするためには、queue コンポーネントを以下のように構成するだけです。
161162

@@ -217,7 +218,8 @@ Yii::$app->queue2->push([
217218
--------
218219

219220
キューを使用する場合、キューに置かれたタスクは独立したプロセスによって取得される、ということを覚えておくことが重要です。
220-
タスクを実行するときに外部的な依存は避けなければなりません。なぜなら、ワーカがジョブを実行する環境においてその依存を利用できるとは限らないからです。
221+
タスクを実行するときに外部的な依存は避けなければなりません。
222+
なぜなら、ワーカがジョブを実行する環境においてその依存を利用できるとは限らないからです。
221223

222224
タスクを処理するために必要なデータは、ジョブ・オブジェクトのプロパティに設定して、ジョブと一緒にキューに送らなければなりません。
223225

‎docs/guide-ja/worker.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,8 +34,7 @@ stdout_logfile=/var/www/my_project/log/yii-queue-worker.log
3434
Supervisor の構成と使用方法については、その [ドキュメント](http://supervisord.org) を参照して下さい。
3535

3636
`queue/listen` で開始されるワーカ・デーモンがサポートされているのは、[ファイル]、[データベース]、[Redis]、
37-
[RabbitMQ]、[AMQP Interop]、[Beanstalk] および [Gearman] のドライバだけであることに留意して下さい。
38-
追加のオプションについては、ドライバのガイドを参照して下さい。
37+
[RabbitMQ]、[AMQP Interop]、[Beanstalk] および [Gearman] のドライバだけであることに留意して下さい。追加のオプションについては、ドライバのガイドを参照して下さい。
3938

4039
[ファイル]: driver-file.md
4140
[データベース]: driver-db.md

0 commit comments

Comments
 (0)