Aturan Repositori

Laporkan masalah Lihat sumber Per Malam · 7,3 · 7,2 · 7,1 · 7,0 · 6,5

Halaman ini membahas cara membuat aturan repositori dan memberikan contoh untuk secara lebih mendetail.

Repositori eksternal adalah aturan yang hanya dapat digunakan dalam file WORKSPACE dan memungkinkan operasi non-hermetik pada fase pemuatan dari Bazel. Setiap aturan repositori eksternal membuat ruang kerjanya sendiri, dengan file dan artefak BUILD sendiri. Layanan ini dapat digunakan untuk bergantung pada ketersediaan pihak ketiga. library (seperti library terpaket Maven) tetapi juga untuk menghasilkan file BUILD khusus untuk {i>host<i} yang dijalankan Bazel.

Pembuatan aturan repositori

Dalam file .bzl, gunakan fungsi repository_rule untuk membuat aturan repositori dan menyimpannya dalam variabel global.

Aturan repositori kustom dapat digunakan seperti aturan repositori native. Ini memiliki atribut name wajib dan setiap target yang ada dalam file build-nya dapat disebut sebagai @<name>//package:target dengan <name> adalah nilai Atribut name.

Aturan dimuat ketika Anda secara eksplisit membangunnya, atau jika itu adalah dependensi dari build tersebut. Dalam hal ini, Bazel akan menjalankan fungsi implementation. Ini fungsi yang menjelaskan cara membuat repositori, kontennya, dan file BUILD.

Atribut

Atribut adalah argumen aturan, seperti url atau sha256. Anda harus mencantumkan atribut dan jenisnya saat Anda menentukan aturan repositori.

local_repository = repository_rule(
    implementation=_impl,
    local=True,
    attrs={"path": attr.string(mandatory=True)})

Untuk mengakses atribut, gunakan repository_ctx.attr.<attribute_name>.

Semua repository_rule memiliki atribut yang ditentukan secara implisit (seperti build aturan). Dua atribut implisit adalah name (seperti untuk aturan build) dan repo_mapping. Nama aturan repositori dapat diakses dengan repository_ctx.name. Arti repo_mapping sama dengan untuk aturan repositori native local_repository dan new_local_repository.

Jika nama atribut diawali dengan _, atribut tersebut bersifat pribadi dan pengguna tidak dapat menyetelnya.

Fungsi penerapan

Setiap aturan repositori memerlukan fungsi implementation. Isinya adalah logika aturan yang sebenarnya dan dijalankan secara ketat pada Fase Pemuatan.

Fungsi ini memiliki tepat satu parameter input, repository_ctx. {i>Function<i} menampilkan None untuk menunjukkan bahwa aturan tersebut dapat direproduksi mengingat parameter tertentu, atau dict dengan set parameter untuk aturan tersebut akan mengubah aturan itu menjadi aturan yang dapat direproduksi yang menghasilkan repositori yang sama. Sebagai misalnya, untuk aturan yang melacak repositori git yang berarti menampilkan ID commit spesifik, dan bukan cabang mengambang yang awalnya yang ditentukan.

Parameter input repository_ctx dapat digunakan untuk mengakses nilai atribut, dan fungsi non-hermetik (menemukan biner, mengeksekusi biner, membuat file dalam repositori atau mengunduh file dari internet). Lihat library untuk mengetahui informasi selengkapnya konteks tambahan. Contoh:

def _impl(repository_ctx):
  repository_ctx.symlink(repository_ctx.attr.path, "")

local_repository = repository_rule(
    implementation=_impl,
    ...)

Kapan fungsi implementasi dieksekusi?

Jika repositori dideklarasikan sebagai local, ubah dalam dependensi dalam grafik dependensi (termasuk file WORKSPACE itu sendiri) akan menyebabkan eksekusi fungsi implementasi.

Fungsi implementasi dapat dimulai ulang jika dependensinya permintaan tidak ada. Awal fungsi implementasi akan dieksekusi kembali setelah dependensi diselesaikan. Untuk menghindari proses mulai ulang yang tidak perlu (yang mahal, karena akses jaringan mungkin harus diulang), argumen label di-pengambilan data, asalkan semua argumen label dapat di-resolve menjadi file yang sudah ada. Perhatikan bahwa menyelesaikan jalur dari {i>string<i} atau label yang dibuat hanya selama eksekusi fungsi tersebut masih dapat menyebabkan {i>restart<i}.

Terakhir, untuk repositori non-local, hanya perubahan pada dependensi dapat menyebabkan mulai ulang:

  • .bzl file diperlukan untuk menentukan aturan repositori.
  • Pernyataan aturan repositori dalam file WORKSPACE.
  • Nilai variabel lingkungan apa pun yang dideklarasikan dengan environ dari repository_rule . Nilai variabel lingkungan tersebut dapat diterapkan dari baris perintah dengan --action_env (tetapi flag ini akan membatalkan setiap tindakan build).
  • Konten file apa pun yang digunakan dan dirujuk oleh label (misalnya, //mypkg:label.txt bukan mypkg/label.txt).

Memaksa pengambilan kembali repositori eksternal

Terkadang, repositori eksternal bisa menjadi usang tanpa perubahan apa pun pada repositorinya definisi atau dependensi. Misalnya, sumber pengambilan repositori mungkin mengikuti cabang tertentu dari repositori pihak ketiga, dan commit baru yang tersedia di cabang itu. Dalam hal ini, Anda dapat meminta bazel untuk mengambil kembali semua repositori eksternal tanpa syarat dengan memanggil bazel sync.

Selain itu, beberapa aturan memeriksa komputer lokal dan mungkin menjadi usang jika komputer lokal di-upgrade. Di sini Anda dapat meminta bazel untuk hanya mengambil kembali repositori eksternal tersebut repository_rule definisi memiliki atribut configure yang disetel, gunakan bazel sync --configure.

Contoh

  • Toolchain C++ yang dikonfigurasi secara otomatis: ia menggunakan aturan repositori untuk secara otomatis membuat file konfigurasi C++ untuk Bazel dengan mencari compiler C++ lokal, dan penanda yang didukung kompilator C++.

  • Repositori Go menggunakan beberapa repository_rule untuk menentukan daftar dependensi yang diperlukan untuk menggunakan aturan Go.

  • rules_jvm_external membuat repositori eksternal bernama @maven secara default yang menghasilkan target build untuk setiap artefak Maven dalam hierarki dependensi transitif.