중단된 현지화 실행 복구하기
제출한 실행에서 실제로 완료된 작업을 확인하고, 복구 가능한 결과물을 가져오세요. 나머지 문제를 해결하는 동안 로컬 수정 사항도 보존하세요.
lingo push --wait 도중 터미널을 닫아도 서버가 자동으로 중지되지는 않습니다. 번역이 아직 진행 중이거나, 검토를 기다리고 있거나, 이미 완료되었을 수 있습니다. 같은 콘텐츠를 다시 제출하기 전에 먼저 상태를 확인하세요.
이 가이드는 이미 제출한 작업의 복구를 다룹니다. 새로 수정할 내용이 있다면 범위를 지정한 업데이트를 사용하세요. 일반적인 변경 이후에도 승인된 대상 번역을 유지해야 한다면 보존 지침을 참고하세요.
근거 자료와 로컬 상태 보존하기 #
출력된 실행 식별자, 소스 리비전, 선택한 파일과 로캘, 마지막으로 확인한 상태를 기록하세요. checkout의 실행 상태와 Lockfile, 로컬에서 수정한 대상 번역도 보존하세요. 이런 기록부터 삭제하면 작업 복구에 필요한 정보가 사라질 수 있습니다.
두 개의 대상 로캘로 제출한 실행이라면 각 대상을 따로 확인하세요. 터미널 연결이 끊겼다고 해서 두 대상의 작업이 같은 시점에 중단되었다고 가정하지 마세요.
다시 시작하기 전에 가져올 내용 확인하기 #
제출에 사용한 checkout에서 기록된 실행을 사용하세요:
lingo pull --dry-run이 작업은 파일을 변경하지 않고 로컬에 기록될 내용을 미리 확인합니다. 미완료 작업의 상태를 주기적으로 조회해 검토 대기, 실패 또는 가져올 수 있는 결과물을 알려줄 수 있습니다. 풀 작업은 문서의 모든 로캘이 완료되면 해당 문서를 기록하고, 사람이 하는 검토를 기다리는 문서는 그대로 둡니다. 검토자가 검토를 마치면 다시 실행하세요. 소스를 반복해서 제출하지 말고 해당 검토 워크플로에서 필요한 검토를 완료하세요.
결과물이 준비되면 충돌을 확인한 뒤 가져오세요:
lingo pull풀 작업은 로컬에 기록된 상태를 사용하며, 다른 컴퓨터에서 실행한 임의의 작업을 찾아주지는 않습니다. 다른 곳에서 커밋한 번역은 버전 관리를 통해 받으세요. 설치된 CLI에서 사용하는 정확한 파일과 충돌 처리 규칙은 실행 상태 레퍼런스와 풀 문서에서 확인할 수 있습니다.
푸시로 실패한 작업 재시도하기 #
보고된 원인을 해결한 뒤, 제출에 사용한 checkout에서 같은 인수로 원래 푸시를 다시 실행하세요. 일반적인 소스 업데이트의 경우:
lingo push --wait이전 푸시의 결과물을 아직 가져오지 않았고 요청도 바뀌지 않았다면, 푸시는 같은 작업을 두 번 제출하지 않고 기존 작업을 재사용합니다. 진행 중인 작업에는 다시 연결하고, 완료된 작업의 결과물은 가져오며, 실패한 작업은 새로운 식별자를 가진 새 작업으로 대체합니다. 실패 전에 가져온 문서는 이미 Lockfile에 기록되어 있으므로, 재시도할 때는 아직 누락되었거나 변경된 작업만 요청합니다.
재시도 후 대상별 결과와 가져온 파일을 확인하고 남은 작업을 파악하세요. 기존 프로젝트에서 누락된 대상 파일을 채우기 전에는 기존 대상의 일반 소스 업데이트를 완료하고 결과물을 가져와 확인하세요. lingo push --backfill-missing --wait로 누락된 파일을 채우는 동안에는 소스 리비전을 고정해 두세요. 작업 순서는 언어 추가에서 안내합니다. 기존 파일 안에서 변경된 키에는 누락 파일 채우기가 아니라 상황에 맞는 일반 업데이트나 범위를 지정한 업데이트가 필요합니다.
실패 유형에 맞게 복구하기 #
로컬 기록이 누락된 경우와 서버 실행이 실패한 경우는 다릅니다. 잘못된 콘텐츠는 수정해야 하고, 권한이 거부되었다면 접근 권한을 확보해야 하며, 검토 대기 상태라면 결정을 내려야 합니다. 네트워크 응답이 불확실하다면 다시 제출하기 전에 서버가 작업을 수락했는지 확인해야 합니다.
실패한 실행을 다시 시도하기 위해서만 소스를 변경하지 마세요. 이전 실행 식별자를 보관하고 새로 출력된 작업 식별자가 이전과 다른지 확인하세요. CLI 복구 절차에서는 결과물 검증 방법과 동일한 실패 작업이 반환될 때 지원을 받는 방법을 안내합니다.
결과가 일부만 나온 경우, 성공적으로 완료되어 검토를 마친 대상은 보존하고 실패한 대상은 따로 나열하세요. 새 실행이 필요하다면 이전 실행을 이어서 진행하거나 대체하는 이유와 사용하는 소스 리비전을 기록하세요. 그래야 늦게 도착한 결과물을 현재 결과물로 오인하지 않습니다.
로컬 변경 사항과의 차이 조정하기 #
풀 작업은 기록된 버전 이후에 변경된 대상을 덮어쓰지 않을 수 있습니다. 로컬 수정 사항과 가져올 결과물을 각각의 소스 리비전과 비교한 뒤, 검토를 통해 승인할 문구를 선택하세요.
lingo pull --force는 이 보호 장치를 우회해 차이가 있는 대상을 덮어씁니다. 먼저 로컬 작업을 저장하고 덮어쓸지 신중하게 결정하세요. 공유 카탈로그를 사용한다면 소스와 수정하지 않은 로캘까지 파일 전체를 보호하세요.
사용 가능한 결과물로 마무리하기 #
가져온 파일의 경로, 로캘, 변수, 변경 내역을 비교하세요. 결과물을 해당 애플리케이션이나 렌더러에 불러와 의미가 올바른지 살펴보세요. 파일을 가져올 수 있다고 해서 사용까지 승인된 것은 아닙니다.
복구한 실행 식별자, 승인된 리비전, Lockfile, 대상 번역을 다음 작업의 기준 상태로 보관하세요. 명령 하나가 성공적으로 끝났다고 복구가 완료되는 것은 아닙니다. 남은 실패가 모두 파악되고 승인된 결과물이 의도한 소스와 일치해야 복구가 완료됩니다.