Hermetik

Nightly · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 7.7

Halaman ini membahas hermetisitas, manfaat penggunaan build hermetis, dan strategi untuk mengidentifikasi perilaku non-hermetis dalam build Anda.

Ringkasan

Jika diberi kode sumber input dan konfigurasi produk yang sama, sistem build hermetis akan selalu menampilkan output yang sama dengan mengisolasi build dari perubahan pada sistem host.

Untuk mengisolasi build, build hermetis tidak sensitif terhadap library dan software lain yang diinstal di mesin host lokal atau jarak jauh. Build hermetis bergantung pada versi tertentu dari alat build, seperti compiler, dan dependensi, seperti library. Hal ini membuat proses build mandiri karena tidak bergantung pada layanan eksternal ke lingkungan build.

Dua aspek penting dari hermetisitas adalah:

  • Isolasi: Sistem build hermetis memperlakukan alat sebagai kode sumber. Sistem ini mendownload salinan alat dan mengelola penyimpanan serta penggunaannya di dalam hierarki file yang dikelola. Hal ini menciptakan isolasi antara mesin host dan pengguna lokal, termasuk versi bahasa yang diinstal.
  • Identitas sumber: Sistem build hermetis mencoba memastikan kesamaan input. Repositori kode, seperti Git, mengidentifikasi kumpulan mutasi kode dengan kode hash unik. Sistem build hermetis menggunakan hash ini untuk mengidentifikasi perubahan pada input build.

Manfaat

Manfaat utama build hermetis adalah:

  • Kecepatan: Output tindakan dapat di-cache, dan tindakan tidak perlu di jalankan lagi kecuali jika input berubah.
  • Eksekusi paralel: Untuk input dan output tertentu, sistem build dapat membuat grafik semua tindakan untuk menghitung eksekusi yang efisien dan paralel. Sistem build memuat aturan dan menghitung grafik tindakan serta input hash untuk dicari di cache.
  • Beberapa build: Anda dapat membuat beberapa build hermetis di mesin yang sama, dengan setiap build menggunakan alat dan versi yang berbeda.
  • Reproduksibilitas: Build hermetis berguna untuk memecahkan masalah karena Anda mengetahui kondisi persis yang menghasilkan build.

Mengidentifikasi non-hermetisitas

Jika Anda bersiap untuk beralih ke Bazel, migrasi akan lebih mudah jika Anda meningkatkan hermetisitas build yang ada terlebih dahulu. Beberapa sumber umum non-hermetisitas dalam build adalah:

  • Pemrosesan arbitrer dalam .mk file
  • Tindakan atau alat yang membuat file secara non-deterministik, biasanya melibatkan ID build atau stempel waktu
  • Biner sistem yang berbeda di seluruh host (seperti /usr/bin biner, jalur absolut, compiler C++ sistem untuk konfigurasi otomatis aturan C++ native)
  • Menulis ke hierarki sumber selama build. Hal ini mencegah hierarki sumber yang sama digunakan untuk target lain. Build pertama menulis ke hierarki sumber, memperbaiki hierarki sumber untuk target A. Kemudian, mencoba membuat target B mungkin akan gagal.

Memecahkan masalah build non-hermetis

Dimulai dengan eksekusi lokal, masalah yang memengaruhi hit cache lokal akan mengungkapkan tindakan non-hermetis.

  • Pastikan build berurutan null: Jika Anda menjalankan make dan mendapatkan build yang berhasil, menjalankan build lagi tidak akan membangun ulang target apa pun. Jika Anda menjalankan setiap langkah build dua kali atau pada sistem yang berbeda, bandingkan hash konten file dan dapatkan hasil yang berbeda, build tidak dapat direproduksi.
  • Jalankan langkah-langkah untuk men-debug hit cache lokal dari berbagai mesin klien potensial untuk memastikan Anda menangkap kasus lingkungan klien yang bocor ke dalam tindakan.
  • Jalankan build dalam container Docker yang hanya berisi hierarki sumber yang di-checkout dan daftar alat host eksplisit. Kerusakan build dan pesan error akan menangkap dependensi sistem implisit.
  • Temukan dan perbaiki masalah hermetisitas menggunakan aturan eksekusi jarak jauh.
  • Aktifkan sandboxing ketat sandboxing di tingkat per tindakan, karena tindakan dalam build dapat bersifat stateful dan memengaruhi build atau output.
  • Aturan ruang kerja memungkinkan developer menambahkan dependensi ke ruang kerja eksternal, tetapi aturan tersebut cukup kaya untuk memungkinkan pemrosesan arbitrer terjadi dalam proses. Anda bisa mendapatkan log beberapa tindakan yang berpotensi non-hermetis dalam aturan ruang kerja Bazel dengan menambahkan flag --experimental_workspace_rules_log_file=PATH ke perintah Bazel.

Hermetisitas dengan Bazel

Untuk mengetahui informasi selengkapnya tentang keberhasilan proyek lain menggunakan build hermetis dengan Bazel, lihat presentasi BazelCon berikut: