Ejecuciones, estado y recuperación

Max PrilutskiyCEO y cofundador2 min de lectura

lingo push envía una ejecución al motor y sale; o, con --wait, espera a que termine y escribe los resultados. En cualquier caso, la ejecución se queda en el servidor, no en tu terminal, así que puedes cerrar la terminal y recoger los resultados más tarde desde el mismo checkout. En esta página se explica cómo funciona y cómo recuperarte si falla una ejecución.

Estado de la ejecución#

Cada push registra la ejecución que ha enviado en un archivo específico de cada máquina:

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

El <hash> se obtiene a partir 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 justo 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 incluye en los commits.

Recoger después#

Como la ejecución se queda en el 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 comprueba 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 sitio: fallará con No saved run state for this project o recuperará 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, aunque el ID de la ejecución sigue en ~/.lingo/runs/ por si necesitas recuperarlo manualmente.

Recuperar una ejecución fallida#

Si una ejecución falla a mitad de camino —por un tiempo de espera 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. Indica qué ha podido recuperar y qué no ha podido volver a vincular.

Si resume indica destinos que no ha podido recuperar, complétalos con un backfill normal:

bash
lingo push --backfill-missing

Cuándo usar cada opción#

SituaciónComando
Recuperar los 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 de procesolingo resume
La reanudación dejó huecoslingo push --backfill-missing