CLI v0の並列処理
プロバイダーの処理能力には限りがあることを踏まえ、従来のワーカープールを制御し、部分的な出力を回収する方法を説明します。
V0はロケールとファイルの組み合わせを翻訳タスクに変換し、クライアント側のワーカープールに割り当てます。ワーカーを増やすと、同時に処理できるタスクも増えます。ただし、プロバイダーの利用上限が引き上げられるわけでも、プロジェクト全体が単一のトランザクションとして処理されるわけでもありません。
原因調査は少ないワーカー数で始める #
lingo.dev@0.138.10の既定のワーカー数は10です。スロットリングの原因を調べる場合や、使い慣れていないバックエンドを調査する場合は、ワーカー数を少なめに設定して始めてください。
lingo run --concurrency 2 --target-locale es同時実行数を増やす前に、プロバイダーのエラー、メモリ使用量、処理が完了した出力を確認してください。ヘルプには最大10と記載されていますが、引数の検証では10を超える正の数も受け付けます。インストール済みのリリースとバックエンドの組み合わせで動作を検証していない限り、10以下に抑えてください。
まず不要な処理を減らす #
ファイル、ロケール、バケット、キーのセレクターを使い、実際に処理するタスクの範囲を絞り込みます。--source-localeは、その実行で使用するソースを変更します。ワイルドカードを含むセレクターは引用符で囲み、設定に基づいて検出されたパスを確認してください。
強制実行は翻訳対象の差分を変更します。一方、凍結モードは翻訳を行わず、同期状態を確認します。どちらもワーカー数は変更しません。確認する出力が多すぎる場合は、差分を必要な範囲に絞って小さくすることが、最も有効な対策になることがよくあります。
失敗しても完了済みの処理結果を保持する #
Lingo.dev経由の処理では、大きなペイロードを分割し、すべての処理が終わる前に、返されたチャンクを書き込むことができます。また、あるタスクが失敗しても、ほかのタスクは完了する場合があります。差分を保持し、失敗したロケールとファイルを特定して、該当する範囲を再試行してください。プロジェクト全体を強制実行するのは、その後にしてください。
対象ロケールやキーで範囲を絞った出力では、既存のソースチェックサムの基準値は更新されません。基準値の確定は、意図を持って行ってください。翻訳先への書き込みが完了しても、すべてのロケールが最新であるとは限りません。
ファイルごとの入出力調整により、同じ実行内では共有ファイルへの書き込みが順番に行われます。ただし、別のCLIプロセスやエディターが同じファイルに書き込むことは防げません。同じ設定とLockfileを使う処理を、競合する形で実行しないでください。キャンセルしても以前の内容には戻りません。また、再試行前の消去は、データの削除を伴うため、別途判断が必要です。