Bazel 레지스트리

Nightly · 9.1 · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 8.1

Bazel은 Bazel 모듈의 데이터베이스인 Bazel 레지스트리에 정보를 요청하여 종속 항목을 검색합니다. Bazel은 특정 형식을 따르는 로컬 디렉터리 또는 정적 HTTP 서버인 색인 레지스트리 라는 한 가지 유형의 레지스트리만 지원합니다.

색인 레지스트리

색인 레지스트리는 홈페이지, 관리자, 각 버전의 MODULE.bazel 파일, 각 버전의 소스를 가져오는 방법을 비롯한 모듈 목록에 관한 정보가 포함된 로컬 디렉터리 또는 정적 HTTP 서버입니다. 특히 소스 아카이브 자체를 제공할 필요는 없습니다.

색인 레지스트리는 다음 형식을 따라야 합니다.

  • /bazel_registry.json: 레지스트리의 메타데이터가 포함된 선택적 JSON 파일입니다.
  • /modules: 이 레지스트리의 각 모듈에 대한 하위 디렉터리가 포함된 디렉터리입니다.
  • /modules/$MODULE: $MODULE이라는 모듈의 각 버전에 대한 하위 디렉터리와 이 모듈의 메타데이터가 포함된 metadata.json 파일이 포함된 디렉터리입니다.
  • /modules/$MODULE/$VERSION: 다음 파일이 포함된 디렉터리입니다.

bazel_registry.json

bazel_registry.json 은 전체 레지스트리에 적용되는 메타데이터를 지정하는 선택적 파일입니다. 다음 필드를 포함할 수 있습니다.

  • mirrors: 문자열 배열로, 소스 아카이브에 사용할 미러 목록을 지정합니다.
    • 미러링된 URL은 미러 자체와 프로토콜이 없는 source.json 파일에 의해 지정된 모듈의 소스 URL을 연결한 것입니다. 예를 들어 모듈의 소스 URL이 https://foo.com/bar/baz이고 mirrors에 ["https://mirror1.com/", "https://example.com/mirror2/"]가 포함되어 있으면 Bazel이 순서대로 시도하는 URL은 https://mirror1.com/foo.com/bar/baz, https://example.com/mirror2/foo.com/bar/baz, 마지막으로 원래 소스 URL 자체인 https://foo.com/bar/baz입니다.
  • module_base_path: 문자열로, source.json 파일에서 local_path 유형이 있는 모듈의 기본 경로를 지정합니다.

metadata.json

metadata.json 은 모듈에 관한 정보가 포함된 선택적 JSON 파일로, 다음 필드가 포함되어 있습니다.

  • versions: 문자열 배열로, 각각 이 레지스트리에서 사용할 수 있는 모듈 버전을 나타냅니다. 이 배열은 모듈 디렉터리의 하위 요소와 일치해야 합니다.
  • yanked_versions: 이 모듈의 yanked versions 버전을 지정하는 JSON 객체입니다. 키는 yank할 버전이어야 하고 값은 버전이 yank된 이유에 관한 설명이어야 하며, 추가 정보 링크가 포함되어 있는 것이 좋습니다.

BCR에는 metadata.json 파일에 더 많은 정보가 필요합니다.

source.json

source.json 은 모듈의 특정 버전을 가져오는 방법에 관한 정보가 포함된 필수 JSON 파일입니다. 이 파일의 스키마는 기본값이 archive인 type 필드에 따라 다릅니다.

  • type이 archive (기본값)이면 이 모듈 버전은 http_archive 저장소 규칙으로 지원됩니다. 지정된 URL에서 아카이브를 다운로드하고 콘텐츠를 추출하여 가져옵니다. 다음 필드를 지원합니다.
    • url: 문자열로, 소스 아카이브의 URL입니다.
    • mirror_urls: 문자열 목록으로, 소스 아카이브의 미러 URL입니다. URL은 백업으로 url 다음에 순서대로 시도됩니다.
    • integrity: 문자열로, 하위 리소스 무결성 체크섬입니다.
    • strip_prefix: 문자열로, 소스 아카이브를 추출할 때 삭제할 디렉터리 접두사입니다.
    • overlay: 추출된 아카이브 위에 레이어링할 오버레이 파일이 포함된 JSON 객체입니다. 패치 파일은 /modules/$MODULE/$VERSION/overlay 디렉터리에 있습니다. 키는 오버레이 파일 이름이고 값은 오버레이 파일의 무결성 체크섬입니다. 오버레이는 패치 파일 전에 적용됩니다.
    • patches: 추출된 아카이브에 적용할 패치 파일이 포함된 JSON 객체입니다. 패치 파일은 /modules/$MODULE/$VERSION/patches 디렉터리에 있습니다. 키는 패치 파일 이름이고 값은 패치 파일의 무결성 체크섬입니다. 패치는 오버레이 파일 후에 patches에 표시된 순서대로 적용됩니다.
    • patch_strip: 숫자이며 Unix patch의 --strip 인수와 동일합니다.
    • archive_type: 문자열로, 다운로드한 파일의 아카이브 유형입니다 (http_archive의 type과 동일 ).
  • type이 git_repository이면 이 모듈 버전은 git_repository 저장소 규칙으로 지원됩니다. Git 저장소를 클론하여 가져옵니다.
    • 다음 필드가 지원되며 기본 git_repository 저장소 규칙으로 직접 전달됩니다. remote, commit, shallow_since, tag, init_submodules, verbose, strip_prefix, patch_strip.
    • patches: 클론된 저장소에 적용할 패치 파일이 포함된 JSON 객체입니다. 패치 파일은 /modules/$MODULE/$VERSION/patches 디렉터리에 있습니다. 키는 패치 파일 이름이고 값은 패치 파일의 무결성 체크섬입니다. 패치는 patches에 표시된 순서대로 적용됩니다.
  • type이 local_path이면 이 모듈 버전은 local_repository 저장소 규칙으로 지원됩니다. 로컬 디스크의 디렉터리에 심볼릭 링크됩니다. 다음 필드를 지원합니다.
    • path: 저장소의 로컬 경로로, 다음과 같이 계산됩니다.
      • path가 절대 경로이면 그대로 유지됩니다.
      • path가 상대 경로이고 module_base_path가 절대 경로이면 <module_base_path>/<path>로 확인됩니다.
      • path와 module_base_path가 모두 상대 경로이면 <registry_path>/<module_base_path>/<path>로 확인됩니다. 레지스트리는 로컬에서 호스팅되어야 하며 --registry=file://<registry_path>에서 사용해야 합니다. 그렇지 않으면 Bazel에서 오류가 발생합니다.

Bazel 중앙 레지스트리

https://bcr.bazel.build/의 Bazel 중앙 레지스트리 (BCR)는 GitHub 저장소 bazelbuild/bazel-central-registry에서 지원하는 콘텐츠가 포함된 색인 레지스트리입니다. https://registry.bazel.build/의 웹 프런트엔드를 사용하여 콘텐츠를 탐색할 수 있습니다. https://registry.bazel.build/

Bazel 커뮤니티에서 BCR을 유지관리하며 기여자는 언제든지 풀 요청을 제출할 수 있습니다. BCR 기여 가이드라인을 참고하세요.

일반 색인 레지스트리의 형식을 따르는 것 외에도 BCR에는 각 모듈 버전 presubmit.yml 파일(/modules/$MODULE/$VERSION/presubmit.yml)이 필요합니다. 이 파일은 이 모듈 버전의 유효성을 확인하는 데 사용할 수 있는 몇 가지 필수 빌드 및 테스트 대상을 지정합니다. BCR의 CI 파이프라인은 이를 사용하여 모듈 간의 상호 운용성을 보장합니다.

레지스트리 선택

반복 가능한 Bazel 플래그 --registry를 사용하여 모듈을 요청할 레지스트리 목록을 지정할 수 있으므로 서드 파티 또는 내부 레지스트리에서 종속 항목을 가져오도록 프로젝트를 설정할 수 있습니다. 이전 레지스트리가 우선 적용됩니다. 편의를 위해 프로젝트의 .bazelrc 파일에 --registry 플래그 목록을 넣을 수 있습니다.

레지스트리가 GitHub에서 호스팅되는 경우 (예: bazelbuild/bazel-central-registry의 포크) --registry 값에는 raw.githubusercontent.com 아래에 원시 GitHub 주소가 필요합니다. 예를 들어 my-org 포크의 main 브랜치에서 --registry=https://raw.githubusercontent.com/my-org/bazel-central-registry/main/을 설정합니다.

--registry 플래그를 사용하면 Bazel 중앙 레지스트리가 기본적으로 사용되지 않지만 --registry=https://bcr.bazel.build를 추가하여 다시 추가할 수 있습니다.