이 페이지에서는 로컬 실행 컨텍스트에서 캐시 누락을 조사하는 방법을 설명합니다.
이 페이지에서는 로컬에서 빌드가 성공적으로 완료되고 원격 캐싱을 활용하도록 설정된 빌드 또는 테스트가 있으며 원격 캐시가 효과적으로 활용되고 있는지 확인하려는 상황을 가정합니다.
캐시 적중률을 확인하는 방법과 두 Bazel 호출 간의 실행 로그를 비교하는 방법에 관한 도움말은 원격 실행을 위한 원격 캐시 적중 디버깅을 참고하세요. 이 가이드에 설명된 모든 내용은 로컬 실행을 통한 원격 캐싱에도 적용됩니다. 하지만 로컬 실행에는 몇 가지 추가 문제가 있습니다.
캐시 적중률 확인
원격 캐시 적중 성공은 원격 실행을 통한 캐시 적중률과 마찬가지로 상태 줄에 표시됩니다.
Bazel 실행의 표준 출력에는 다음과 같은 내용이 표시됩니다.
INFO: 7 processes: 3 remote cache hit, 4 linux-sandbox.
즉, 시도한 7개의 작업 중 3개는 원격 캐시를 적중했고 4개 작업은 캐시를 적중하지 않아 linux-sandbox 전략을 사용하여 로컬에서 실행되었습니다. 이 요약에는 로컬 캐시 적중은 포함되지 않습니다. 프로세스가 0개이거나 예상보다 적은 경우 bazel clean 다음에 빌드/테스트 명령어를 실행합니다.
캐시 적중 문제 해결
예상한 캐시 적중률을 얻지 못하는 경우 다음을 실행합니다.
원격 엔드포인트와의 통신이 성공적으로 이루어졌는지 확인
빌드가 원격 캐시와 제대로 통신하는지 확인하려면 이 섹션의 단계를 따르세요.
출력에서 경고 확인
원격 실행을 사용하면 원격 엔드포인트와 통신하지 못하면 빌드가 실패합니다. 반면 캐시 가능한 로컬 빌드는 캐시할 수 없더라도 실패하지 않습니다. Bazel 호출의 출력에서 다음과 같은 경고를 확인합니다.
WARNING: Error reading from the remote cache:또는
WARNING: Error writing to the remote cache:이러한 경고 뒤에는 디버그하는 데 도움이 되는 연결 문제를 자세히 설명하는 오류 메시지가 표시됩니다(예: 잘못 입력된 엔드포인트 이름 또는 잘못 설정된 사용자 인증 정보). 이러한 오류를 찾아 해결합니다. 표시되는 오류 메시지에 충분한 정보가 포함되어 있지 않으면
--verbose_failures를 추가해 보세요.원격 실행의 캐시 히트 문제 해결의 단계에 따라 캐시 쓰기 Bazel 호출이 동일한 머신과 여러 머신에서 캐시 히트를 가져올 수 있는지 확인합니다.
캐시 읽기 Bazel 호출에서 캐시 적중을 가져올 수 있는지 확인합니다.
a. 캐시 읽기 Bazel 호출에는 다른 명령줄 설정이 있으므로 원격 캐시와 통신하도록 올바르게 설정되어 있는지 추가로 확인해야 합니다.
--remote_cache플래그가 설정되어 있고 출력에 경고가 없는지 확인합니다.b. 캐시 읽기 Bazel 호출이 캐시 쓰기 Bazel 호출과 동일한 타겟을 빌드하는지 확인합니다.
c. 머신 전반에서 캐싱을 보장하는 것과 동일한 단계를 따라 캐시 쓰기 Bazel 호출에서 캐시 읽기 Bazel 호출로의 캐싱을 보장합니다.