Bazelisk를 사용하여 Bazel 설치 / 업데이트

문제 신고 소스 보기

Bazel 설치

Bazelisk는 Ubuntu, Windows, macOS에 Bazel을 설치하는 데 권장되는 방법입니다. 적절한 버전의 Bazel을 자동으로 다운로드하고 설치합니다. 현재 작업 디렉터리에 따라 다양한 버전의 Bazel 간에 전환하거나 Bazel을 항상 최신 버전으로 업데이트해야 하는 경우 Bazelisk를 사용합니다.

자세한 내용은 공식 리드미를 참고하세요.

Bazel 업데이트

Bazel에는 이전 버전과의 호환성 정책이 있습니다(개발자인 경우 호환되지 않는 변경사항 출시 안내 참고). 이 페이지에는 향후 호환되지 않는 변경사항으로 프로젝트를 테스트하고 마이그레이션하는 방법과 호환되지 않는 변경사항 작성자에게 의견을 제공하는 방법에 관한 권장사항이 요약되어 있습니다.

Bazelisk로 Bazel 버전 관리

Bazelisk는 Bazel 버전을 관리하는 데 도움이 됩니다.

Bazelisk는 다음 작업을 할 수 있습니다.

  • Bazel을 최신 LTS 또는 순차적 출시로 자동 업데이트합니다.
  • .bazelversion 파일에 지정된 Bazel 버전으로 프로젝트를 빌드합니다. 빌드 재현성을 위해 이 파일을 버전 제어에 체크인합니다.
  • 호환되지 않는 변경사항의 프로젝트 이전 지원 (위 참조)
  • 간편하게 출시 후보 사용해 보기

권장되는 마이그레이션 프로세스

LTS 버전의 소규모 업데이트 내에서 모든 프로젝트는 현재 버전과의 호환성을 손상시키지 않고 다음 출시를 위해 준비될 수 있습니다. 그러나 주 LTS 버전 간에 이전 버전과 호환되지 않는 변경사항이 있을 수 있습니다.

다음 프로세스에 따라 하나의 주 버전에서 다른 주 버전으로 마이그레이션합니다.

  1. 출시 노트를 읽고 다음 버전으로 이전하는 방법을 알아보세요.
  2. 호환되지 않는 주요 변경사항에는 관련 --incompatible_* 플래그와 해당 GitHub 문제가 있어야 합니다.
    • 이전 안내는 관련 GitHub 문제에서 확인할 수 있습니다.
    • 호환되지 않는 일부 변경사항 이전에 도구를 사용할 수 있습니다. 예를 들면 buildifier입니다.
    • 관련된 GitHub 문제에 댓글을 달아 이전 문제를 신고합니다.

이전 후에는 다음 주요 출시까지 이전 버전과의 호환성에 대해 걱정할 필요 없이 프로젝트를 계속 빌드할 수 있습니다.