FAQ

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

Apa itu Bazel?

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

Apa yang spesial dari Bazel?

Bazel dirancang agar sesuai dengan cara pengembangan software di Google. Layanan ini memiliki fitur berikut:

  • Dukungan multibahasa: Bazel mendukung banyak bahasa, dan dapat diperluas untuk mendukung bahasa pemrograman arbitrer.
  • Bahasa build level tinggi: Project dijelaskan dalam bahasa BUILD, sebuah format teks ringkas yang menjelaskan project sebagai kumpulan library, biner, dan pengujian kecil yang saling terhubung. Sebaliknya, dengan alat seperti Make, Anda harus menjelaskan file individual dan pemanggilan compiler.
  • Dukungan multi-platform: Alat yang sama dan file BUILD yang sama dapat digunakan untuk membuat software untuk arsitektur yang berbeda, dan bahkan platform yang berbeda. Di Google, kami menggunakan Bazel untuk membuat semuanya dari aplikasi server yang berjalan di sistem di pusat data kami hingga aplikasi klien yang berjalan di ponsel.
  • Reproduksibilitas: 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 apa yang dapat dijalankan secara paralel. Ini berarti bahwa semua build bersifat inkremental dan akan selalu memberikan hasil yang sama.
  • Skalabel: Bazel dapat menangani build yang besar; di Google, biasanya biner server memiliki 100 ribu file sumber, dan build yang tidak memiliki file yang diubah membutuhkan waktu sekitar ~200 milidetik.

Mengapa Google tidak menggunakan...?

  • Make, Ninja: Alat ini memberi kontrol yang sangat akurat atas perintah yang dipanggil untuk membuat file, tetapi pengguna bisa menulis aturan yang benar.
    • Pengguna berinteraksi dengan Bazel di tingkat yang lebih tinggi. Misalnya, Bazel memiliki aturan bawaan untuk “pengujian Java”, “biner C++”, dan gagasan seperti “platform target” dan “platform host”. Aturan ini telah diuji untuk menjadi sangat mudah.
  • Ant dan Maven: Ant dan Maven terutama ditujukan untuk Java, sedangkan Bazel menangani beberapa bahasa. Bazel mendorong pembagian codebase di unit yang lebih kecil dan dapat digunakan kembali, dan hanya bisa membuat ulang codebase yang memerlukan pembuatan ulang. Hal ini akan mempercepat pengembangan saat digunakan dengan codebase yang lebih besar.
  • Gradle: File konfigurasi Bazel jauh lebih terstruktur daripada Gradle, memungkinkan Bazel memahami dengan tepat apa yang dilakukan setiap tindakan. Hal ini memungkinkan keparalelan dan lebih mudah direproduksi.
  • Pants, Buck: Kedua alat tersebut dibuat dan dikembangkan oleh mantan Googler di Twitter dan Foursquare, serta Facebook. Model ini telah dimodelkan setelah Bazel, tetapi set fiturnya berbeda, sehingga bukan alternatif yang efektif bagi kami.

Dari mana Bazel berasal?

Bazel adalah jenis alat yang digunakan Google untuk membuat software servernya secara internal. Infrastruktur ini juga telah diperluas untuk membuat software lain, seperti aplikasi seluler (iOS, Android) yang terhubung ke server kami.

Apakah Anda menulis ulang alat internal sebagai sumber terbuka? Apakah ini garpu?

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

Mengapa Google membuat Bazel?

Google sudah lama membuat software-nya menggunakan Makefile yang berukuran besar dan dibuat. Hal ini menyebabkan build yang lambat dan tidak dapat diandalkan, yang mulai mengganggu produktivitas developer kami dan kelincahan perusahaan. Bazel adalah cara untuk memecahkan 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 caching jarak jauh dan cache jarak jauh untuk detail lebih lanjut.

Bagaimana cara kerja proses pengembangan Google?

Untuk code base server, kami menggunakan alur kerja pengembangan berikut:

  • Semua kode server kami berada dalam satu sistem kontrol versi raksasa.
  • Semua orang membuat software-nya dengan Bazel.
  • Tim yang berbeda memiliki bagian yang berbeda dari hierarki sumber, dan membuat komponennya tersedia sebagai target BUILD.
  • Percabangan terutama digunakan untuk mengelola rilis, sehingga semua orang mengembangkan software mereka pada revisi utama.

Bazel adalah landasan filosofi ini: karena Bazel mengharuskan semua dependensi ditentukan secara lengkap, kami dapat memprediksi program dan pengujian mana yang terpengaruh oleh perubahan, dan memeriksanya sebelum dikirimkan.

Informasi selengkapnya tentang proses pengembangan di Google dapat ditemukan pada blog eng tools.

Mengapa Anda membuka Bazel?

Membuat software harus menyenangkan dan mudah. Build yang lambat dan tidak dapat diprediksi akan membuat pemrograman menjadi menyenangkan.

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, aplikasi Anda dapat melewati pengujian ulang yang diketahuinya belum berubah.
  • Bazel memberikan hasil deterministik. Hal ini menghilangkan kecondongan antara build inkremental dan build bersih, sistem laptop dan CI, dll.
  • Bazel dapat membuat 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 telah diupdate, membuat keduanya dengan alat yang sama, yang menuai 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 keunggulan Bazel?

Bazel bersinar dalam membangun dan menguji project dengan properti berikut:

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

Di mana saya dapat menjalankan Bazel?

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

Transfer ke platform UNIX lainnya harus relatif mudah, selama JDK tersedia untuk platform.

Apa yang sebaiknya saya tidak menggunakan Bazel?

  • Bazel berusaha cerdas dalam caching. Ini berarti tidak baik untuk menjalankan operasi build yang outputnya 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 banyak membantu. Anda akan mendapatkan kecepatan lebih dengan membagi 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) telah banyak digunakan di dalam Google, sehingga fitur tersebut diuji secara menyeluruh dan hanya memiliki 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 seharusnya Bekerja. Perubahan pada aturan non-eksperimental akan kompatibel dengan versi sebelumnya. Daftar lebih lanjut status dukungan fitur dapat ditemukan di dokumen dukungan kami.

Seberapa stabil Bazel sebagai biner?

Di dalam Google, kami memastikan bahwa error Bazel sangat jarang terjadi. Hal ini juga harus 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. Ini akan memecahkan masalah reproduktifitassitas untuk lingkungan sistem – yaitu, “versi /usr/bin/c++ mana yang saya butuhkan?”

Docker tidak menangani masalah terkait perubahan dalam hal kode sumber. Menjalankan Make dengan Makefile yang tidak ditulis dengan benar di dalam container Docker masih dapat memberikan hasil yang tidak dapat diprediksi.

Di dalam Google, kami memeriksa alat untuk mengontrol sumber agar dapat direproduksi. Dengan cara ini, kita dapat memeriksa perubahan pada alat ("upgrade GCC ke 4.6.1") dengan mekanisme yang sama seperti perubahan pada library dasar ("pemeriksaan batas perbaikan di OpenSSL").

Dapatkah saya mem-build biner untuk deployment di Docker?

Dengan Bazel, Anda dapat membuat biner mandiri yang ditautkan secara statis di C/C++, dan file jar mandiri untuk Java. Ini berjalan dengan beberapa dependensi pada sistem UNIX normal, dan oleh karena itu harus sederhana untuk diinstal dalam container Docker.

Bazel memiliki konvensi untuk penyusunan struktur program yang lebih kompleks, misalnya, program Java yang menggunakan sekumpulan file data, atau menjalankan program lain sebagai subproses. Anda dapat mengemas lingkungan seperti arsip mandiri, sehingga lingkungan tersebut dapat di-deploy di sistem yang berbeda, termasuk image Docker.

Dapatkah saya membuat image Docker dengan Bazel?

Ya, Anda dapat menggunakan aturan Docker kami untuk membuat gambar 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-langkah build yang melibatkan resep kustom (misalnya, menjalankan biner melalui skrip shell di dalam aturan), Anda harus lebih berhati-hati:

  • Jangan gunakan dependensi yang tidak dideklarasikan. Eksekusi dengan sandbox (–spawn_strategy=sandbox, hanya di Linux) dapat membantu menemukan dependensi yang tidak dideklarasikan.
  • Hindari menyimpan stempel waktu dan User-ID dalam file yang dibuat. File ZIP dan arsip lainnya sangat rentan terhadap masalah ini.
  • Hindari terhubung ke jaringan. Eksekusi dengan sandbox juga dapat membantu di sini.
  • Hindari proses yang menggunakan angka acak, khususnya, traversal kamus secara acak dalam 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 Bazel berinteroperasi 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 tersebut.

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

Bazel menampilkan kode keluar bukan nol jika pemanggilan build atau pengujian gagal, dan ini seharusnya cukup untuk integrasi CI dasar. Karena Bazel tidak memerlukan clean build untuk ketepatan, sistem CI tidak boleh dikonfigurasi untuk membersihkan sebelum memulai build/pengujian yang dijalankan.

Detail selengkapnya tentang kode keluar ada di Panduan Pengguna.

Fitur apa saja yang dapat kami harapkan di Bazel?

Lihat Roadmap kami.

Dapatkah saya menggunakan Bazel untuk project INSERT LANGUAGE HERE?

Bazel dapat diperluas. Siapa saja dapat menambahkan dukungan untuk bahasa baru. Ada banyak bahasa yang didukung, lihat ensiklopedia build untuk daftar rekomendasi dan awesomebazel.com untuk daftar yang lebih lengkap.

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

Dapatkah saya berkontribusi pada code base Bazel?

Lihat pedoman kontribusi kami.

Mengapa tidak semua pengembangan dilakukan secara terbuka?

Kami masih harus memfaktorkan ulang antarmuka antara kode publik di Bazel dan ekstensi internal kami secara rutin. Hal ini menyulitkan Anda melakukan banyak pengembangan secara terbuka.

Apakah Anda sudah menyelesaikan Bazel open source?

Bazel open source sedang dalam proses. Khususnya, kami masih mengupayakan open source:

  • Banyak dari pengujian unit dan integrasi kami (yang seharusnya akan membuat patch kontribusi yang lebih mudah).
  • Integrasi IDE lengkap.

Selain kode, pada akhirnya kami ingin semua peninjauan kode, pelacakan bug, dan keputusan desain dilakukan secara publik, dengan melibatkan komunitas Bazel. Belum ada, jadi beberapa perubahan hanya akan muncul di repositori Bazel tanpa penjelasan yang jelas. Terlepas dari kurangnya transparansi ini, kami ingin mendukung developer eksternal dan berkolaborasi. Karena itu, kami membuka kode, meskipun beberapa pengembangan masih terjadi secara internal untuk Google. Harap beri tahu kami jika ada yang terlihat tidak jelas atau tidak wajar saat kami beralih ke model terbuka.

Apakah ada bagian dari Bazel yang tidak akan pernah menjadi open source?

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

Bagaimana cara menghubungi tim?

Kami dapat dihubungi di bazel-Diskusi@googlegroups.com.

Di mana saya dapat melaporkan bug?

Buka masalah di GitHub.

Ada apa dengan kata “Blaze” di codebase?

Ini adalah nama internal untuk alat. Sebut nama Bazel sebagai Bazel.

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

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 merupakan masalah untuk membangun aplikasi Windows, seperti Chrome. Karena project telah matang dan menjadi lebih stabil, Project Open Source Android sedang dalam proses migrasi ke Bazel.

Bagaimana cara mengucapkan “Bazel”?

Cara yang sama seperti "basil" (herba) dalam bahasa Inggris AS: “BAY-zel”. Sajak dengan “hazel”. IPA: /\tbe⁠zæãl/