Execuções, estado e recuperação

lingo push envia uma execução para o engine e aguarda a conclusão. Mas a execução roda no servidor, não no seu terminal — então você pode fechar o terminal, trocar de máquina ou deixar o CI assumir, e ainda assim obter os resultados. Esta página explica como isso funciona e como recuperar uma execução que falhou.

Estado da execução#

Cada push registra a execução enviada em um arquivo específico da máquina:

~/.lingo/runs/<hash>.json

O <hash> é gerado a partir do caminho absoluto do projeto, então cada checkout tem sua própria entrada. O arquivo guarda o ID da execução, o engine e a organização — o suficiente para que um lingo pull posterior encontre as saídas.

É um estado da máquina, não do projeto — fica no seu diretório home, nunca no repositório, e não é versionado.

Fazendo pull em outra máquina#

Como a execução fica no servidor, você pode fazer push em um lugar e pull em outro:

# laptop
lingo push

# CI, or a second machine with the same checkout + credentials
lingo pull

pull busca as saídas da execução mais recente deste projeto. Ele também verifica o lockfile em busca de edições locais e se recusa a sobrescrevê-las, a menos que você passe --force. Veja lingo pull.

Recuperando uma execução com falha#

Se uma execução falhar no meio do processo — por timeout ou por um erro transitório do engine — use:

lingo resume

resume reaproveita as saídas a partir dos resultados em cache do engine, em vez de traduzir tudo de novo, então uma execução recuperada não gasta créditos novamente. Ele informa o que foi recuperado e o que não pôde ser vinculado de volta.

Se resume informar destinos que não conseguiu recuperar, preencha as lacunas com um backfill normal:

lingo push --backfill-missing

Quando usar cada opção#