Bu sayfada, yerel yürütme bağlamında önbelleğe alma hatalarının nasıl inceleneceği açıklanmaktadır.
Bu sayfada, yerel olarak başarılı bir şekilde derlenen ve uzaktan önbelleğe almayı kullanacak şekilde ayarlanmış bir derleme ve/veya testinizin olduğu ve uzak önbelleğin etkili bir şekilde kullanıldığından emin olmak istediğiniz varsayılır.
Önbellek isabet oranınızı nasıl kontrol edeceğiniz ve iki Bazel çağrısı arasındaki yürütme günlüklerini nasıl karşılaştıracağınıza dair ipuçları için Uzaktan Yürütme İçin Uzak Önbellek İsabetlerinde Hata Ayıklama bölümüne bakın. Bu kılavuzda sunulan her şey, yerel yürütmeyle uzak önbelleğe alma için de geçerlidir. Ancak yerel ölçekte uygulama bazı ek zorlukları beraberinde getirir.
Önbelleğe isabet oranınızı kontrol etme
Başarılı uzak önbellek isabetleri, Uzak yürütme ile önbellek isabeti oranına benzer şekilde durum satırında gösterilir.
Bazel çalıştırma işleminizin standart çıkışında aşağıdakine benzer bir şey görürsünüz:
INFO: 7 processes: 3 remote cache hit, 4 linux-sandbox.
Bu, 7 deneme işleminden 3'ünün uzak önbelleğe isabet aldığı, 4 işlemin ise önbelleğe isabet almadığı ve linux-sandbox
stratejisi kullanılarak yerel olarak yürütüldüğü anlamına gelir. Yerel önbellek isabetleri bu özete dahil değildir. 0 işlem (veya beklenenden düşük bir sayı) görüyorsanız bazel clean
'yi, ardından derleme/test komutunuzu çalıştırın.
Önbellek isabetleriyle ilgili sorunları giderme
Beklediğiniz önbellek isabet oranını alamıyorsanız aşağıdakileri yapın:
Uzak uç noktayla başarılı bir şekilde iletişim kurulmasını sağlayın
Derlemenizin uzak önbelleğe başarılı bir şekilde iletişim kurmasını sağlamak için bu bölümdeki adımları uygulayın.
Çıkışınızda uyarı olup olmadığını kontrol etme
Uzak yürütme işleminde, uzak uç noktayla iletişim kurulamadığında derleme işleminiz başarısız olur. Öte yandan, önbelleğe alınamayan önbelleğe alınabilir yerel derleme başarısız olmaz. Bazel çağrınızın çıktısını kontrol ederek aşağıdaki gibi uyarılar olup olmadığını kontrol edin:
WARNING: Error reading from the remote cache:
veya
WARNING: Error writing to the remote cache:
Bu tür uyarıların ardından, bağlantı sorununu ayrıntılarıyla açıklayan bir hata mesajı gösterilir. Bu mesaj, hata ayıklamanıza yardımcı olur (ör. yanlış yazılmış uç nokta adı veya yanlış ayarlanmış kimlik bilgileri). Bu tür hataları bulup giderin. Gördüğünüz hata mesajı size yeterli bilgi vermiyorsa
--verbose_failures
eklemeyi deneyin.Önbellek yazan Bazel çağrılarınızın aynı makinede ve makineler arasında önbellek isabetlerini alabilmesini sağlamak için Uzaktan yürütme için önbellek isabetleriyle ilgili sorunları giderme bölümündeki adımları uygulayın.
Önbelleği okuyan Bazel çağrılarınızın önbellek isabetlerini alabileceğinden emin olun.
a. Önbelleği okuyan Bazel çağrılarının farklı bir komut satırı yapılandırması olacağından, uzak önbellekle iletişim kuracak şekilde doğru şekilde ayarlandıklarına dikkat edin.
--remote_cache
işaretinin ayarlandığından ve çıkışta uyarı olmadığından emin olun.b. Önbelleği okuyan Bazel çağrılarınızın, önbelleğe yazan Bazel çağrılarıyla aynı hedefleri oluşturduğundan emin olun.
c. Önbellek yazan Bazel çağrınızdan önbellek okuyan Bazel çağrınıza önbelleğe alma işlemi yapılmasını sağlamak için makineler genelinde önbelleğe almayı sağlama ile aynı adımları uygulayın.