FAQ

Laporkan masalah Lihat sumber Nightly · 8.0 . 7,4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Jika Anda memiliki pertanyaan atau memerlukan dukungan, lihat Mendapatkan Bantuan.

Apa itu Bazel?

Bazel adalah alat yang mengotomatiskan build dan pengujian software. Tugas build yang didukung mencakup menjalankan compiler dan penaut untuk menghasilkan program dan library yang dapat dieksekusi, serta menyusun paket yang dapat di-deploy untuk Android, iOS, dan lingkungan target lainnya. Bazel mirip dengan alat lain seperti Make, Ant, Gradle, Buck, Pants, dan Maven.

Apa yang spesial dari Bazel?

Bazel dirancang agar sesuai dengan cara pengembangan software di Google. Fitur-fiturnya adalah sebagai berikut:

  • Dukungan multibahasa: Bazel mendukung banyak bahasa, dan dapat diperluas untuk mendukung bahasa pemrograman arbitrer.
  • Bahasa build tingkat tinggi: Project dijelaskan dalam bahasa BUILD, format teks ringkas yang menjelaskan project sebagai kumpulan library, biner, dan pengujian kecil yang saling terhubung. Sebaliknya, dengan alat seperti Make, Anda harus mendeskripsikan setiap file dan pemanggilan compiler.
  • Dukungan multi-platform: Alat yang sama dan file BUILD yang sama dapat digunakan untuk mem-build software untuk arsitektur yang berbeda, dan bahkan platform yang berbeda. Di Google, kami menggunakan Bazel untuk mem-build semuanya, mulai dari aplikasi server yang berjalan di sistem di pusat data kami hingga aplikasi klien yang berjalan di ponsel.
  • Reproduktivitas: Dalam file BUILD, setiap library, pengujian, dan biner harus menentukan dependensi langsungnya sepenuhnya. Bazel menggunakan informasi dependensi ini untuk mengetahui apa yang harus dibuat ulang saat Anda membuat perubahan pada file sumber, dan tugas mana yang dapat berjalan secara paralel. Artinya, semua build bersifat inkremental dan akan selalu menghasilkan hasil yang sama.
  • Dapat diskalakan: Bazel dapat menangani build besar; di Google, biner server biasanya memiliki 100 ribu file sumber, dan build yang tidak mengubah file memerlukan waktu sekitar ~200 md.

Mengapa Google tidak menggunakan...?

  • Make, Ninja: Alat ini memberikan kontrol yang sangat akurat atas perintah yang dipanggil untuk mem-build file, tetapi pengguna harus menulis aturan yang benar.
    • Pengguna berinteraksi dengan Bazel di tingkat yang lebih tinggi. Misalnya, Bazel memiliki aturan bawaan untuk “pengujian Java”, “biner C++”, dan konsep seperti “platform target” dan “platform host”. Aturan ini telah diuji coba untuk memastikan keandalannya.
  • Ant dan Maven: Ant dan Maven terutama ditujukan untuk Java, sedangkan Bazel menangani beberapa bahasa. Bazel mendorong subdivisi codebase dalam unit yang lebih kecil dan dapat digunakan kembali, serta hanya dapat mem-build ulang codebase yang perlu di-build ulang. Hal ini mempercepat pengembangan saat menggunakan codebase yang lebih besar.
  • Gradle: File konfigurasi Bazel jauh lebih terstruktur daripada Gradle, sehingga Bazel dapat memahami dengan tepat apa yang dilakukan setiap tindakan. Hal ini memungkinkan lebih banyak paralelisme dan reproduksi yang lebih baik.
  • Pants, Buck: Kedua alat tersebut dibuat dan dikembangkan oleh mantan karyawan Google di Twitter dan Foursquare, serta Facebook. Keduanya telah dimodelkan setelah Bazel, tetapi kumpulan fiturnya berbeda, sehingga tidak dapat menjadi alternatif yang layak bagi kami.

Dari mana asal Bazel?

Bazel adalah ragam alat yang digunakan Google untuk mem-build software servernya secara internal. Firebase juga telah diperluas untuk mem-build software lain, seperti aplikasi seluler (iOS, Android) yang terhubung ke server kami.

Apakah Anda menulis ulang alat internal sebagai open source? Apakah ini fork?

Bazel berbagi sebagian besar kodenya dengan alat internal dan aturannya digunakan untuk jutaan build setiap hari.

Mengapa Google membuat Bazel?

Dulu, Google mem-build software-nya menggunakan Makefile besar yang dihasilkan. Hal ini menyebabkan build yang lambat dan tidak dapat diandalkan, yang mulai mengganggu produktivitas developer dan kelincahan perusahaan. Bazel adalah cara untuk mengatasi masalah ini.

Apakah Bazel memerlukan cluster build?

Bazel menjalankan operasi build secara lokal secara default. Namun, Bazel juga dapat terhubung ke cluster build untuk build dan pengujian yang lebih cepat. Lihat dokumentasi kami tentang eksekusi dan penyimpanan dalam cache jarak jauh dan penyimpanan dalam cache jarak jauh untuk mengetahui detail selengkapnya.

Bagaimana cara kerja proses pengembangan Google?

Untuk codebase server, kita menggunakan alur kerja pengembangan berikut:

  • Semua kode server kami berada dalam satu sistem kontrol versi yang sangat besar.
  • Semua orang mem-build software mereka dengan Bazel.
  • Setiap tim memiliki bagian yang berbeda dari hierarki sumber, dan menyediakan komponennya sebagai target BUILD.
  • Pemisahan cabang terutama digunakan untuk mengelola rilis, sehingga semua orang mengembangkan software mereka di revisi utama.

Bazel adalah fondasi filosofi ini: karena Bazel mewajibkan semua dependensi untuk ditentukan sepenuhnya, kita dapat memprediksi program dan pengujian mana yang terpengaruh oleh perubahan, dan memeriksanya sebelum dikirim.

Latar belakang selengkapnya tentang proses pengembangan di Google dapat ditemukan di blog alat eng.

Mengapa Anda membuka Bazel?

Membuat software harus menyenangkan dan mudah. Build yang lambat dan tidak dapat diprediksi akan menghilangkan kesenangan dalam pemrograman.

Mengapa saya ingin menggunakan Bazel?

  • Bazel dapat memberi Anda waktu build yang lebih cepat karena hanya dapat mengompilasi ulang file yang perlu dikompilasi ulang. Demikian pula, alat ini dapat melewati pengujian yang diketahui tidak berubah.
  • Bazel menghasilkan hasil deterministik. Hal ini menghilangkan penyimpangan antara build inkremental dan bersih, laptop dan sistem CI, dll.
  • Bazel dapat mem-build aplikasi klien dan server yang berbeda dengan alat yang sama dari ruang kerja yang sama. Misalnya, Anda dapat mengubah protokol klien/server dalam satu commit, dan menguji apakah aplikasi seluler yang diupdate berfungsi dengan server yang diupdate, mem-build keduanya dengan alat yang sama, dan memperoleh semua manfaat Bazel yang disebutkan di atas.

Dapatkah saya melihat contohnya?

Ya; lihat contoh sederhana atau baca kode sumber Bazel untuk contoh yang lebih kompleks.

Apa yang paling baik dari Bazel?

Bazel sangat cocok untuk mem-build dan menguji project dengan properti berikut:

  • Project dengan codebase besar
  • Project yang ditulis dalam (beberapa) bahasa yang dikompilasi
  • Project yang di-deploy di beberapa platform
  • Project yang memiliki pengujian yang ekstensif

Di mana saya dapat menjalankan Bazel?

Bazel berjalan di Linux, macOS (OS X), dan Windows.

Porting ke platform UNIX lainnya relatif mudah, selama JDK tersedia untuk platform tersebut.

Untuk apa saya tidak boleh menggunakan Bazel?

  • Bazel mencoba melakukan caching dengan cerdas. Artinya, ini tidak baik untuk menjalankan operasi build yang output-nya tidak boleh di-cache. Misalnya, langkah-langkah berikut tidak boleh dijalankan dari Bazel:
    • Langkah kompilasi yang mengambil data dari internet.
    • Langkah pengujian yang terhubung ke instance QA situs Anda.
    • Langkah deployment yang mengubah konfigurasi cloud situs Anda.
  • Jika build Anda terdiri dari beberapa langkah berurutan yang panjang, Bazel mungkin tidak dapat membantu banyak. Anda akan mendapatkan kecepatan yang lebih tinggi dengan memecah langkah-langkah panjang menjadi target terpisah yang lebih kecil yang dapat dijalankan Bazel secara paralel.

Seberapa stabil set fitur Bazel?

Fitur inti (aturan C++, Java, dan shell) memiliki penggunaan yang luas di dalam Google, sehingga fitur tersebut diuji secara menyeluruh dan memiliki sangat sedikit churn. Demikian pula, kami menguji versi baru Bazel di ratusan ribu target setiap hari untuk menemukan regresi, dan kami merilis versi baru beberapa kali setiap bulan.

Singkatnya, kecuali untuk fitur yang ditandai sebagai eksperimental, Bazel akan berfungsi dengan baik. Perubahan pada aturan non-eksperimental akan kompatibel dengan versi sebelumnya. Daftar status dukungan fitur yang lebih mendetail dapat ditemukan di dokumen dukungan kami.

Seberapa stabil Bazel sebagai biner?

Di Google, kami memastikan bahwa error Bazel sangat jarang terjadi. Hal ini juga berlaku untuk codebase open source kami.

Bagaimana cara mulai menggunakan Bazel?

Lihat Memulai.

Bukankah Docker menyelesaikan masalah reproduksi?

Dengan Docker, Anda dapat dengan mudah membuat sandbox dengan rilis OS tetap, misalnya, Ubuntu 12.04, Fedora 21. Hal ini menyelesaikan masalah reproduksi untuk lingkungan sistem, yaitu, “versi /usr/bin/c++ mana yang saya perlukan?”

Docker tidak menangani reproduksi sehubungan dengan perubahan pada kode sumber. Menjalankan Make dengan Makefile yang ditulis secara tidak sempurna di dalam penampung Docker masih dapat menghasilkan hasil yang tidak dapat diprediksi.

Di Google, kami memeriksa alat ke dalam kontrol sumber untuk reproduksi. Dengan cara ini, kita dapat memeriksa perubahan pada alat (“mengupgrade GCC ke 4.6.1”) dengan mekanisme yang sama seperti perubahan pada library dasar (“memperbaiki pemeriksaan batas di OpenSSL”).

Dapatkah saya mem-build biner untuk deployment di Docker?

Dengan Bazel, Anda dapat mem-build biner mandiri yang ditautkan secara statis di C/C++, dan file jar mandiri untuk Java. Aplikasi ini berjalan dengan sedikit dependensi pada sistem UNIX normal, sehingga mudah diinstal di dalam container Docker.

Bazel memiliki konvensi untuk menyusun program yang lebih kompleks, misalnya, program Java yang menggunakan kumpulan file data, atau menjalankan program lain sebagai subproses. Lingkungan tersebut dapat dikemas sebagai arsip mandiri, sehingga dapat di-deploy di berbagai sistem, termasuk image Docker.

Dapatkah saya mem-build image Docker dengan Bazel?

Ya, Anda dapat menggunakan aturan Docker kami untuk mem-build image Docker yang dapat direproduksi.

Apakah Bazel akan membuat build saya dapat direproduksi secara otomatis?

Untuk biner Java dan C++, ya, dengan asumsi Anda tidak mengubah toolchain. Jika memiliki langkah build yang melibatkan resep kustom (misalnya, menjalankan biner melalui skrip shell di dalam aturan), Anda harus melakukan beberapa tindakan ekstra:

  • Jangan gunakan dependensi yang tidak dideklarasikan. Eksekusi dengan sandbox (–spawn_strategy=sandboxed, hanya di Linux) dapat membantu menemukan dependensi yang tidak dideklarasikan.
  • Hindari menyimpan stempel waktu dan ID pengguna dalam file yang dihasilkan. File ZIP dan arsip lainnya sangat rentan terhadap hal ini.
  • Hindari terhubung ke jaringan. Eksekusi dengan sandbox juga dapat membantu di sini.
  • Hindari proses yang menggunakan angka acak, khususnya, penelusuran kamus diacak di banyak bahasa pemrograman.

Apakah Anda memiliki rilis biner?

Ya, Anda dapat menemukan biner rilis terbaru dan meninjau kebijakan rilis kami

Saya menggunakan Eclipse/IntelliJ/XCode. Bagaimana cara kerja Bazel dengan IDE?

Untuk IntelliJ, lihat plugin IntelliJ dengan Bazel.

Untuk XCode, lihat Tulsi.

Untuk Eclipse, lihat plugin E4B.

Untuk IDE lainnya, lihat postingan blog tentang cara kerja plugin ini.

Saya menggunakan Jenkins/CircleCI/TravisCI. Bagaimana cara kerja Bazel dengan sistem CI?

Bazel menampilkan kode keluar non-nol jika pemanggilan build atau pengujian gagal, dan ini seharusnya cukup untuk integrasi CI dasar. Karena Bazel tidak memerlukan build bersih untuk memastikan kebenaran, sistem CI tidak boleh dikonfigurasi untuk membersihkan sebelum memulai build/pengujian.

Detail selengkapnya tentang kode keluar ada di Panduan Pengguna.

Fitur apa yang akan tersedia di Bazel pada masa mendatang?

Lihat Roadmap kami.

Dapatkah saya menggunakan Bazel untuk project INSERT LANGUAGE HERE?

Bazel dapat diperluas. Siapa pun dapat menambahkan dukungan untuk bahasa baru. Banyak bahasa yang didukung: lihat ensiklopedi build untuk mengetahui daftar rekomendasi dan awesomebazel.com untuk mengetahui daftar yang lebih komprehensif.

Jika Anda ingin mengembangkan ekstensi atau mempelajari cara kerjanya, lihat dokumentasi untuk memperluas Bazel.

Dapatkah saya berkontribusi pada codebase Bazel?

Lihat pedoman kontribusi kami.

Mengapa tidak semua pengembangan dilakukan secara terbuka?

Kita masih harus memfaktorkan ulang antarmuka antara kode publik di Bazel dan ekstensi internal kita secara rutin. Hal ini menyulitkan untuk melakukan banyak pengembangan secara terbuka.

Apakah Anda sudah selesai melakukan open source Bazel?

Open sourcing Bazel masih dalam proses. Secara khusus, kami masih berupaya melakukan open source:

  • Banyak pengujian unit dan integrasi kami (yang akan mempermudah kontribusi patch).
  • Integrasi IDE lengkap.

Selain kode, pada akhirnya kami ingin semua peninjauan kode, pelacakan bug, dan keputusan desain dilakukan secara publik, dengan melibatkan komunitas Bazel. Kita belum sampai di sana, jadi beberapa perubahan akan muncul di repositori Bazel tanpa penjelasan yang jelas. Meskipun kurangnya transparansi ini, kami ingin mendukung developer eksternal dan berkolaborasi. Oleh karena itu, kami membuka kode tersebut, meskipun beberapa pengembangan masih dilakukan secara internal di Google. Harap beri tahu kami jika ada yang tidak jelas atau tidak adil saat kami bertransisi ke model terbuka.

Apakah ada bagian Bazel yang tidak akan pernah di-open source?

Ya, beberapa codebase terintegrasi dengan teknologi khusus Google atau kami telah mencari alasan untuk menghapusnya (atau merupakan kombinasi dari keduanya). Bagian code base ini tidak tersedia di GitHub dan mungkin tidak akan pernah tersedia.

Bagaimana cara menghubungi tim?

Anda dapat menghubungi kami di bazel-discuss@googlegroups.com.

Di mana saya dapat melaporkan bug?

Buka masalah di GitHub.

Apa yang terjadi dengan kata “Blaze” di codebase?

Ini adalah nama internal untuk alat. Silakan sebut Blaze sebagai Bazel.

Mengapa project Google lainnya (Android, Chrome) menggunakan alat build lain?

Hingga rilis pertama (Alfa), Bazel tidak tersedia secara eksternal, sehingga project open source seperti Chromium dan Android tidak dapat menggunakannya. Selain itu, kurangnya dukungan Windows pada awalnya menjadi masalah untuk mem-build aplikasi Windows, seperti Chrome. Karena project telah matang dan menjadi lebih stabil, Proyek Open Source Android sedang dalam proses migrasi ke Bazel.

Bagaimana cara mengucapkan “Bazel”?

Sama seperti “basil” (ramuan) dalam bahasa Inggris Amerika: “BAY-zel”. Bunyinya sama dengan “hazel”. IPA: /ˈbeɪzˌəl/