콘텐츠로 이동

Bazel 프로젝트

plaintext
Help me get started with Tuist. Follow the setup at:
https://tuist.dev/en/docs/guides/get-started/bazel-project

기존 Bazel 워크스페이스를 Tuist에 연결하려면 다음 단계를 따르세요. Tuist는 Bazel이 원격 캐시로 연결하는 Remote Execution API 캐시와, 모든 빌드 및 테스트를 대시보드에서 확인 가능한 데이터로 변환하는 Build Event Service 스트림을 제공합니다.

아래 각 섹션은 현재 부족한 부분을 설명하고, 그 격차를 채우는 기능을 안내합니다.

사전 요구 사항#

워크스페이스 연결#

Bazel 워크스페이스 루트에서 tuist init를 실행하세요. Tuist가 WORKSPACE / MODULE.bazel를 감지하고 Bazel 워크스페이스 통합 옵션을 제공합니다. 브라우저에서 인증한 후 프로젝트를 소유할 계정을 선택하세요.

bash
tuist init

코딩 에이전트나 스크립트로 진행하는 경우, 먼저 tuist auth login를 실행하세요(브라우저 흐름에서 Enter 키 입력을 기다립니다). 이후 비대화형 형식을 사용하세요:

bash
tuist init --build-system bazel --name <project-handle> --account <account>

init이 완료되면 Tuist는 다음 작업을 수행합니다:

  1. 프로젝트 핸들이 포함된 tuist.toml를 워크스페이스 루트에 작성합니다.
  2. .bazelrc 옆에 .bazelrc.tuist를 작성하며, 가장 가까운 Tuist 캐시 리전에 연결되고 워크스페이스별 자격 증명 헬퍼를 통해 인증됩니다.
  3. .bazelrc에 try-import %workspace%/.bazelrc.tuist 줄을 추가합니다.

try-import 줄을 커밋하세요. 모든 머신에서 동일합니다. .gitignore에 .bazelrc.tuist를 추가하세요. 자격 증명 헬퍼 경로는 사용자별이며 캐시 리전은 위치별이므로 공유해서는 안 됩니다.

워크스페이스가 연결되면 아래 모든 기능이 자동으로 활성화됩니다.

원격 캐시#

Bazel의 로컬 디스크 캐시는 ~/.cache/bazel 아래(또는 --disk_cache가 지정하는 위치)에 저장됩니다. 한 개발자의 머신에서 발생한 캐시 히트는 다른 사람에게 전달되지 않으며, CI 작업 컨테이너는 매 실행마다 빈 캐시에서 시작합니다.

Bazel의 Remote Execution API는 해당 캐시를 공유 엔드포인트로 확장하기 위한 프로토콜입니다. Tuist는 이 프로토콜을 지원합니다. .bazelrc.tuist가 적용되면 Bazel은 공유 캐시에 이미 존재하는 출력물을 가진 액션을 건너뛰고 대신 다운로드합니다. 한 머신의 작업 결과는 동일한 리비전을 빌드하는 다른 모든 머신에 도움이 됩니다.

동일한 리비전을 대상으로 두 번의 클린 빌드로 검증하세요(로컬에서, 또는 로컬 한 번 + CI 한 번):

bash
bazel clean
bazel build //...

두 번째 실행 요약에서 캐시 히트가 보고되어야 합니다. 대시보드에서 캐시를 열어 시간 경과에 따른 히트율을 확인하세요.

빌드 및 테스트 인사이트#

Bazel의 빌드 이벤트 스트림과 테스트별 XML 보고서는 호출마다 생성됩니다. 일주일 동안 타겟 수준의 지속 시간을 비교하거나 여러 CI 실행에서 불안정해진 테스트를 식별하려면 이러한 이벤트를 수집하고 집계해야 합니다.

Bazel이 이미 내보내는 Build Event Service 프로토콜은 바로 이런 용도로 설계되었습니다. tuist init가 작성한 .bazelrc.tuist가 Tuist 대상으로 BES 스트림을 구성하므로, 다음 bazel build 및 bazel test부터 빌드 및 테스트 인사이트가 흐르기 시작합니다. 추가 설정이 필요하지 않습니다. 대시보드에서 빌드 및 테스트를 열어 데이터를 확인하세요.

팀 참여 유도#

캐시 히트와 인사이트는 프로젝트에 연결된 인원 수에 따라 누적 효과가 발생합니다. 대시보드의 계정 설정에서 팀원을 조직에 초대하고, Single Sign-On(Google, Okta, Microsoft)을 설정하여 온보딩을 개인별 tuist auth login 대신 클릭 한 번으로 완료할 수 있도록 하세요.