이 페이지는 Cloud Translation API를 통해 번역되었습니다.

출시 모델

원본 블로그 게시물에서 발표한 것처럼 Bazel 4.0 이상 버전은 순차적 출시와 장기 지원 (LTS) 출시라는 두 가지 출시 트랙을 지원합니다. 이 페이지에서는 Bazel의 출시 모델에 관한 최신 정보를 다룹니다.

출시 버전 관리

Bazel은 major.minor.patch 시맨틱 버전 관리 스키마를 사용합니다.

주 출시에는 이전 버전과 호환되지 않는 기능이 포함되어 있습니다. 각 Bazel 주 버전은 LTS 출시 버전입니다.
부 출시에는 이전 버전과 호환되는 버그 수정 및 기본 브랜치에서 백포트된 기능이 포함됩니다.
패치 출시에는 중요한 버그 수정이 포함되어 있습니다.

또한 출시 전 버전은 다음 주 버전 번호에 하이픈과 날짜 서픽스를 추가하여 표시합니다.

예를 들어 각 유형의 새 출시 버전은 다음과 같은 버전 번호를 갖게 됩니다.

메이저: 6.0.0
마이너: 6.1.0
패치: 6.1.2
출시 전 버전: 7.0.0-pre.20230502.1

지원 단계

Bazel 주 버전마다 4가지 지원 단계가 있습니다.

출시: 이 주 버전은 아직 출시 전 버전입니다. Bazel팀은 HEAD에서 순차적 출시를 게시합니다.
활성: 이 주 버전은 현재 활성 상태인 LTS 출시 버전입니다. Bazel팀은 중요 기능과 버그 수정을 부 출시 버전에 백포트합니다.
유지보수: 이 주 버전은 유지보수 모드의 이전 LTS 출시 버전입니다. Bazel팀은 보안 문제 및 OS 호환성 문제의 중요 버그 수정을 이 LTS 출시 버전으로 백포팅할 것을 약속합니다.
지원 중단됨: Bazel팀에서는 더 이상 이 주 버전에 대한 지원을 제공하지 않으므로 모든 사용자는 최신 Bazel LTS 출시 버전으로 이전해야 합니다.

출시 주기

Bazel은 두 가지 출시 트랙의 버전을 정기적으로 게시합니다.

순차적 출시

순차적 출시는 Google Blaze 출시와 협의되며 2주마다 HEAD에서 출시됩니다. 다음 Bazel LTS 출시 버전의 미리보기입니다.
순차적 출시에는 호환되지 않는 변경사항이 포함될 수 있습니다. 호환되지 않는 플래그는 주요 브레이킹 체인지에 사용하는 것이 좋습니다. 호환되지 않는 변경사항을 출시하려면 이전 버전과의 호환성 정책을 따라야 합니다.

LTS 출시 버전

주요 출시: 새로운 LTS 출시는 약 12개월마다 HEAD에서 잘릴 것으로 예상됩니다. 새 LTS 출시 버전이 출시되면 즉시 활성 단계에 진입하고 이전 LTS 출시가 유지보수 단계에 진입합니다.
부 출시: 활성 LTS 트랙의 새로운 마이너 버전은 2개월에 한 번 출시됩니다.
패치 출시: 활성 및 유지보수 단계의 LTS 출시에 대한 새 패치 버전은 중요한 버그 수정이 필요할 때 출시될 것으로 예상됩니다.
Bazel LTS 출시 버전은 2년 동안 유지보수 단계에 있었던 후 지원 중단됨 단계로 들어갑니다.

계획된 출시는 GitHub의 출시 문제를 확인하세요.

지원 매트릭스

LTS 출시 버전	지원 단계	최신 버전	지원 종료
Bazel 7	최근	GitHub 출시 페이지 확인	N/A
Bazel 6	활성	6.4.0	2025년 12월
Bazel 5	유지보수	5.4.1	2025년 1월
Bazel 4	유지보수	4.2.4	2024년 1월

모든 Bazel 출시 버전은 GitHub의 출시 페이지에서 확인할 수 있습니다.

출시 절차 및 정책

순차적 출시의 경우 프로세스는 간단합니다. 약 2주마다 Google 내부 Blaze 출시와 동일한 기준에 맞게 새로운 버전이 생성됩니다. 빠른 출시 일정으로 인해 순차적 출시로는 변경사항을 백포팅하지 않습니다.

LTS 버전의 경우 아래 절차와 정책을 따릅니다.

출시 버전의 기준 커밋을 결정합니다.
- 새로운 메이저 LTS 출시 버전의 경우 기준 커밋은 기본 브랜치의 HEAD입니다.
- 마이너 또는 패치 출시의 경우 기준 커밋은 동일한 LTS 버전의 현재 최신 버전 HEAD입니다.
기준 커밋에서 release-<version> 이름으로 출시 브랜치를 만듭니다.
PR을 통해 변경사항을 출시 브랜치로 백포팅합니다.
- 커뮤니티는 관련 GitHub 문제 또는 PR에 '@bazel-io flag'라고 응답하여 특정 커밋을 백포팅할 것을 제안할 수 있으며, 이를 통해 Bazel팀이 커밋을 분류하고 커밋을 백포팅할지 결정합니다.
- 기본 브랜치의 이전 버전과 호환되는 커밋만 백포팅할 수 있으며 병합 충돌을 해결하기 위한 추가적인 사소한 변경사항은 허용됩니다.
출시 버전을 차단하고 출시 브랜치에서 발견된 문제를 해결합니다.
- 출시 브랜치는 Bazel CI의 사후 제출 및 다운스트림 테스트 파이프라인에서 동일한 테스트 모음으로 테스트됩니다. Bazel팀은 출시 브랜치의 테스트 결과를 모니터링하고 발견된 회귀를 수정합니다.
알려진 모든 출시 차단기가 해결되면 출시 브랜치에서 새로운 출시 후보를 만듭니다.
- 출시 후보가 bazel-discuss에 발표되면 Bazel팀이 후보의 커뮤니티 버그 신고를 모니터링합니다.
- 새로운 출시 차단 프로그램이 식별되면 마지막 단계로 돌아가 모든 문제를 해결한 후 새 출시 후보를 만듭니다.
- 첫 번째 출시 후보가 생성된 후에는 출시 브랜치에 새로운 기능을 추가할 수 없습니다.
더 이상 출시 차단기가 발견되지 않으면 출시 후보를 공식 버전으로 푸시합니다.
- 패치 출시의 경우 마지막 출시 후보가 출시되고 나서 영업일 기준 최소 2일 후에 출시를 푸시합니다.
- 메이저 버전 및 부 버전의 경우 마지막 출시 후보가 출시되고 1주일 이후가 아니더라도 영업일 기준 2일 후에 버전을 푸시합니다.
- 출시는 다음날이 영업일인 경우에만 푸시됩니다.
- 이 출시는 bazel-discuss에서 발표되며 Bazel팀이 새 출시의 커뮤니티 버그 신고를 모니터링하고 해결합니다.

회귀 보고

사용자가 HEAD의 새로운 Bazel 출시 버전, 출시 후보 또는 Bazel에서 회귀를 발견하면 GitHub에서 버그를 신고하세요. Bazelisk를 사용하여 범인 커밋을 양분하고 이 정보를 버그 신고에 포함할 수 있습니다.

예를 들어 Bazel 6.1.0에서는 빌드가 성공했지만 두 번째 출시 후보 6.2.0에서는 빌드가 실패할 경우

bazelisk --bisect=6.1.0..release-6.2.0rc2 build //foo:bar

문제를 재현하는 데 필요한 경우 빌드 상태를 재설정하는 BAZELISK_SHUTDOWN 또는 BAZELISK_CLEAN 환경 변수를 설정하여 상응하는 bazel 명령어를 실행할 수 있습니다. 자세한 내용은 Bazelisk bisect 기능 문서를 참고하세요.

bisect 기능을 사용하려면 Bazelisk를 최신 버전으로 업그레이드해야 합니다.

규칙 호환성

규칙 작성자이고 다른 Bazel 버전과의 호환성을 유지하려는 경우 규칙 호환성 페이지를 확인하세요.