中断したローカライズ処理を復旧する
送信済みの処理がどこまで完了したかを確認し、回収できる出力を取得。ローカルでの修正を保持しながら、残りの問題を解決します。
lingo push --waitの実行中にターミナルを閉じても、それだけでサーバー側の処理が止まるわけではありません。翻訳はまだ実行中かもしれませんし、レビュー待ちや完了済みの場合もあります。同じコンテンツを再送信する前に、まず状態を確認してください。
このガイドでは、送信済みの処理を扱います。新たな修正には、範囲を限定した更新を使用してください。通常の変更後も承認済みの翻訳を保持する必要がある場合は、保持に関するガイドを参照してください。
復旧の手がかりとローカルの状態を残す#
表示された実行ID、ソースのリビジョン、選択したファイルとロケール、最後に確認したステータスを記録してください。チェックアウト内の実行状態、Lockfile、ローカルでの翻訳の編集内容も保持してください。これらの記録を先に削除すると、復旧に必要な情報が失われる可能性があります。
二つの翻訳先ロケールに送信した処理では、ターミナルを閉じたことで両方が同じ段階で中断したと決めつけず、それぞれの状態を確認してください。
やり直す前に取得できる内容を確認する#
送信元のチェックアウトで、記録済みの実行情報を使用します。
lingo pull --dry-runこれにより、ファイルを変更せずに、ローカルに書き込まれる予定の内容を確認できます。未完了の処理を定期的に確認し、レビュー待ちや失敗、取得可能な出力の有無を報告します。プルは、各ドキュメントのすべてのロケールが完了した時点で、そのドキュメントを書き込みます。人によるレビュー待ちのドキュメントには変更を加えません。レビューが終わったら、再度実行してください。ソースを繰り返し再送信するのではなく、必要なレビューを専用のワークフローで完了させてください。
出力の準備ができたら、競合を確認してから取得します。
lingo pullプルはローカルに記録された状態を使用します。別のマシンから送信された任意の実行を検索するものではありません。別の場所でコミットされた翻訳は、バージョン管理を通じて受け取ってください。インストールされているCLIが使用する具体的なファイルと競合時のルールは、実行状態のリファレンスとプルで説明しています。
プッシュで失敗した処理を再試行する#
報告された原因を修正したら、送信元のチェックアウトから、同じ引数で元のプッシュを再実行してください。通常のソース更新では、次のようにします。
lingo push --wait前回のプッシュの結果をまだ回収しておらず、リクエストにも変更がない場合、プッシュは同じ処理を二重に送信せず、前回の処理を再利用します。実行中のジョブには再接続し、完了済みのジョブからは結果を回収します。失敗したジョブは、新しいIDの新規ジョブに置き換えます。失敗前に回収されたドキュメントはすでにLockfileに記録されているため、再試行では、まだ不足している内容や変更された内容の処理だけを要求します。
再試行後は、翻訳先ごとの結果と取得したファイルを確認し、残っている作業を特定してください。既存のプロジェクトで不足している翻訳先ファイルを補完する前に、既存の翻訳先に対する通常のソース更新を完了し、結果を取得して確認してください。lingo push --backfill-missing --waitで不足ファイルを補完する間は、そのソースのリビジョンを固定してください。手順は言語を追加するで説明しています。既存ファイル内のキーが変更された場合は、補完ではなく、内容に応じて通常の更新か範囲を限定した更新が必要です。
失敗の種類に合わせて対処する#
ローカルの記録がない状態と、サーバー上の処理が失敗した状態は異なります。無効なコンテンツには修正が、権限に関する拒否にはアクセス権の確保が、レビュー待ちには判断が必要です。ネットワークの応答が不確かな場合は、再送信する前に、サーバーが処理を受け付けたかどうかを確認してください。
失敗した処理を再試行するためだけに、ソースを変更しないでください。以前の実行IDを残し、新たに表示されたジョブIDが以前のものと異なることを確認してください。出力の検証方法と、同じ失敗済みジョブが返された場合のサポートへの問い合わせ方法は、CLIの復旧手順で説明しています。
一部の結果だけが得られた場合は、正常に完了してレビューも済んだ翻訳を保持し、失敗した翻訳先は別に一覧にしてください。新しい実行が必要な場合は、以前の実行に続けて行う、または以前の実行を置き換える理由と、使用するソースのリビジョンを記録してください。遅れて届いた結果を現在の出力と取り違えるのを防げます。
ローカルとの相違を解消する#
プルは、記録されたバージョンから変更されている翻訳の置き換えを拒否する場合があります。ローカルの編集内容と取得する出力を、それぞれのソースのリビジョンと照らし合わせ、レビューを通じて採用する表現を選んでください。
lingo pull --forceはこの保護を回避し、相違のある翻訳を上書きします。まずローカルの作業を保存し、置き換えることを明確に決めたうえで実行してください。共有カタログでは、ソースと未変更のロケールも含め、ファイル全体を保護してください。
使える出力を確認して復旧を終える#
取得したパス、ロケール、変数、差分を比較してください。結果をアプリケーションやレンダラーに読み込み、意味を確認してください。ファイルを取得できても、利用が承認されているとは限りません。
復旧した実行ID、承認済みのリビジョン、Lockfile、翻訳を、次回の基準として保持してください。復旧の完了は、一つのコマンドが正常終了したかどうかでは判断できません。残っている失敗の状況をすべて把握し、承認済みの出力が意図したソースと一致していることを確認できて、初めて復旧は完了です。