Cache artefak Vulkan yang dipakai beberapa worker perlu mencegah dua masalah: worker menimpa hasil satu sama lain, dan proses membaca berkas yang belum selesai ditulis. Solusinya adalah memisahkan artefak berdasarkan identitas lingkungan, mengunci proses pembangunan per key, lalu menerbitkan hasil melalui penulisan berkas sementara dan penggantian atomik.
Pola berikut dapat diterapkan pada NetBSD, tetapi tidak mengasumsikan perilaku khusus dari proyek vulkan-netbsd. Sesuaikan pemilihan primitive locking, lokasi cache, dan detail sinkronisasi berkas dengan API serta sistem berkas yang benar-benar digunakan.
Tentukan batas dan isi cache
Bedakan cache pipeline Vulkan dari cache hasil kompilasi shader milik aplikasi. Pipeline cache mengikuti format dan aturan Vulkan; cache shader dapat bergantung pada compiler, opsi build, dan format artefak aplikasi. Jangan menganggap kedua jenis berkas dapat dipertukarkan.
Simpan hanya artefak yang bisa dibuat ulang. Cache bukan sumber data utama: jika berkas hilang, tidak cocok, atau rusak, aplikasi harus dapat membangunnya kembali. Batasi ukuran cache dan tetapkan lokasi yang sesuai dengan kebijakan aplikasi; hindari menulis ke direktori yang dapat diubah pengguna lain.
Rancang key cache yang mencerminkan lingkungan
Key harus berubah ketika perubahan lingkungan dapat membuat artefak tidak kompatibel atau tidak lagi tepat digunakan. Untuk pipeline cache, ambil identitas perangkat dari properti Vulkan yang relevan, termasuk vendorID, deviceID, dan pipelineCacheUUID. Sertakan identitas driver, versi compiler shader yang digunakan aplikasi, serta konfigurasi yang memengaruhi hasil.
Contoh komponen key:
- Versi skema cache aplikasi.
- Identitas GPU dan UUID pipeline cache yang dilaporkan Vulkan.
- Versi driver yang tersedia bagi aplikasi; jangan mengasumsikan format atau semantiknya sama pada semua implementasi.
- Nama, versi, dan opsi compiler shader.
- Hash sumber shader atau input kompilasi, layout descriptor, opsi pipeline, dan konfigurasi build yang relevan.
Serialisasikan komponen secara deterministik sebelum menghitung hash. Hindari menggabungkan string tanpa pemisah yang tidak ambigu. Simpan manifest kecil bersama artefak agar penyebab ketidakcocokan dapat didiagnosis tanpa menebak isi nama berkas.
key = hash(serialize({
schema: cache_schema,
vendor_id: gpu.vendor_id,
device_id: gpu.device_id,
pipeline_cache_uuid: gpu.pipeline_cache_uuid,
driver_id: driver_identity,
compiler: compiler_name_and_version,
options: normalized_build_options,
input_hash: shader_and_pipeline_input_hash
}))Struktur tersebut hanya sketsa: pilih sumber nilai yang memang tersedia pada aplikasi. Jika identitas driver tidak dapat diperoleh secara andal, jangan mengarang nilainya; dokumentasikan kebijakan fallback dan gunakan invalidasi konservatif.
Penulisan atomik dan locking antarkerja
Gunakan satu berkas hasil per key dan satu lock per key. Worker yang memperoleh lock memeriksa ulang cache, membangun artefak hanya jika belum valid, lalu menulisnya ke berkas sementara di direktori yang sama. Setelah penulisan selesai dan validasi berhasil, ganti nama berkas sementara menjadi nama final. Penggantian dalam direktori yang sama umumnya merupakan dasar pola publikasi atomik, tetapi detail jaminan dan ketahanan terhadap mati listrik bergantung pada sistem berkas serta primitive yang dipakai.
- Buat direktori cache dengan izin yang membatasi akses sesuai kebutuhan.
- Ambil lock eksklusif untuk key. Gunakan primitive lock ant proses yang tersedia dan telah diverifikasi pada target; jangan mengandalkan mutex dalam memori untuk worker terpisah.
- Periksa ulang berkas final setelah lock diperoleh. Worker lain mungkin telah menyelesaikannya saat proses ini menunggu.
- Bangun artefak jika tidak ada hasil yang valid.
- Tulis ke berkas sementara unik pada sistem berkas yang sama, tangani kegagalan tulis, lalu validasi hasil.
- Terbitkan hasil dengan penggantian nama atomik sesuai semantik platform. Lepaskan lock setelah publikasi atau setelah pembersihan kegagalan.
Jika aplikasi harus mempertahankan cache saat terjadi mati listrik, bukan hanya menghindari pembacaan berkas setengah jadi, tentukan urutan sinkronisasi data dan metadata yang sesuai dengan sistem berkas target. Jangan mengklaim ketahanan tersebut tanpa pengujian. Hapus berkas sementara yang tertinggal secara aman saat pemeliharaan; jangan menghapus berkas yang mungkin masih dipakai worker aktif.
Invalidasi dan pemulihan artefak rusak
Invalidasi setelah perubahan driver
Perubahan identitas driver atau UUID pipeline cache harus menghasilkan key baru atau memicu penolakan artefak lama. Pendekatan berbasis key baru lebih aman daripada menimpa berkas lama: worker yang masih berjalan dapat menyelesaikan pekerjaan pada key lama tanpa mencampur hasil dengan lingkungan baru. Bersihkan key usang melalui kebijakan retensi, bukan sebagai bagian dari jalur kritis startup.
Jangan hanya mengandalkan nomor versi aplikasi. Perubahan compiler, opsi kompilasi, identitas perangkat, atau input pipeline juga dapat menuntut key baru. Untuk field yang tidak stabil atau tidak tersedia, pilih invalidasi konservatif daripada menggunakan artefak yang kesesuaiannya tidak dapat dipastikan.
Menangani berkas tidak valid
Validasi manifest, ukuran yang masuk akal, versi skema, dan hash konten sebelum memakai artefak. Saat membuat pipeline cache Vulkan, tangani kegagalan pembuatan cache dari data awal sesuai hasil API yang dikembalikan: catat diagnosis, karantina atau hapus artefak yang ditolak, lalu coba sekali lagi tanpa data cache jika jalur aplikasi mendukungnya. Jangan mengulang tanpa batas; kerusakan yang persisten harus berakhir sebagai error yang dapat diamati.
Jangan menghapus cache global hanya karena satu key gagal. Isolasi kerusakan pada artefak terkait, simpan log berisi key dan alasan penolakan tanpa membocorkan data sensitif, lalu biarkan aplikasi membangun ulang hasil tersebut.
Alur operasional dan pengujian
Alur worker
- Temukan perangkat Vulkan dan kumpulkan identitas serta konfigurasi yang dipakai untuk key.
- Hitung key deterministik dan periksa artefak yang sudah ada.
- Jika artefak tidak valid atau tidak ada, ambil lock per key dan periksa ulang.
- Bangun, validasi, dan terbitkan artefak secara atomik.
- Baca artefak final, catat hit, miss, kegagalan, dan invalidasi, lalu lepaskan lock.
Strategi pengujian
- Determinisme: masukkan komponen input yang sama dalam urutan berbeda dan pastikan serialisasi serta key tetap sama; ubah satu komponen penting dan pastikan key berubah.
- Konkurensi: jalankan banyak worker untuk key yang sama. Pastikan hanya satu pembangunan aktif pada satu waktu, semua pembaca memperoleh artefak valid, dan tidak ada hasil parsial.
- Key berbeda: jalankan worker untuk key berlainan dan pastikan lock satu key tidak menghalangi pekerjaan yang tidak terkait.
- Gangguan proses: hentikan worker saat menulis sementara. Pastikan artefak final lama tetap valid atau artefak baru tidak terbit, lalu pastikan worker berikutnya dapat pulih.
- Kerusakan dan invalidasi: ubah byte artefak, manifest, versi skema, serta identitas driver simulasi. Pastikan artefak ditolak dan dibangun ulang tanpa loop retry.
- Kegagalan berkas: uji direktori tidak dapat ditulis, ruang habis, kegagalan lock, dan kegagalan penggantian nama. Pastikan error dilaporkan dan tidak ada cache final yang dianggap valid tanpa verifikasi.
Jalankan pengujian pada sistem berkas dan primitive lock yang digunakan di NetBSD target. Pengujian unit pada platform lain tidak membuktikan semantik locking atau ketahanan publikasi berkas pada target tersebut.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!