빌드 이벤트 프로토콜

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
문제 신고 소스 보기

빌드 이벤트 프로토콜(BEP)을 사용하면 서드 파티 프로그램이 Bazel 호출에 대한 통계를 얻을 수 있습니다. 예를 들어 BEP를 사용하여 IDE 플러그인 또는 빌드 결과를 표시하는 대시보드에 대한 정보를 수집할 수 있습니다.

프로토콜은 일부 시맨틱이 정의된 프로토콜 버퍼 메시지 세트입니다. 여기에는 빌드 및 테스트 결과, 빌드 진행 상황, 빌드 구성 등에 관한 정보가 포함됩니다. BEP는 프로그래매틱 방식으로 소비하기 위한 것으로 Bazel의 명령줄 출력을 파싱하는 것은 과거의 일입니다.

빌드 이벤트 프로토콜은 빌드에 관한 정보를 이벤트로 나타냅니다. 빌드 이벤트는 빌드 이벤트 식별자, 하위 이벤트 식별자 집합, 페이로드로 구성된 프로토콜 버퍼 메시지입니다.

  • 빌드 이벤트 식별자: 빌드 이벤트의 종류에 따라 빌드 이벤트에 관해 좀 더 공개하는 불투명 문자열 또는 구조화된 정보일 수 있습니다. 빌드 이벤트 식별자는 빌드 내에서 고유합니다.

  • 하위 요소: 빌드 이벤트는 하위 필드에 빌드 이벤트 식별자를 포함하여 다른 빌드 이벤트를 알릴 수 있습니다. 예를 들어 PatternExpanded 빌드 이벤트는 하위 요소로 확장되는 타겟을 알려줍니다. 이 프로토콜은 첫 번째 이벤트를 제외한 모든 이벤트가 이전 이벤트에 의해 통지되도록 보장합니다.

  • 페이로드: 페이로드에는 빌드 이벤트에 관한 구조화된 정보가 포함되며 해당 이벤트와 관련된 프로토콜 버퍼 메시지로 인코딩됩니다. 페이로드는 예상 유형이 아닐 수 있지만 빌드가 조기에 중단되었다면 Aborted 메시지일 수 있습니다.

빌드 이벤트 그래프

모든 빌드 이벤트는 상위 및 하위 관계를 통해 방향성 비순환 그래프를 형성합니다. 초기 빌드 이벤트를 제외한 모든 빌드 이벤트에는 하나 이상의 상위 이벤트가 있습니다. 하위 이벤트의 모든 상위 이벤트를 반드시 게시해야 하는 것은 아닙니다. 빌드가 완료 (성공 또는 실패)되면 공지된 모든 이벤트가 게시됩니다. Bazel 비정상 종료나 네트워크 전송에 실패하면 일부 발표된 빌드 이벤트가 게시되지 않을 수 있습니다.

이벤트 그래프의 구조는 명령어의 수명 주기를 반영합니다. 모든 BEP 그래프의 특성은 다음과 같습니다.

  1. 루트 이벤트는 항상 BuildStarted 이벤트입니다. 다른 모든 이벤트는 그 하위 항목의 값입니다.
  2. BuildStarted 이벤트의 직계 하위 요소에는 명령어에 대한 메타데이터가 포함됩니다.
  3. 빌드된 파일 및 테스트 결과와 같이 명령어로 생성된 데이터가 포함된 이벤트는 BuildFinished 이벤트 앞에 표시됩니다.
  4. BuildFinished 이벤트 다음에 빌드에 관한 요약 정보 (예: 측정항목 또는 프로파일링 데이터)가 포함된 이벤트가 발생할 수 있습니다.

빌드 이벤트 프로토콜 사용

바이너리 형식으로 소비

BEP를 바이너리 형식으로 사용하려면 다음 안내를 따르세요.

  1. Bazel이 --build_event_binary_file=/path/to/file 옵션을 지정하여 프로토콜 버퍼 메시지를 파일로 직렬화하도록 합니다. 파일에는 직렬화된 프로토콜 버퍼 메시지가 포함되며 각 메시지는 길이가 구분됩니다. 각 메시지 앞에는 가변 길이 정수로 인코딩된 길이가 접두사로 추가됩니다. 이 형식은 프로토콜 버퍼 라이브러리의 parseDelimitedFrom(InputStream) 메서드를 사용하여 읽을 수 있습니다.

  2. 그런 다음 직렬화된 프로토콜 버퍼 메시지에서 관련 정보를 추출하는 프로그램을 작성합니다.

텍스트 또는 JSON 형식으로 소비

다음 Bazel 명령줄 플래그는 텍스트 및 JSON과 같이 사람이 읽을 수 있는 형식으로 BEP를 출력합니다.

--build_event_text_file
--build_event_json_file

빌드 이벤트 서비스

빌드 이벤트 서비스 프로토콜은 빌드 이벤트 게시를 위한 일반 gRPC 서비스입니다. 빌드 이벤트 서비스 프로토콜은 BEP와 별개이며 BEP 이벤트를 불투명한 바이트로 취급합니다. Bazel은 빌드 이벤트 프로토콜 이벤트를 게시하는 빌드 이벤트 서비스 프로토콜의 gRPC 클라이언트 구현과 함께 제공됩니다. --bes_backend=HOST:PORT 플래그를 사용하여 이벤트를 전송할 엔드포인트를 지정할 수 있습니다. 백엔드가 gRPC를 사용하는 경우 주소에 적절한 체계로 접두어를 붙여야 합니다. 일반 텍스트 gRPC는 grpc://, TLS가 사용 설정된 gRPC는 grpcs://입니다.

빌드 이벤트 서비스 플래그

Bazel에는 다음과 같은 빌드 이벤트 서비스 프로토콜과 관련된 여러 플래그가 있습니다.

  • --bes_backend
  • --[no]bes_best_effort
  • --[no]bes_lifecycle_events
  • --bes_results_url
  • --bes_timeout
  • --project_id

이러한 각 플래그에 대한 설명은 명령줄 참조를 참고하세요.

인증 및 보안

Bazel의 빌드 이벤트 서비스 구현도 인증과 TLS를 지원합니다. 이러한 설정은 아래 플래그를 사용하여 제어할 수 있습니다. 이 플래그는 Bazel의 원격 실행에도 사용됩니다. 이는 빌드 이벤트 서비스와 원격 실행 엔드포인트가 동일한 인증 및 TLS 인프라를 공유해야 함을 의미합니다.

  • --[no]google_default_credentials
  • --google_credentials
  • --google_auth_scopes
  • --tls_certificate
  • --[no]tls_enabled

이러한 각 플래그에 대한 설명은 명령줄 참조를 참고하세요.

빌드 이벤트 서비스 및 원격 캐싱

BEP에는 일반적으로 Bazel이 실행되는 머신에 저장된 로그 파일 (test.log, test.xml 등)에 대한 많은 참조가 포함되어 있습니다. 원격 BES 서버는 일반적으로 이러한 파일이 다른 머신에 있기 때문에 이러한 파일에 액세스할 수 없습니다. 이 문제를 해결하는 방법은 원격 캐싱에 Bazel을 사용하는 것입니다. Bazel이 원격 출력에 모든 출력 파일 (BEP에서 참조되는 파일 포함)을 업로드하면 BES 서버가 캐시에서 참조된 파일을 가져올 수 있습니다.

자세한 내용은 GitHub 문제 3689를 참고하세요.