|
문서
데모 예약플랫폼
플랫폼MCPCLI
API워크플로
가이드변경 로그

개요

  • @lingo.dev/cli

시작하기

  • 빠른 시작
  • 구성

레퍼런스

  • lingo push
  • lingo pull
  • 기타 명령어
  • lingo purge

구성

  • 키 제어
  • 형식
  • 로캘

가이드

  • 로캘 추가하기
  • 기존 번역 활용하기
  • 재번역
  • 번역자 노트
  • 실행, 상태, 그리고 복구
  • CI/CD
  • 모노레포
  • 대규모 프로젝트

이전 CLI (v0)를 찾고 계신가요? 레거시 CLI 문서 보기

실행, 상태, 그리고 복구

lingo push는 실행을 엔진에 제출한 뒤 완료될 때까지 기다립니다. 하지만 실행 자체는 터미널이 아니라 서버에서 유지되므로, 터미널을 닫거나 다른 머신으로 옮기거나 CI가 이어서 처리하더라도 결과를 계속 받아볼 수 있습니다. 이 페이지에서는 그 동작 방식과 실행 실패 시 복구하는 방법을 설명합니다.

실행 상태#

각 push는 제출한 실행 정보를 머신별 파일에 기록합니다:

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

<hash>는 프로젝트의 절대 경로를 기준으로 생성되므로, 체크아웃마다 별도의 항목이 생깁니다. 이 파일에는 실행 ID, 엔진, org가 저장되며, 이후 lingo pull가 결과를 찾는 데 필요한 정보가 모두 들어 있습니다.

이 상태는 프로젝트 상태가 아니라 머신별 상태입니다. 즉, 리포지토리가 아니라 홈 디렉터리에 저장되며 커밋되지도 않습니다.

다른 머신에서 pull하기#

실행은 서버에 저장되므로, 한 곳에서 push하고 다른 곳에서 pull할 수 있습니다:

bash
# laptop
lingo push

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

pull는 이 프로젝트의 가장 최근 실행 결과를 가져옵니다. 또한 lockfile에 로컬 수정 사항이 있는지 확인하고, --force를 지정하지 않는 한 이를 덮어쓰지 않습니다. 자세한 내용은 lingo pull을 참고하세요.

프로젝트를 옮긴 경우

실행 상태 파일명은 프로젝트의 절대 경로를 기준으로 정해집니다. push와 pull 사이에 디렉터리를 옮기면 조회에 실패할 수 있습니다. 수동으로 복구해야 한다면 실행 ID는 여전히 ~/.lingo/runs/에 남아 있습니다.

실패한 실행 복구하기#

실행이 중간에 실패했다면(예: 타임아웃, 일시적인 엔진 오류) 다음 명령을 사용하세요:

bash
lingo resume

resume는 다시 번역하지 않고 엔진에 캐시된 결과에서 출력을 다시 내보냅니다. 따라서 복구된 실행에는 크레딧이 다시 소모되지 않습니다. 무엇을 복구했고 무엇은 다시 연결하지 못했는지도 함께 알려줍니다.

resume가 복구하지 못한 대상을 보고하면, 일반 backfill로 채우면 됩니다:

bash
lingo push --backfill-missing

상황별로 이렇게 사용하세요#

상황명령어
터미널을 닫은 뒤 결과 받기lingo pull
노트북에서 push하고 CI에서 pulllingo push 후 lingo pull
실행이 중간에 실패한 경우lingo resume
재개 후 일부가 비어 있는 경우lingo push --backfill-missing

이 페이지가 도움이 되었나요?

Max PrilutskiyMax Prilutskiy·업데이트됨 4일 전·1 min read