Как восстановить прерванный запуск локализации

Выясните, что уже завершено в отправленном запуске, получите доступные результаты и сохраните локальные исправления, пока разбираетесь с остальным.

Если закрыть терминал во время lingo push --wait, сервер сам по себе не остановится. Перевод может ещё выполняться, ждать проверки или уже быть готовым. Выясните его состояние, прежде чем отправлять тот же контент повторно.

Это руководство — о работе, которую вы уже отправили. Для нового исправления используйте выборочное обновление. Если принятые переводы нужно сохранить при обычных изменениях, см. рекомендации по сохранению.

Сохраните данные о запуске и локальное состояние #

Запишите ИД запуска, выведенный в терминале, ревизию исходного контента, выбранные файлы и локали, а также последний известный статус. Сохраните состояние запуска в checkout, Lockfile и все локальные правки переводов. Если сначала удалить эти записи, можно потерять данные, нужные для восстановления работы.

Если работа отправлена для двух целевых локалей, проверьте каждую отдельно. Не считайте, что закрытие терминала прервало работу над обеими на одном этапе.

Проверьте возможность получить результаты перед повторным запуском #

В checkout, из которого отправили работу, используйте сохранённые данные запуска:

bash
lingo pull --dry-run

Так вы проверите, что будет записано локально, не меняя файлы. Команда может запрашивать статус незавершённой работы и сообщать об ожидании проверки, сбое или доступных результатах. Pull записывает каждый документ, когда готовы все его локали, и не трогает документы, ожидающие ручной проверки. Выполните команду ещё раз, когда проверка завершится. Пройдите обязательную проверку в отдельном рабочем процессе, а не отправляйте исходный контент снова и снова.

Когда результаты будут готовы, проверьте конфликты, затем получите их:

bash
lingo pull

Pull использует сохранённое локальное состояние и не ищет произвольные запуски с другого компьютера. Переводы, зафиксированные в другом месте, получайте через систему контроля версий. Точный список файлов и правила обработки конфликтов для установленной версии CLI описаны в справочнике по состоянию запуска и разделе Pull.

Повторите работу после сбоя с помощью push #

Устраните указанную причину сбоя и повторите исходную команду push с теми же аргументами из checkout, из которого отправляли работу. Для обычного обновления исходного контента:

bash
lingo push --wait

Если результаты предыдущего push ещё не получены и запрос не изменился, push использует его повторно, не отправляя ту же работу дважды. Команда заново подключается к выполняющемуся заданию, получает результаты завершённого, а задание со сбоем заменяет новым, с новым ИД. Документы, полученные до сбоя, уже записаны в Lockfile, поэтому повторная попытка запрашивает только то, что ещё не получено или изменилось.

После повторной попытки проверьте результаты по целевым локалям и полученные файлы, затем определите, что осталось сделать. Прежде чем добавлять недостающие файлы переводов в существующий проект, завершите обычные обновления исходного контента для существующих переводов, получите и проверьте результаты. Не меняйте эту ревизию исходного контента, пока добавляете недостающие файлы с помощью lingo push --backfill-missing --wait. Порядок действий описан в разделе Как добавить язык. Для изменённых ключей в существующих файлах нужно соответствующее обычное или выборочное обновление.

Выберите способ исправления по типу сбоя #

Отсутствие локальной записи — не то же самое, что сбой запуска на сервере. Некорректный контент нужно исправить, при отказе в доступе — получить доступ, а при ожидании проверки — принять решение. Если из-за сетевого ответа неясно, принял ли сервер работу, выясните это перед повторной отправкой.

Не меняйте исходный контент только ради повторной попытки после сбоя. Сохраните старый ИД запуска и убедитесь, что выведенный ИД нового задания отличается от прежнего. В разделе Как восстановить работу CLI описаны проверка результатов и порядок обращения в поддержку, если возвращается то же задание со сбоем.

Если результаты получены частично, сохраните успешные переводы, прошедшие проверку, а целевые локали со сбоями перечислите отдельно. Если нужен новый запуск, запишите, почему он продолжает или заменяет предыдущий и какую ревизию исходного контента использует. Это поможет не принять запоздавший результат за актуальный.

Устраните расхождения с локальными правками #

Pull может отказаться заменять перевод, изменённый после сохранения его версии. Сравните локальную правку и входящий результат с соответствующими ревизиями исходного контента, затем выберите итоговую формулировку в ходе проверки.

lingo pull --force обходит эту защиту и перезаписывает переводы с расхождениями. Сначала сохраните локальную работу и решите, действительно ли нужна замена. Если каталоги общие, защитите весь файл, включая исходный контент и незатронутые локали.

Убедитесь, что результаты готовы к использованию #

Сравните пути полученных файлов, локали, переменные и различия между версиями. Загрузите результат в приложение или средство отображения и проверьте смысл. Если файл доступен для получения, это ещё не значит, что он одобрен для использования.

Сохраните ИД восстановленного запуска, принятую ревизию, Lockfile и переводы как новую отправную точку. Восстановление завершено, когда все оставшиеся сбои учтены, а принятый результат соответствует нужному исходному контенту. Успешного выполнения одной команды для этого недостаточно.