CLI 버전 0의 병렬 처리

공급자의 처리 용량 한계를 고려해 레거시 작업자 풀을 제어하고 부분적으로 완료된 출력을 복구하세요.

버전 0은 로캘과 파일의 조합을 번역 작업으로 만들어 클라이언트 작업자 풀에 할당합니다. 작업자가 많을수록 더 많은 작업을 동시에 처리할 수 있습니다. 그렇다고 공급자의 할당량이 늘어나거나 프로젝트 전체가 하나의 트랜잭션으로 처리되는 것은 아닙니다.

진단할 때는 작업자 풀을 작게 설정하기 #

lingo.dev@0.138.10의 기본 작업자 수는 10개입니다. 요청 제한 문제나 익숙하지 않은 백엔드를 살펴볼 때는 더 적은 수로 시작하세요:

sh
lingo run --concurrency 2 --target-locale es

동시 처리 수를 늘리기 전에 공급자 오류, 메모리 사용량, 완료된 출력을 확인하세요. 도움말에 명시된 최댓값은 10이지만, 인수 유효성 검사에서는 그보다 큰 양수도 허용합니다. 설치된 릴리스와 백엔드를 함께 검증한 경우가 아니라면 10 이하로 유지하세요.

불필요한 작업부터 줄이기 #

파일, 로캘, 버킷, 키 선택자를 사용해 실제 작업 범위를 좁히세요. --source-locale는 이번 실행에 사용할 소스를 변경합니다. 와일드카드 선택자는 따옴표로 감싸고, 설정에 따라 검색된 경로를 확인하세요.

강제 실행은 번역할 변경분을 바꾸고, 동결 모드는 번역 대신 동기화 상태를 확인합니다. 어느 쪽도 작업자 수를 바꾸지는 않습니다. 검토할 출력이 너무 많다면, 변경분을 필요한 범위로 줄이는 것이 가장 효과적인 조정일 때가 많습니다.

실패 후에도 성공한 작업 결과 유지하기 #

Lingo.dev 처리 경로는 큰 페이로드를 청크로 나누며, 모든 작업이 끝나기 전에도 반환된 청크를 기록할 수 있습니다. 한 작업이 실패하는 동안 다른 작업은 완료될 수도 있습니다. 변경 내역을 보존하고 실패한 로캘과 파일을 파악한 뒤, 프로젝트 전체를 강제 실행하기 전에 해당 범위만 다시 시도하세요.

대상 로캘이나 특정 키로 범위를 제한한 출력은 기존 소스 체크섬 기준을 갱신하지 않습니다. 기준 확정은 신중하게 진행하세요. 대상에 쓰기가 완료되었다고 해서 모든 로캘이 최신 상태라는 뜻은 아닙니다.

파일별 입출력 조정은 한 번의 실행 안에서 공유 파일에 대한 쓰기를 순차적으로 처리합니다. 하지만 다른 CLI 프로세스나 편집기가 같은 파일에 쓰는 것까지 막지는 못합니다. 동일한 설정과 Lockfile을 사용하는 실행이 서로 충돌하지 않도록 하세요. 취소해도 이전 내용은 복원되지 않으며, 재시도 전 삭제는 데이터를 지우는 별도의 결정입니다.