Execuções, estado e recuperação

lingo push submete uma execução ao motor e aguarda pela sua conclusão. Mas a execução fica no servidor, não no terminal — por isso, pode fechar o terminal, mudar de máquina ou deixar o CI assumir, e ainda assim ir buscar os resultados. Esta página explica como tudo isto funciona e como recuperar quando uma execução falha.

Estado da execução#

Cada push regista a execução que submeteu num ficheiro específico de cada máquina:

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

O <hash> é gerado a partir do caminho absoluto do projeto, por isso cada checkout tem a sua própria entrada. O ficheiro guarda o ID da execução, o motor e a organização — informação suficiente para que um lingo pull posterior encontre os resultados.

Trata-se de estado da máquina, não do projeto — fica na sua diretoria pessoal, nunca no repositório, e não é versionado.

Fazer pull noutra máquina#

Como a execução fica no servidor, pode fazer push num sítio e pull noutro:

# laptop
lingo push

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

pull vai buscar os resultados da execução mais recente deste projeto. Também verifica o lockfile para detetar edições locais e recusa sobrescrevê-las, a menos que passe --force. Veja lingo pull.

Recuperar uma execução com falhas#

Se uma execução falhar a meio — por exemplo, por timeout ou por um erro transitório do motor — use:

lingo resume

resume volta a emitir os resultados a partir dos resultados em cache do motor, em vez de voltar a traduzir, por isso uma execução recuperada não volta a gastar créditos. Indica o que conseguiu recuperar e o que não foi possível voltar a associar.

Se resume indicar destinos que não conseguiu recuperar, preencha-os com um backfill normal:

lingo push --backfill-missing

Quando usar cada comando#