Mode review CodeOwner memungkinkan Anda menentukan pemilik untuk file atau jenis file tertentu agar sistem secara otomatis menetapkan reviewer pada tinjauan kode dan permintaan merge.
Mode tinjauan kode
Mode review CodeOwner menggunakan file CODEOWNERS untuk menentukan pihak yang bertanggung jawab atas setiap file atau modul. Tempatkan file tersebut di direktori root sebuah branch. Saat mode review CodeOwner diaktifkan, sistem secara otomatis mencocokkan reviewer berdasarkan file CODEOWNERS di branch target.
-
Jika suatu file hanya memiliki satu pemilik, pemilik tersebut harus menyetujui perubahan tersebut.
-
Jika suatu file memiliki beberapa pemilik—misalnya A, B, dan C—persetujuan dari salah satu pemilik sudah cukup. Sistem secara otomatis menambahkan semua pemilik terkait ke daftar reviewer.
-
Jika tidak ditemukan pemilik yang sesuai, setidaknya satu orang harus melakukan review. Jika beberapa pola cocok dengan path file, pola terakhir yang cocok dalam file CODEOWNERS yang digunakan sebagai acuan utama.
Sebagai contoh, pertimbangkan path berikut yang didefinisikan dalam file CODEOWNERS:
f.txt matches the ** @user1 rule
aa/f.txt matches the aa/** @user2 rule
aa/mm/f.txt matches the aa/mm/** @user3 rule
bb/f.txt matches the bb/** @user4 ruleSetiap file dicocokkan dengan aturan yang paling spesifik, sehingga proses review menjadi lebih efisien dan akurat.
Pada halaman Branch Settings repositori Anda, pilih branch protected target, seperti feature/sensitive_scan, lalu ubah aturan proteksinya. Di kotak dialog, aktifkan Require code review before merging, pilih Require all comments to be resolved, dan atur mode review ke CodeOwner.
Path dalam file CODEOWNERS menggunakan pola glob, mirip dengan perintah find di Linux atau aturan .gitignore Git. Gunakan format @username untuk menentukan pemilik, di mana username adalah alamat email primary pengguna yang telah diverifikasi. Untuk melihat alamat email primary Anda, buka .
Pada halaman Personal Settings, pilih Personal Information dari panel navigasi kiri. Di bagian Email, alamat yang diberi label Primary Email adalah alamat email primary Anda yang telah diverifikasi.
Sebagai contoh:
# Ini adalah baris komentar. Baris-baris berikut merupakan entri konfigurasi, satu per baris.
# Pola path harus diikuti oleh satu atau beberapa pemilik.
# Tetapkan pengguna A@example.com dan B@example.com sebagai CodeOwner untuk semua file.
** @A@example.com @B@example.com
# Tetapkan pengguna C@example.com sebagai CodeOwner untuk semua file .java.
**.java @C@example.com
# Tetapkan pengguna D@example.com dan E@example.com sebagai CodeOwner untuk file di direktori force-api/.
force-api/** @D@example.com @E@example.com
# Tetapkan pengguna F@example.com sebagai CodeOwner untuk file di direktori force-base/src/main/java/.
force-base/src/main/java/** @F@example.com