Registry Bazel

Bzlmod menemukan dependensi dengan meminta informasinya dari registry Bazel: database modul Bazel. Saat ini, Bzlmod hanya mendukung registry indeks — direktori lokal atau server HTTP statis yang mengikuti format tertentu.

Registry indeks

Registry indeks adalah direktori lokal atau server HTTP statis yang berisi informasi tentang daftar modul — termasuk halaman beranda, pengelola, file MODULE.bazel setiap versi, dan cara mengambil sumber setiap versi. Perlu diperhatikan bahwa registry indeks tidak perlu menayangkan arsip sumber itu sendiri.

Registry indeks harus mengikuti format di bawah:

• /bazel_registry.json: File JSON yang berisi metadata untuk registry seperti:
  • mirrors: menentukan daftar mirror yang akan digunakan untuk arsip sumber. URL mirror adalah gabungan dari mirror itu sendiri, dan URL sumber modul yang ditentukan oleh file source.json tanpa protokol. Misalnya, jika URL sumber modul adalah https://foo.com/bar/baz, dan mirrors berisi ["https://mirror1.com/", "https://example.com/mirror2/"], maka URL yang akan dicoba Bazel secara berurutan adalah https://mirror1.com/foo.com/bar/baz, https://example.com/mirror2/foo.com/bar/baz, dan terakhir URL sumber asli itu sendiri https://foo.com/bar/baz.
  • module_base_path: menentukan jalur dasar untuk modul dengan jenis local_repository dalam file source.json
• /modules: Direktori yang berisi subdirektori untuk setiap modul dalam registry ini
• /modules/$MODULE: Direktori yang berisi subdirektori untuk setiap versi modul ini, serta:
  • metadata.json: File JSON yang berisi informasi tentang modul, dengan kolom berikut:
    • homepage: URL halaman beranda project
    • maintainers: Daftar objek JSON, yang masing-masing sesuai dengan informasi pengelola modul di registry. Perhatikan bahwa ini tidak harus sama dengan penulis project
    • versions: Daftar semua versi modul ini yang dapat ditemukan di registry ini
    • yanked_versions: Peta versi modul ini yang ditarik . Kunci harus berupa versi yang akan ditarik dan nilainya harus berupa deskripsi alasan versi tersebut ditarik, sebaiknya berisi link ke informasi selengkapnya
• /modules/$MODULE/$VERSION: Direktori yang berisi file berikut:
  • MODULE.bazel: File MODULE.bazel dari versi modul ini
  • source.json: File JSON yang berisi informasi tentang cara mengambil sumber versi modul ini
    • Jenis default-nya adalah "archive", yang mewakili repo http_archive, dengan kolom berikut:
      • url: URL arsip sumber
      • mirror_urls: Daftar string, URL mirror arsip sumber. URL dicoba secara berurutan setelah url sebagai cadangan.
      • integrity: Checksum Subresource Integrity dari arsip
      • strip_prefix: Awalan direktori yang akan dihapus saat mengekstrak arsip sumber
      • patches: Peta yang berisi file patch yang akan diterapkan ke arsip yang diekstrak. File patch terletak di direktori /modules/$MODULE/$VERSION/patches. Kuncinya adalah nama file patch, dan nilainya adalah checksum integritas file patch
      • patch_strip: Sama dengan arg1 --strip dari patch Unix.
      • archive_type: Jenis arsip file yang didownload (Sama dengan type di http_archive). Secara default, jenis arsip ditentukan dari ekstensi file URL. Jika file tidak memiliki ekstensi, Anda dapat menentukan salah satu dari yang berikut secara eksplisit: "zip", "jar", "war", "aar", "tar", "tar.gz", "tgz", "tar.xz", "txz", "tar.zst", "tzst", tar.bz2, "ar", atau "deb".
    • Jenisnya dapat diubah untuk menggunakan repositori git, dengan kolom berikut:
      • type: git_repository
      • Kolom berikut seperti yang dijelaskan di https://bazel.build/rules/lib/repo/git:
        • remote
        • commit
        • shallow_since
        • tag
        • init_submodules
        • verbose
        • strip_prefix
    • Jenisnya dapat diubah untuk menggunakan jalur lokal, yang mewakili repo local_repository, dengan kolom berikut:
      • type: local_path
      • path: Jalur lokal ke repo, yang dihitung sebagai berikut:
        • Jika path adalah jalur absolut, jalur tersebut akan tetap seperti itu
        • Jika path adalah jalur relatif dan module_base_path adalah jalur absolut, jalur tersebut akan di-resolve ke <module_base_path>/<path>
        • Jika path dan module_base_path adalah jalur relatif, jalur tersebut akan di-resolve ke <registry_path>/<module_base_path>/<path>. Registry harus dihosting secara lokal dan digunakan oleh --registry=file://<registry_path>. Jika tidak, Bazel akan menampilkan error
  • patches/: Direktori opsional yang berisi file patch, hanya digunakan jika source.json memiliki jenis "archive"

Registry Pusat Bazel

Registry Pusat Bazel (BCR) di https://bcr.bazel.build/ adalah registry indeks dengan konten yang didukung oleh repo GitHub bazelbuild/bazel-central-registry. Anda dapat menjelajahi kontennya menggunakan frontend web di https://registry.bazel.build/.

Komunitas Bazel mengelola BCR, dan kontributor dapat mengirimkan permintaan pull. Lihat panduan kontribusi BCR.

Selain mengikuti format registry indeks normal, BCR memerlukan file presubmit.yml untuk setiap versi modul (/modules/$MODULE/$VERSION/presubmit.yml). File ini menentukan beberapa target build dan pengujian penting yang dapat Anda gunakan untuk memeriksa validitas versi modul ini. Pipeline CI BCR juga menggunakan file ini untuk memastikan interoperabilitas antar-modul.

Memilih registry

Flag Bazel yang dapat diulang --registry dapat digunakan untuk menentukan daftar registry tempat meminta modul, sehingga Anda dapat menyiapkan project untuk mengambil dependensi dari registry pihak ketiga atau internal. Registry sebelumnya akan diprioritaskan. Untuk memudahkan, Anda dapat menempatkan daftar flag --registry di file .bazelrc project.

Jika registry Anda dihosting di GitHub (misalnya, sebagai fork dari bazelbuild/bazel-central-registry), nilai --registry Anda memerlukan alamat GitHub mentah di bagian raw.githubusercontent.com. Misalnya, di main cabang my-org fork, Anda akan menetapkan --registry=https://raw.githubusercontent.com/my-org/bazel-central-registry/main/.

Penggunaan flag --registry akan menghentikan penggunaan Registry Pusat Bazel secara default, tetapi Anda dapat menambahkannya kembali dengan menambahkan --registry=https://bcr.bazel.build.