Bazel을 사용하여 프로그램 빌드

문제 신고 소스 보기

이 페이지에서는 Bazel을 사용하여 프로그램을 빌드하는 방법, 명령어 문법을 빌드하는 방법, 대상 패턴 문법을 설명합니다.

빠른 시작

Bazel을 실행하려면 기본 workspace 디렉터리 또는 하위 디렉터리로 이동하여 bazel를 입력합니다. 새 작업공간을 만들어야 하면 build를 참고하세요.

bazel help
                             [Bazel release bazel version]
Usage: bazel command options ...

사용 가능한 명령어

  • analyze-profile: 빌드 프로필 데이터를 분석합니다.
  • aquery: 사후 분석 작업 그래프에 대해 쿼리를 실행합니다.
  • build: 지정된 타겟을 빌드합니다.
  • canonicalize-flags: Bazel 플래그를 표준화합니다.
  • clean: 출력 파일을 삭제하고 선택적으로 서버를 중지합니다.
  • cquery: 사후 분석 종속 항목 그래프 쿼리를 실행합니다.
  • dump: Bazel 서버 프로세스의 내부 상태를 덤프합니다.
  • help: 명령어 또는 색인에 관한 도움말을 출력합니다.
  • info: bazel 서버에 대한 런타임 정보를 표시합니다.
  • fetch: 대상의 모든 외부 종속 항목을 가져옵니다.
  • mobile-install: 휴대기기에 앱을 설치합니다.
  • query: 종속 항목 그래프 쿼리를 실행합니다.
  • run: 지정된 타겟을 실행합니다.
  • shutdown: Bazel 서버를 중지합니다.
  • test: 지정된 테스트 타겟을 빌드하고 실행합니다.
  • version: Bazel의 버전 정보를 출력합니다.

지원 받기

  • bazel help command: command의 도움말과 옵션을 출력합니다.
  • bazel helpstartup_options: Bazel을 호스팅하는 JVM의 옵션입니다.
  • bazel helptarget-syntax: 타겟을 지정하는 구문을 설명합니다.
  • bazel help info-keys: info 명령어에 사용되는 키 목록을 표시합니다.

bazel 도구는 명령어라는 다양한 기능을 실행합니다. 가장 일반적으로 사용되는 것은 bazel buildbazel test입니다. bazel help를 사용하여 온라인 도움말 메시지를 찾아볼 수 있습니다.

단일 타겟 구축

빌드를 시작하려면 작업공간이 필요합니다. 작업공간은 애플리케이션을 빌드하는 데 필요한 모든 소스 파일이 포함된 디렉터리 트리입니다. Bazel을 사용하면 완전한 읽기 전용 볼륨에서 빌드를 수행할 수 있습니다.

Bazel을 사용하여 프로그램을 빌드하려면 bazel build를 입력한 다음 빌드할 target을 입력합니다.

bazel build //foo

명령어를 실행하여 //foo를 빌드하면 다음과 비슷한 출력이 표시됩니다.

INFO: Analyzed target //foo:foo (14 packages loaded, 48 targets configured).
INFO: Found 1 target...
Target //foo:foo up-to-date:
  bazel-bin/foo/foo
INFO: Elapsed time: 9.905s, Critical Path: 3.25s
INFO: Build completed successfully, 6 total actions

먼저 Bazel이 대상의 종속 항목 그래프에 있는 모든 패키지를 로드합니다. 여기에는 타겟의 BUILD 파일에 직접 나열된 선언된 종속 항목과 타겟 종속 항목의 BUILD 파일에 나열된 전이 종속 항목이 포함됩니다. 모든 종속 항목을 식별한 후 Bazel은 종속 항목이 정확한지 분석하고 빌드 작업을 만듭니다. 마지막으로 Bazel은 빌드의 컴파일러와 기타 도구를 실행합니다.

빌드 실행 단계에서 Bazel은 진행 메시지를 출력합니다. 진행률 메시지에는 시작할 때 현재 빌드 단계 (예: 컴파일러 또는 링커)와 총 빌드 작업 수 동안 완료된 횟수가 포함됩니다. 빌드가 시작될 때 Bazel이 전체 작업 그래프를 발견함에 따라 총 작업 수가 증가하는 경우가 많지만, 몇 초 내에 숫자가 안정화됩니다.

빌드가 끝나면 Bazel은 요청된 대상이 무엇인지, 성공적으로 빌드되었는지 여부와 관계없이 출력 파일을 찾을 수 있는 위치를 출력합니다. 빌드를 실행하는 스크립트는 이 출력을 안정적으로 파싱할 수 있습니다. 자세한 내용은 --show_result를 참고하세요.

같은 명령어를 다시 입력하면 빌드가 훨씬 빨리 완료됩니다.

bazel build //foo
INFO: Analyzed target //foo:foo (0 packages loaded, 0 targets configured).
INFO: Found 1 target...
Target //foo:foo up-to-date:
  bazel-bin/foo/foo
INFO: Elapsed time: 0.144s, Critical Path: 0.00s
INFO: Build completed successfully, 1 total action

null build입니다. 변경사항이 없으므로 새로고침할 패키지도 없고 실행할 빌드 단계도 없습니다. 'foo' 또는 종속 항목에 변경사항이 있는 경우 Bazel은 일부 빌드 작업을 다시 실행하거나 증분 빌드를 완료합니다.

여러 타겟 빌드

Bazel을 사용하면 빌드할 대상을 지정할 수 있는 여러 가지 방법이 있습니다. 이러한 패턴을 총칭하여 타겟 패턴이라고 합니다. 이 구문은 build, test, query와 같은 명령어에 사용됩니다.

라벨BUILD 파일에 종속 항목을 선언하는 경우와 같이 개별 대상을 지정하는 데 사용되는 반면 Bazel의 대상 패턴은 여러 대상을 지정합니다. 타겟 패턴은 와일드 카드를 사용하여 대상 세트의 라벨 문법을 일반화한 것입니다. 가장 간단한 경우, 모든 유효한 라벨은 정확히 하나의 대상 집합을 식별하는 유효한 대상 패턴이기도 합니다.

//로 시작하는 모든 타겟 패턴은 현재 작업공간을 기준으로 확인됩니다.

//foo/bar:wiz 단일 타겟 //foo/bar:wiz만 있습니다.
//foo/bar //foo/bar:bar과 같습니다.
//foo/bar:all foo/bar 패키지의 모든 규칙 대상입니다.
//foo/... foo 디렉터리 아래에 있는 모든 패키지의 모든 규칙 대상입니다.
//foo/...:all foo 디렉터리 아래에 있는 모든 패키지의 모든 규칙 대상입니다.
//foo/...:* foo 디렉터리 아래 모든 패키지의 모든 대상 (규칙 및 파일)
//foo/...:all-targets foo 디렉터리 아래 모든 패키지의 모든 대상 (규칙 및 파일)
//... 기본 저장소의 패키지에 있는 모든 규칙 대상입니다. 외부 저장소의 대상은 포함되지 않습니다.
//:all 작업공간의 루트에 `BUILD` 파일이 있는 경우 최상위 패키지의 모든 규칙 대상

//로 시작하지 않는 타겟 패턴은 현재 작업 디렉터리를 기준으로 확인됩니다. 다음 예에서는 foo의 작업 디렉터리를 가정합니다.

:foo //foo:foo와 같습니다.
bar:wiz //foo/bar:wiz과 같습니다.
bar/wiz 다음과 동일합니다.
  • foo/bar/wiz가 패키지인 경우 //foo/bar/wiz:wiz
  • foo/bar가 패키지인 경우 //foo/bar:wiz
  • 그렇지 않은 경우 //foo:bar/wiz
bar:all //foo/bar:all와 같습니다.
:all //foo:all와 같습니다.
...:all //foo/...:all와 같습니다.
... //foo/...:all와 같습니다.
bar/...:all //foo/bar/...:all와 같습니다.

기본적으로 작업공간의 루트 디렉터리에 생성되는 편의 심볼릭 링크와 같이 출력 베이스 아래를 가리키는 경우를 제외하고 재귀 타겟 패턴의 경우 디렉터리 심볼릭 링크가 뒤따릅니다.

또한 Bazel은 DONT_FOLLOW_SYMLINKS_WHEN_TRAVERSING_THIS_DIRECTORY_VIA_A_RECURSIVE_TARGET_PATTERN와 같은 파일이 포함된 디렉터리에서 재귀 대상 패턴을 평가할 때 심볼릭 링크를 따르지 않습니다.

foo/...packages의 와일드 카드이며, foo 디렉터리 아래의 모든 패키지 (패키지 경로의 모든 루트에 해당)를 재귀적으로 나타냅니다. :all대상에 대한 와일드 카드이며, 패키지 내의 모든 규칙과 일치합니다. 이 두 가지는 foo/...:all에서와 같이 조합될 수 있으며, 두 와일드 카드를 모두 사용할 경우 foo/...로 축약될 수 있습니다.

또한 :*(또는 :all-targets)는 일치하는 패키지의 모든 대상과 일치하는 와일드 카드입니다. 여기에는 일반적으로 어떤 규칙에 의해도 빌드되지 않은 파일(예: java_binary 규칙과 연결된 _deploy.jar 파일)도 포함됩니다.

이는 :*:all상위 집합을 나타냄을 의미합니다. 혼동될 수도 있지만 이 구문을 사용하면 _deploy.jar와 같은 빌드 타겟이 바람직하지 않은 일반적인 빌드에 익숙한 :all 와일드 카드를 사용할 수 있습니다.

또한 Bazel을 사용하면 라벨 구문에 필요한 콜론 대신 슬래시를 사용할 수 있습니다. 이는 Bash 파일 이름 확장을 사용할 때 편리할 때가 많습니다. 예를 들어 foo/bar/wiz//foo/bar:wiz (foo/bar 패키지가 있는 경우) 또는 //foo:bar/wiz (foo 패키지가 있는 경우)와 동일합니다.

많은 Bazel 명령어는 대상 패턴 목록을 인수로 허용하며 모두 프리픽스 부정 연산자 -를 따릅니다. 이는 앞의 인수로 지정된 집합에서 대상 집합을 빼는 데 사용할 수 있습니다. 즉, 순서가 중요합니다. 예를 들면 다음과 같습니다.

bazel build foo/... bar/...

'foo bar 아래 모든 대상을 빌드'하는 반면

bazel build -- foo/... -foo/bar/...

이는 'foo/bar 아래 인수를 제외foo 아래의 모든 대상을 빌드한다는 의미입니다. -으로 시작하는 후속 인수가 추가 옵션으로 해석되지 않도록 하려면 -- 인수가 필요합니다.

다만 이 방법으로 대상을 빼는 것이 빼지 않은 대상의 종속 항목일 수 있으므로 대상이 빌드되지 않는다고 보장할 수 없다는 점에 유의해야 합니다. 예를 들어 여러 항목 중에서 //foo/bar:api에 종속된 타겟 //foo:all-apis가 있는 경우 후자는 전자의 빌드의 일부로 빌드됩니다.

tags = ["manual"]가 있는 대상은 bazel buildbazel test과 같은 명령어에 지정된 경우 와일드 카드 대상 패턴(..., :*, :all 등)에 포함되지 않습니다 (다만 음성 와일드 카드 대상 패턴에는 포함되므로 제외됨). Bazel이 빌드/테스트하도록 하려면 명령줄에서 명시적인 대상 패턴을 사용하여 이러한 테스트 대상을 지정해야 합니다. 반면에 bazel query는 이러한 필터링을 자동으로 실행하지 않습니다 (이렇게 하면 bazel query의 목적을 무효화).

외부 종속 항목 가져오기

기본적으로 Bazel은 빌드 중에 외부 종속 항목을 다운로드하고 심볼릭 링크로 연결합니다. 하지만 새로운 외부 종속 항목이 추가되는 시기를 알고 싶거나 종속 항목을 '미리 가져오기'(예: 오프라인 상태가 될 비행 전)하기 때문에 바람직하지 않을 수 있습니다. 빌드 중에 새 종속 항목이 추가되지 않도록 하려면 --fetch=false 플래그를 지정하면 됩니다. 이 플래그는 로컬 파일 시스템의 디렉터리를 가리키지 않는 저장소 규칙에만 적용됩니다. 예를 들어 local_repository, new_local_repository, Android SDK, NDK 저장소 규칙의 변경사항은 --fetch 값과 관계없이 항상 적용됩니다 .

빌드 중에 가져오기를 허용하지 않고 Bazel이 새로운 외부 종속 항목을 발견하면 빌드가 실패합니다.

bazel fetch를 실행하여 종속 항목을 수동으로 가져올 수 있습니다. 빌드 중에 가져오기를 허용하지 않으면 bazel fetch를 실행해야 합니다.

  • 처음으로 빌드하기 전
  • 새 외부 종속 항목을 추가한 후

한 번 실행한 후에는 WORKSPACE 파일이 변경될 때까지 다시 실행할 필요가 없습니다.

fetch는 종속 항목을 가져올 대상 목록을 가져옵니다. 예를 들어 이 명령어는 //foo:bar//bar:baz를 빌드하는 데 필요한 종속 항목을 가져옵니다.

bazel fetch //foo:bar //bar:baz

작업공간의 모든 외부 종속 항목을 가져오려면 다음을 실행합니다.

bazel fetch //...

Bazel 7 이상에서 Bzlmod가 사용 설정된 경우 다음을 실행하여 모든 외부 종속 항목을 가져올 수도 있습니다.

bazel fetch

사용 중인 모든 도구 (라이브러리 jar에서 JDK 자체에 이르기까지)가 작업공간 루트에 있는 경우 bazel 가져오기를 실행할 필요가 없습니다. 그러나 작업공간 디렉터리 이외의 항목을 사용하는 경우 bazel build를 실행하기 전에 Bazel이 자동으로 bazel fetch를 실행합니다.

저장소 캐시

Bazel은 동일한 파일이 다른 작업공간에서 필요하거나 외부 저장소의 정의가 변경되었지만 여전히 동일한 파일을 다운로드해야 하는 경우에도 동일한 파일을 여러 번 가져오지 않으려고 합니다. 이를 위해 bazel은 저장소 캐시에 다운로드된 모든 파일을 캐시합니다(기본적으로 ~/.cache/bazel/_bazel_$USER/cache/repos/v1/에 있음). 위치는 --repository_cache 옵션을 통해 변경할 수 있습니다. 캐시는 모든 작업공간과 설치된 bazel 버전 간에 공유됩니다. Bazel이 올바른 파일의 사본이 있음을 알고 있는 경우, 즉 다운로드 요청에 지정된 파일의 SHA256 합계가 있고 이 해시가 있는 파일이 캐시에 있는 경우 캐시에서 항목을 가져옵니다. 따라서 각 외부 파일에 해시를 지정하는 것은 보안 측면에서도 좋은 방법일 뿐만 아니라 불필요한 다운로드를 방지하는 데도 도움이 됩니다.

캐시에 적중할 때마다 캐시의 파일 수정 시간이 업데이트됩니다. 이런 식으로 캐시 디렉터리에서 파일이 마지막으로 사용된 부분을 쉽게 확인할 수 있습니다(예: 캐시를 수동으로 정리). 캐시는 더 이상 업스트림에서 사용할 수 없는 파일의 사본을 포함할 수 있으므로 자동으로 삭제되지 않습니다.

[지원 중단됨] 배포 파일 디렉터리

지원 중단됨: 오프라인 빌드를 위해서는 저장소 캐시를 사용하는 것이 좋습니다.

배포 디렉터리는 불필요한 다운로드를 방지하기 위한 또 다른 Bazel 메커니즘입니다. Bazel이 저장소 캐시 전에 배포 디렉터리를 검색합니다. 주요 차이점은 배포 디렉터리에 수동 준비가 필요하다는 점입니다.

--distdir=/path/to-directory 옵션을 사용하면 파일을 가져오는 대신 추가로 찾기 위한 읽기 전용 디렉터리를 추가로 지정할 수 있습니다. 파일 이름이 URL의 기본 이름과 같고 추가로 파일의 해시가 다운로드 요청에 지정된 것과 동일한 경우 이러한 디렉터리에서 파일을 가져옵니다. 이는 파일 해시가 WORKSPACE 선언에 지정된 경우에만 작동합니다.

정확성을 위해 파일 이름에 대한 조건이 필요하지는 않지만 후보 파일 수를 지정된 디렉터리당 1개로 줄입니다. 이렇게 하면 디렉터리의 파일 수가 증가하더라도 배포 파일 디렉터리를 지정하는 것이 효율적입니다.

에어갭 환경에서 Bazel 실행

Bazel의 바이너리 크기를 작게 유지하기 위해 처음 실행되는 동안 Bazel의 암시적 종속 항목을 네트워크를 통해 가져옵니다. 이러한 암시적 종속 항목에는 모든 사람에게 필요하지는 않은 도구 모음과 규칙이 포함됩니다. 예를 들어 Android 도구는 Android 프로젝트를 빌드할 때만 번들로 묶이지 않고 가져옵니다.

하지만 모든 외부 종속 항목을 벤더링했더라도 이러한 암시적 종속 항목으로 인해 에어게이트 환경에서 Bazel을 실행할 때 문제가 발생할 수 있습니다. 이 문제를 해결하려면 네트워크 액세스가 가능한 머신에서 이러한 종속 항목을 포함하는 저장소 캐시 (Bazel 7 이상 사용) 또는 배포 디렉터리 (7 이전 버전의 Bazel 포함)를 준비한 다음 오프라인 접근 방식을 사용하여 이 종속 항목을 방송된 환경으로 전송하면 됩니다.

저장소 캐시 (Bazel 7 이상 사용)

저장소 캐시를 준비하려면 --repository_cache 플래그를 사용합니다. 암시적 종속 항목은 출시마다 다를 수 있으므로 새로운 Bazel 바이너리 버전마다 이 작업을 한 번씩 수행해야 합니다.

에어갭 환경 외부에서 이러한 종속 항목을 가져오려면 먼저 빈 작업공간을 만듭니다.

mkdir empty_workspace && cd empty_workspace
touch MODULE.bazel
touch WORKSPACE

내장된 Bzlmod 종속 항목을 가져오려면 다음을 실행합니다.

bazel fetch --repository_cache="path/to/repository/cache"

기존 WORKSPACE 파일을 계속 사용하는 경우 기본 제공 WORKSPACE 종속 항목을 가져오려면 다음을 실행합니다.

bazel sync --repository_cache="path/to/repository/cache"

마지막으로 에어게이트 환경에서 Bazel을 사용할 때 동일한 --repository_cache 플래그를 전달합니다. 편의상 .bazelrc 항목으로 추가할 수 있습니다.

common --repository_cache="path/to/repository/cache"

또한 Bazel이 인터넷을 통해 BCR에 액세스하지 못하도록 하려면 BCR을 로컬에서 클론하고 --registry 플래그를 사용하여 로컬 사본을 가리켜야 할 수도 있습니다. .bazelrc에 다음 줄을 추가합니다.

common --registry="path/to/local/bcr/registry"
배포 디렉터리 (Bazel 이전 7 사용)

배포 디렉터리를 준비하려면 --distdir 플래그를 사용합니다. 암시적 종속 항목은 출시마다 다를 수 있으므로 새로운 Bazel 바이너리 버전마다 이 작업을 한 번씩 수행해야 합니다.

에어갭 환경 외부에서 이러한 종속 항목을 빌드하려면 먼저 올바른 버전에서 Bazel 소스 트리를 체크아웃합니다.

git clone https://github.com/bazelbuild/bazel "$BAZEL_DIR"
cd "$BAZEL_DIR"
git checkout "$BAZEL_VERSION"

그런 다음 특정 Bazel 버전의 암시적 런타임 종속 항목이 포함된 tarball을 빌드합니다.

bazel build @additional_distfiles//:archives.tar

이 tarball을 에어게이트 환경에 복사할 수 있는 디렉터리로 내보냅니다. --strip-components 플래그에 유의하세요. 디렉터리 중첩 수준이 있으면 --distdir가 상당히 세심할 수 있기 때문입니다.

tar xvf bazel-bin/external/additional_distfiles/archives.tar \
  -C "$NEW_DIRECTORY" --strip-components=3

마지막으로 에어게이트 환경에서 Bazel을 사용할 때 디렉터리를 가리키는 --distdir 플래그를 전달합니다. 편의상 .bazelrc 항목으로 추가할 수 있습니다.

build --distdir=path/to/directory

빌드 구성 및 크로스 컴파일

특정 빌드의 동작과 결과를 지정하는 모든 입력은 두 개의 서로 다른 카테고리로 나눌 수 있습니다. 첫 번째 종류는 프로젝트의 BUILD 파일에 저장된 고유 정보, 즉 빌드 규칙, 속성의 값, 전이 종속 항목의 전체 집합입니다. 두 번째 종류는 사용자 또는 빌드 도구가 제공하는 외부 또는 환경 데이터입니다. 대상 아키텍처, 컴파일 및 링크 옵션, 기타 도구 모음 구성 옵션 선택이 가능합니다. 전체 환경 데이터의 집합을 구성이라고 합니다.

특정 빌드에는 구성이 두 개 이상 있을 수 있습니다. 64비트 아키텍처용으로 //foo:bin 실행 파일을 빌드하지만 워크스테이션이 32비트 시스템인 크로스 컴파일을 생각해 보세요. 빌드하려면 64비트 실행 파일을 만들 수 있는 도구 모음을 사용하여 //foo:bin를 빌드해야 하지만 빌드 시스템은 빌드 자체 중에 사용되는 다양한 도구도 빌드해야 합니다(예: 소스에서 빌드된 후 genrule에 사용되는 도구). 이러한 도구는 워크스테이션에서 실행되도록 빌드되어야 합니다. 따라서 두 가지 구성을 식별할 수 있습니다. 하나는 빌드 중에 실행되는 도구를 빌드하는 데 사용되는 exec 구성이고, 다른 하나는 타겟 구성(또는 요청 구성)이고, 이 단어에는 이미 많은 의미가 있지만 '타겟 구성'이라고 더 자주 언급됩니다. 이 단어는 궁극적으로 요청된 바이너리를 빌드하는 데 사용됩니다.

일반적으로 요청된 빌드 대상(//foo:bin)과 하나 이상의 exec 도구(예: 일부 기본 라이브러리) 모두의 기본 요건인 라이브러리가 많습니다. 이러한 라이브러리는 실행 구성용으로 한 번, 타겟 구성용으로 한 번, 이렇게 두 번 빌드해야 합니다. Bazel은 간섭을 방지하기 위해 두 변형이 모두 빌드되고 파생된 파일이 별도로 보관되도록 합니다. 일반적으로 이러한 타겟은 서로 독립적이기 때문에 동시에 빌드할 수 있습니다. 특정 대상이 두 번 빌드되고 있음을 나타내는 진행률 메시지가 표시되는 경우 이 설명일 가능성이 높습니다.

exec 구성은 다음과 같이 대상 구성에서 파생됩니다.

  • --host_crosstool_top가 지정되지 않은 경우 요청 구성에 지정된 것과 동일한 버전의 Crosstool (--crosstool_top)을 사용합니다.
  • --cpu--host_cpu 값을 사용합니다 (기본값: k8).
  • 요청 구성에 지정된 것과 동일한 옵션 값(--compiler, --use_ijars)을 사용합니다. --host_crosstool_top가 사용되는 경우 --host_cpu의 값을 사용하여 Crosstool에서 exec 구성의 default_toolchain를 찾습니다(--compiler 무시).
  • --javabase--host_javabase 값 사용
  • --java_toolchain--host_java_toolchain 값 사용
  • C++ 코드에 최적화된 빌드를 사용합니다 (-c opt).
  • 디버깅 정보를 생성하지 않습니다 (--copt=-g0).
  • 실행 파일 및 공유 라이브러리에서 디버그 정보를 제거합니다(--strip=always).
  • 파생된 모든 파일을 가능한 요청 구성에서 사용하는 파일과 다른 특별한 위치에 배치합니다.
  • 빌드 데이터로 바이너리 스탬핑을 억제합니다 (--embed_* 옵션 참고).
  • 다른 모든 값은 기본값으로 유지됩니다.

요청 구성에서 고유한 exec 구성을 선택하는 것이 더 좋은 이유는 여러 가지가 있습니다. 가장 중요한 점은 다음과 같습니다.

첫째, 제거되고 최적화된 바이너리를 사용하면 도구를 연결하고 실행하는 데 소요되는 시간, 도구가 차지하는 디스크 공간 및 분산 빌드의 네트워크 I/O 시간을 줄일 수 있습니다.

둘째, 모든 빌드에서 exec 및 요청 구성을 분리하면 앞에서 설명한 것처럼 요청 구성의 사소한 변경으로 인해 발생하는 매우 높은 비용의 재빌드를 피할 수 있습니다 (예: 링커 옵션 변경).

증분 재빌드 수정

Bazel 프로젝트의 주요 목표 중 하나는 올바른 증분 재빌드를 보장하는 것입니다. 이전 빌드 도구, 특히 Make에 기반한 빌드 도구는 증분 빌드 구현에 여러 가지 불리한 가정을 합니다.

첫째, 파일의 타임스탬프가 일정하게 증가합니다. 이는 전형적인 경우이지만 이러한 가정을 위반하기는 매우 쉽습니다. 파일의 이전 버전에 동기화하면 해당 파일의 수정 시간이 단축됩니다. Make 기반 시스템은 다시 빌드되지 않습니다.

일반적으로 Make는 파일 변경사항을 감지하지만 명령어 변경사항은 감지하지 못합니다. 주어진 빌드 단계에서 컴파일러에 전달된 옵션을 변경하면 Make는 컴파일러를 다시 실행하지 않으므로 make clean를 사용하여 이전 빌드의 잘못된 출력을 수동으로 삭제해야 합니다.

또한 Make는 하위 프로세스가 출력 파일에 쓰기를 시작한 후 하위 프로세스 중 하나가 종료되지 못하더라도 견고하지 않습니다. 현재 Make 실행은 실패하지만 Make의 후속 호출은 잘린 출력 파일이 유효하다고 맹목적으로 가정하고 (입력보다 최신이기 때문에) 다시 빌드되지 않습니다. 마찬가지로 Make 프로세스가 종료되면 비슷한 상황이 발생할 수 있습니다.

Bazel은 이러한 가정 등을 피합니다. Bazel은 이전에 수행된 모든 작업의 데이터베이스를 유지 관리하고 해당 빌드 단계에 대한 입력 파일 세트 (및 타임스탬프)와 이 빌드 단계에 대한 컴파일 명령어가 데이터베이스의 출력 파일과 정확하게 일치하고 데이터베이스 항목의 출력 파일 세트 (및 타임스탬프)가 디스크에 있는 파일의 타임스탬프와 정확히 일치하는 경우에만 빌드 단계를 생략합니다. 입력 파일이나 출력 파일 또는 명령어 자체가 변경되면 빌드 단계가 다시 실행됩니다.

올바른 증분 빌드를 사용하면 혼동으로 인한 시간 낭비가 줄어들 수 있다는 이점이 있습니다. 또한 필요한 경우든 선제적이든 make clean 사용으로 인한 재빌드를 기다리는 시간도 줄어듭니다.

빌드 일관성 및 증분 빌드

예상되는 모든 출력 파일이 존재하고 파일 생성에 필요한 단계나 규칙에 지정된 대로 콘텐츠가 올바르면 빌드의 상태를 일관성으로 정의합니다. 소스 파일을 수정하면 빌드 상태가 일관되지 않은 상태라고 말하며, 다음번 빌드 도구를 실행하여 성공적으로 완료될 때까지 일관되지 않은 상태로 유지됩니다. Google에서는 이러한 상황을 불안정한 비일관성이라고 설명합니다. 왜냐하면 이 상황은 일시적이며 빌드 도구를 실행하면 일관성이 복원되기 때문입니다.

치명적인 또 다른 종류의 불일치는 안정적인 비일관성입니다. 빌드가 안정적으로 일관되지 않은 상태에 도달하면 빌드 도구를 반복적으로 호출해도 일관성이 복원되지 않습니다. 빌드가 '중단'되어 출력이 올바르지 않은 상태로 유지됩니다. 일관되지 않은 상태는 Make 사용자가 make clean 및 기타 빌드 도구를 사용하는 주된 이유입니다. 빌드 도구가 이러한 방식으로 실패한 것을 발견하고 이를 복구하려면 시간이 오래 걸리고 짜증이 날 수 있습니다.

개념적으로 일관된 빌드를 달성하는 가장 간단한 방법은 이전의 모든 빌드 출력을 버리고 다시 시작하는 것입니다. 즉, 모든 빌드를 깔끔한 빌드로 만듭니다. 이 접근 방식은 (출시 엔지니어를 제외하고) 실용적이기에는 시간이 너무 오래 걸립니다. 따라서 유용하려면 빌드 도구가 일관성을 저해하지 않고 증분 빌드를 실행할 수 있어야 합니다.

증분 종속 항목 분석을 수정하는 것은 어려우며 위에서 설명한 것처럼 다른 많은 빌드 도구는 증분 빌드 중에 안정적인 비일관성 상태를 방지하지 못합니다. 반면, Bazel은 수정 없이 빌드 도구를 성공적으로 호출한 후에는 빌드가 일관적인 상태가 된다는 보장을 제공합니다. 빌드 중에 소스 파일을 수정하는 경우 Bazel은 현재 빌드 결과의 일관성을 보장하지 않습니다. 하지만 이렇게 하면 다음 빌드의 결과가 일관성을 복원할 수 있습니다.)

모든 보장과 마찬가지로 작은 글씨가 있습니다. Bazel을 사용하여 안정적이고 일관되지 않은 상태가 되는 몇 가지 알려진 방법이 있습니다. Google에서는 증분 종속 항목 분석에서 버그를 찾으려는 의도적인 시도로 인해 발생하는 이러한 문제를 조사한다고 보장하지는 않지만, 빌드 도구를 정상적 또는 '합리적'으로 사용할 때 발생하는 안정적이고 일관되지 않은 모든 상태를 모두 조사하고 해결하기 위해 최선을 다할 것입니다.

Bazel에서 안정된 불일치 상태가 발견되면 버그를 신고하세요.

샌드박스 실행

Bazel은 샌드박스를 사용하여 작업이 밀폐되고 올바르게 실행되도록 보장합니다. Bazel은 도구가 작업을 실행하는 데 필요한 최소한의 파일 집합만 포함된 샌드박스에서 spawns (대략적으로 설명)를 실행합니다. 현재 샌드박스는 CONFIG_USER_NS 옵션이 사용 설정된 Linux 3.12 이상과 macOS 10.11 이상에서 작동합니다.

Bazel은 시스템이 샌드박스를 지원하지 않으면 빌드가 밀폐성을 보장하지 않으며 알 수 없는 방식으로 호스트 시스템에 영향을 미칠 수 있음을 경고하는 경고를 출력합니다. 이 경고를 사용 중지하려면 --ignore_unsupported_sandboxing 플래그를 Bazel에 전달하면 됩니다.

Google Kubernetes Engine 클러스터 노드 또는 Debian과 같은 일부 플랫폼에서는 보안 문제로 인해 기본적으로 사용자 네임스페이스가 비활성화됩니다. 이는 /proc/sys/kernel/unprivileged_userns_clone 파일을 살펴보면 확인할 수 있습니다. 이 파일이 존재하고 0이 포함되어 있으면 sudo sysctl kernel.unprivileged_userns_clone=1를 사용하여 사용자 네임스페이스를 활성화할 수 있습니다.

경우에 따라 시스템 설정으로 인해 Bazel 샌드박스가 규칙을 실행하지 못합니다. 일반적으로 증상은 namespace-sandbox.c:633: execvp(argv[0], argv): No such file or directory와 유사한 메시지를 출력하는 장애입니다. 이 경우 --strategy=Genrule=standalone가 있는 genrule과 --spawn_strategy=standalone가 있는 다른 규칙의 샌드박스를 비활성화해 보세요. 또한 Google에서 조사하여 후속 버전에서 수정사항을 제공할 수 있도록 Issue Tracker에서 버그를 신고하고 사용 중인 Linux 배포판을 알려주시기 바랍니다.

빌드 단계

Bazel에서 빌드는 세 단계로 이루어집니다. 사용자가 두 단계의 차이점을 이해하면 빌드를 제어하는 옵션에 관한 유용한 정보를 얻을 수 있습니다(아래 참조).

로드 단계

첫 번째는 로드하는 동안 초기 대상에 필요한 모든 BUILD 파일과 종속 항목의 전이적 닫힘을 로드, 파싱, 평가, 캐시합니다.

Bazel 서버가 시작된 후 첫 번째 빌드의 경우 로드 단계에는 일반적으로 많은 BUILD 파일이 파일 시스템에서 로드되므로 몇 초가 걸립니다. 후속 빌드에서는 특히 BUILD 파일이 변경되지 않은 경우 로드가 매우 빠르게 수행됩니다.

이 단계 중에 보고되는 오류에는 패키지를 찾을 수 없음, 대상을 찾을 수 없음, BUILD 파일의 어휘 및 문법 오류, 평가 오류가 포함됩니다.

분석 단계

두 번째 단계인 분석에는 각 빌드 규칙의 의미 체계 분석 및 유효성 검사, 빌드 종속 항목 그래프 구성, 빌드의 각 단계에서 실행할 작업을 정확하게 결정하는 작업이 포함됩니다.

로드와 마찬가지로 분석을 전체적으로 계산할 때도 몇 초가 걸립니다. 그러나 Bazel은 한 빌드에서 다음 빌드로 종속 항목 그래프를 캐시하고 필요한 항목만 재분석합니다. 따라서 이전 빌드 이후 패키지가 변경되지 않은 경우 증분 빌드를 매우 빠르게 할 수 있습니다.

이 단계에서 보고되는 오류에는 부적절한 종속 항목, 잘못된 규칙 입력, 모든 규칙별 오류 메시지가 포함됩니다.

Bazel이 이 단계에서 불필요한 파일 I/O를 피하고 수행할 작업을 결정하기 위해 BUILD 파일만 읽기 때문에 로드 및 분석 단계가 빠릅니다. 이는 의도적으로 설계된 것이며 Bazel은 로드 단계 위에 구현되는 Bazel의 query 명령어와 같은 분석 도구를 사용하기에 좋은 기반이 됩니다.

실행 단계

빌드의 세 번째이자 마지막 단계는 실행입니다. 이 단계에서는 빌드에 있는 각 단계의 출력이 입력과 일치하도록 보장하고, 필요에 따라 컴파일/연결 등의 도구를 다시 실행합니다. 대규모 빌드의 경우 빌드가 몇 초에서 1시간 이상에 걸쳐 대부분의 시간을 소비합니다. 이 단계에서 보고되는 오류에는 소스 파일 누락, 일부 빌드 작업에 의해 실행되는 도구의 오류, 예상 출력 세트를 생성하는 도구의 오류 등이 있습니다.