Men-debug Hit Cache Jarak Jauh untuk Eksekusi Lokal

Laporkan masalah Lihat sumber Nightly · 7.4 .

Halaman ini menjelaskan cara menyelidiki cache yang tidak ditemukan dalam konteks eksekusi lokal.

Halaman ini mengasumsikan bahwa Anda memiliki build dan/atau pengujian yang berhasil di-build secara lokal dan disiapkan untuk menggunakan penyimpanan dalam cache jarak jauh, dan bahwa Anda ingin memastikan bahwa cache jarak jauh digunakan secara efektif.

Untuk mengetahui tips mengenai cara memeriksa tingkat penemuan cache dan cara membandingkan log eksekusi antara dua pemanggilan Bazel, lihat Men-debug Hit Cache Jarak Jauh untuk Eksekusi Jarak Jauh. Semua yang disajikan dalam panduan tersebut juga berlaku untuk caching jarak jauh dengan eksekusi lokal. Namun, eksekusi lokal menghadirkan beberapa tantangan tambahan.

Memeriksa rasio hit cache

Hit cache jarak jauh yang berhasil akan muncul di baris status, mirip dengan Rasio Hit Cache dengan Eksekusi Jarak Jauh.

Pada output standar proses Bazel, Anda akan melihat sesuatu seperti berikut:

   INFO: 7 processes: 3 remote cache hit, 4 linux-sandbox.

Artinya, dari 7 tindakan yang dicoba, 3 tindakan mendapatkan hit cache jarak jauh dan 4 tindakan tidak memiliki hit cache dan dieksekusi secara lokal menggunakan strategi linux-sandbox. Hit cache lokal tidak disertakan dalam ringkasan ini. Jika Anda mendapatkan 0 proses (atau angka yang lebih rendah dari yang diharapkan), jalankan bazel clean, diikuti dengan perintah build/pengujian Anda.

Memecahkan masalah hit cache

Jika Anda tidak mendapatkan rasio cache ditemukan yang diharapkan, lakukan hal berikut:

Memastikan keberhasilan komunikasi dengan endpoint jarak jauh

Untuk memastikan build Anda berhasil berkomunikasi dengan cache jarak jauh, ikuti langkah-langkah di bagian ini.

Memeriksa peringatan di output

Dengan eksekusi jarak jauh, kegagalan untuk berkomunikasi dengan endpoint jarak jauh akan membuat build Anda gagal. Di sisi lain, build lokal yang dapat di-cache tidak akan gagal jika tidak dapat menyimpan cache. Periksa output pemanggilan Bazel Anda untuk menemukan peringatan, seperti:
```
   WARNING: Error reading from the remote cache:
```
atau
```
   WARNING: Error writing to the remote cache:
```
Peringatan tersebut akan diikuti dengan pesan error yang menjelaskan masalah koneksi yang akan membantu Anda melakukan debug: misalnya, nama endpoint yang salah ketik atau kredensial yang ditetapkan dengan tidak benar. Temukan dan atasi error tersebut. Jika pesan error yang Anda lihat tidak memberi informasi yang cukup, coba tambahkan --verbose_failures.
Ikuti langkah-langkah dari Memecahkan masalah hit cache untuk eksekusi jarak jauh untuk memastikan bahwa pemanggilan Bazel yang menulis cache dapat mendapatkan hit cache di mesin yang sama dan di seluruh mesin.
Pastikan pemanggilan Bazel yang membaca cache dapat mendapatkan hit cache.

a. Karena pemanggilan Bazel yang membaca cache akan memiliki penyiapan command line yang berbeda, lakukan tindakan tambahan untuk memastikan bahwa penyiapannya dilakukan dengan benar untuk berkomunikasi dengan cache jarak jauh. Pastikan tanda --remote_cache ditetapkan dan tidak ada peringatan dalam output.

b. Pastikan pemanggilan Bazel yang membaca cache mem-build target yang sama dengan pemanggilan Bazel yang menulis cache.

c. Ikuti langkah-langkah yang sama seperti untuk memastikan penyimpanan dalam cache di seluruh mesin, untuk memastikan penyimpanan dalam cache dari pemanggilan Bazel yang menulis cache ke pemanggilan Bazel yang membaca cache.