Memanggil Bazel dari skrip

Anda dapat memanggil Bazel dari skrip untuk melakukan build, menjalankan pengujian, atau membuat kueri grafik dependensi. Bazel telah didesain untuk memungkinkan pembuatan skrip yang efektif, tetapi bagian ini mencantumkan beberapa detail yang perlu diingat untuk membuat skrip Anda lebih andal.

Memilih dasar output

Opsi --output_base mengontrol tempat proses Bazel harus menulis output build, serta berbagai file kerja yang digunakan secara internal oleh Bazel, salah satunya adalah kunci yang melindungi dari mutasi serentak basis output oleh beberapa proses Bazel.

Memilih direktori dasar output yang benar untuk skrip Anda bergantung pada beberapa faktor. Jika Anda perlu menempatkan output build di lokasi tertentu, hal ini akan menentukan dasar output yang perlu Anda gunakan. Jika Anda melakukan panggilan "hanya baca" ke Bazel (seperti bazel query), faktor penguncian akan lebih penting. Secara khusus, jika Anda perlu menjalankan beberapa instance skrip secara bersamaan, Anda harus ingat bahwa setiap proses server Blaze hanya dapat menangani paling banyak satu pemanggilan dalam satu waktu. Bergantung pada situasi Anda, setiap instance skrip Anda mungkin perlu menunggu gilirannya, atau Anda mungkin perlu menggunakan --output_base untuk menjalankan beberapa server Blaze dan menggunakannya.

Jika menggunakan nilai dasar output default, Anda akan bersaing untuk mendapatkan kunci yang sama yang digunakan oleh perintah Bazel interaktif pengguna. Jika pengguna mengeluarkan perintah yang berjalan lama seperti build, skrip Anda harus menunggu perintah tersebut selesai sebelum dapat dilanjutkan.

Catatan tentang mode server

Secara default, Bazel menggunakan proses server yang berjalan lama sebagai pengoptimalan. Saat menjalankan Bazel dalam skrip, jangan lupa untuk memanggil shutdown saat Anda selesai menggunakan server, atau, tentukan --max_idle_secs=5 agar server yang tidak aktif segera dimatikan.

Kode keluar apa yang akan saya dapatkan?

Bazel mencoba membedakan kegagalan karena kode sumber yang sedang dipertimbangkan dari error eksternal yang mencegah Bazel dieksekusi dengan benar. Eksekusi Bazel dapat menghasilkan kode keluar berikut:

Kode Exit yang umum untuk semua perintah:

• 0 - Berhasil
• 2 - Masalah Command Line, Kombinasi perintah atau tanda yang Buruk atau Ilegal, atau Variabel Lingkungan yang Buruk. Baris perintah Anda harus diubah.
• 8 - Build Terganggu, tetapi kami menghentikan dengan penonaktifan yang teratur.
• 9 - Kunci server dipegang dan --noblock_for_lock diteruskan.

• 32 - External Environment Failure tidak ada di komputer ini.

• 33 - Bazel kehabisan memori dan error. Anda perlu mengubah command line.

• 34 - Dicadangkan untuk penggunaan internal Google.

• 35 - Dicadangkan untuk penggunaan internal Google.

• 36 - Masalah Lingkungan Lokal, diduga permanen.

• 37 - Pengecualian yang Tidak Tertangani / Error Bazel Internal.

• 38 - Error sementara saat memublikasikan hasil ke Layanan Peristiwa Build.

• 39 - Blob yang diperlukan oleh Bazel dikeluarkan dari Cache Jarak Jauh.

• 41-44 - Dicadangkan untuk penggunaan internal Google.

• 45 - Hasil publikasi error persisten ke Build Event Service.

• 47 - Dicadangkan untuk penggunaan internal Google.

• 49 - Dicadangkan untuk penggunaan internal Google.

Kode yang ditampilkan untuk perintah bazel build, bazel test:

• 1 - Build gagal.
• 3 - Build OK, tetapi beberapa pengujian gagal atau waktunya habis.
• 4 - Build berhasil, tetapi tidak ada pengujian yang ditemukan meskipun pengujian diminta.

Untuk bazel run:

• 1 - Build gagal.
• Jika build berhasil, tetapi subproses yang dieksekusi menampilkan kode keluar non-nol, kode tersebut juga akan menjadi kode keluar perintah.

Untuk bazel query:

• 3 - Berhasil sebagian, tetapi kueri mengalami 1 error atau lebih dalam set file BUILD input dan oleh karena itu hasil operasi tidak 100% andal. Hal ini kemungkinan disebabkan oleh opsi --keep_going pada command line.
• 7 - Kegagalan perintah.

Versi Bazel mendatang dapat menambahkan kode keluar tambahan, menggantikan kode keluar kegagalan generik 1 dengan nilai non-nol yang berbeda dengan makna tertentu. Namun, semua nilai keluar non-nol akan selalu merupakan error.

Membaca file .bazelrc

Secara default, Bazel membaca file .bazelrc dari direktori ruang kerja dasar atau direktori beranda pengguna. Apakah hal ini diinginkan atau tidak adalah pilihan untuk skrip Anda; jika skrip Anda harus benar-benar tertutup (seperti saat melakukan build rilis), Anda harus menonaktifkan pembacaan file .bazelrc dengan menggunakan opsi --bazelrc=/dev/null. Jika Anda ingin melakukan build menggunakan setelan pilihan pengguna, perilaku default lebih baik.

Log perintah

Output Bazel juga tersedia dalam file log perintah yang dapat Anda temukan dengan perintah berikut:

bazel info command_log

File log perintah berisi aliran stdout dan stderr yang disisipkan dari perintah Bazel terbaru. Perhatikan bahwa menjalankan bazel info akan menggantikan isi file ini, karena file tersebut kemudian menjadi perintah Bazel terbaru. Namun, lokasi file log perintah tidak akan berubah kecuali jika Anda mengubah setelan opsi --output_base atau --output_user_root.

Output penguraian

Output Bazel cukup mudah diurai untuk berbagai tujuan. Dua opsi yang mungkin berguna untuk skrip Anda adalah --noshow_progress yang menyembunyikan pesan progres, dan --show_result n, yang mengontrol apakah pesan "build up-to-date" dicetak atau tidak; pesan ini dapat diuraikan untuk mengetahui target mana yang berhasil dibuat, dan lokasi file output yang dibuatnya. Pastikan untuk menentukan nilai n yang sangat besar jika Anda mengandalkan pesan ini.

Memecahkan masalah performa dengan membuat profil

Lihat bagian Profiling Performa.