CodeOwner adalah mekanisme yang digunakan untuk menentukan pemilik file atau tipe file tertentu, sehingga tugas peninjauan dapat dialokasikan secara otomatis dalam skenario seperti tinjauan kode dan permintaan penggabungan.
CodeOwner
Dalam Code Review, penulis sering kesulitan mengidentifikasi reviewer terbaik. CodeOwner mengatasi hal ini dengan menggunakan file CODEOWNERS untuk mendefinisikan secara eksplisit individu yang bertanggung jawab atas setiap file atau modul. File ini ditempatkan di direktori root cabang, dan sistem secara otomatis mencocokkan reviewer berdasarkan isinya. Setelah CodeOwner diaktifkan, sistem akan mencari file CODEOWNERS di direktori root cabang target dan membaca pengaturannya.
Jika sebuah file hanya memiliki satu pemilik, tinjauan dari pemilik tersebut bersifat wajib.
Jika sebuah file memiliki beberapa pemilik (seperti A, B, dan C), persetujuan dari salah satu dari mereka sudah cukup. Sistem secara otomatis mendeteksi dan menambahkan pemilik terkait ke daftar tinjauan.
Ketika tidak ada pemilik yang cocok ditemukan, setidaknya satu orang harus melakukan tinjauan sebagai cadangan. Sistem mengikuti aturan paling spesifik dan eksplisit untuk pencocokan file, dengan satu aturan per file.
Asumsikan file CODEOWNERS mendefinisikan jalur berikut:
f.txt cocok tepat dengan aturan **@user1.
aa/f.txt cocok tepat dengan aturan aa/**@user2.
aa/mm/f.txt cocok tepat dengan aturan aa/mm/**@user3.
bb/f.txt cocok tepat dengan aturan bb/**@user4.Setiap file dapat dicocokkan dengan aturan yang sesuai, membuat proses lebih efisien dan akurat.
Dalam file CODEOWNERS, definisi jalur menggunakan pola Glob, mirip dengan perintah find pada Linux atau aturan .gitignore pada Git. Pemilik ditentukan menggunakan @username, di mana username harus merupakan alamat email utama yang diverifikasi. Untuk memeriksa alamat email utama, navigasikan ke .
Contoh:
# Baris komentar. Isi konfigurasi adalah sebagai berikut. Setiap baris mewakili satu konfigurasi.
# Setelah aturan jalur, satu atau lebih Pemilik harus dikonfigurasikan.
# Pengguna A@example.com dan B@example.com adalah CodeOwners untuk semua file.
** @A@example.com @B@example.com
# Pengguna C@example.com adalah CodeOwner untuk semua file Java.
**.java @C@example.com
# Pengguna D@example.com dan E@example.com adalah CodeOwners untuk file di bawah direktori force-api.
force-api/** @D@example.com @E@example.com
# Pengguna F@example.com adalah CodeOwner untuk file di bawah direktori force-base/src/main/java.
force-base/src/main/java/** @F@example.com