Ejecuciones, estado y recuperación

Max PrilutskiyCEO y cofundador2 min de lectura

lingo push envía una ejecución al motor y termina; o, con --wait, espera a que finalice y escribe los resultados. De cualquier forma, la ejecución queda en el servidor, no en tu terminal, así que puedes cerrar la terminal y aun así recuperar los resultados más tarde, desde el mismo checkout. Esta página explica cómo funciona y cómo recuperarte si una ejecución falla.

Estado de la ejecución#

Cada push registra la ejecución que envió en un archivo por máquina:

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

El <hash> se deriva de la ruta absoluta del proyecto, así que cada checkout tiene su propia entrada. El archivo guarda el ID de la ejecución, el motor y la organización: lo suficiente para que un lingo pull posterior encuentre las salidas.

Es estado por máquina, no estado del proyecto: vive en tu directorio personal, nunca en el repositorio, y no se versiona.

Recuperar más tarde#

Como la ejecución queda del lado del servidor, puedes hacer push, irte y hacer pull cuando termine:

bash
lingo push

# later — same machine, same checkout
lingo pull

pull recupera las salidas de la ejecución más reciente de este proyecto. También revisa el lockfile en busca de cambios locales y se niega a sobrescribirlos a menos que pases --force. Consulta lingo pull.

El estado de la ejecución nunca sale de la máquina, así que otra máquina o un ejecutor de CI no puede pull una ejecución enviada desde otro lugar: falla con No saved run state for this project o recupera el último push de esa máquina. Para llevar a tu máquina las traducciones hechas en CI, confírmalas en CI y git pull. Consulta CI/CD.

Mover el proyecto

El nombre del archivo de estado de la ejecución se basa en la ruta absoluta del proyecto. Si mueves el directorio entre push y pull, la búsqueda no dará con él; el ID de la ejecución sigue en ~/.lingo/runs/ si necesitas recuperarlo manualmente.

Recuperar una ejecución fallida#

Si una ejecución falla a mitad del proceso —por un timeout o un error transitorio del motor— usa:

bash
lingo resume

resume vuelve a emitir las salidas a partir de los resultados en caché del motor en lugar de volver a traducir, así que una ejecución recuperada no vuelve a gastar créditos. Informa qué recuperó y qué no pudo volver a vincular.

Si resume informa destinos que no pudo recuperar, complétalos con un backfill normal:

bash
lingo push --backfill-missing

Cuándo usar cada opción#

SituaciónComando
Obtener resultados después de cerrar la terminallingo pull
Traducir en CI y confirmar los resultadoslingo push --wait y luego confirmar
Una ejecución falló a mitad del procesolingo resume
La reanudación dejó huecoslingo push --backfill-missing