Mengonfigurasi perlindungan cabang

Halaman ini menjelaskan cara mengonfigurasi perlindungan cabang untuk repositori Secure Source Manager.

Perlindungan cabang memungkinkan administrator repositori menetapkan aturan untuk mengontrol siapa yang dapat membuat perubahan pada cabang, siapa yang perlu menyetujui atau meninjau perubahan, dan kondisi apa yang harus dipenuhi sebelum perubahan yang disetujui dapat digabungkan ke dalam cabang.

Untuk mengetahui informasi selengkapnya tentang aturan perlindungan cabang, lihat Ringkasan perlindungan cabang.

Sebelum memulai

  1. Buat instance Secure Source Manager.
  2. Buat repositori Secure Source Manager.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengonfigurasi aturan perlindungan cabang untuk repositori Secure Source Manager, minta administrator Anda untuk memberikan peran IAM berikut:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi tentang pemberian peran Secure Source Manager, lihat Kontrol akses dengan IAM dan Memberikan akses instance kepada pengguna.

Membuat aturan perlindungan cabang

Konsol

Untuk membuat aturan perlindungan cabang baru, lakukan hal berikut:

  1. Di antarmuka web Secure Source Manager, pilih repositori yang ingin Anda lindungi dengan aturan perlindungan cabang.
  2. Dari halaman repositori, klik Settings.
  3. Klik tab Branch rule.
  4. Klik Add branch rule.

  5. Di kolom Branch rule ID, masukkan nama untuk aturan cabang.

    ID aturan cabang hanya boleh berisi huruf kecil, angka, dan tanda hubung. Karakter pertama harus berupa huruf, dan karakter terakhir harus berupa huruf atau angka. ID aturan cabang memiliki maksimum 63 karakter.

  6. Di kolom Branch filter, masukkan nama cabang yang ingin Anda terapkan aturannya, atau jika Anda ingin aturan tersebut berlaku untuk semua cabang, masukkan .*. Pencocokan ekspresi reguler lengkap tidak didukung.

    Filter aturan cabang yang diaktifkan harus unik untuk repositorinya. Pengguna dapat memiliki beberapa filter aturan cabang yang dinonaktifkan. Misalnya, Anda tidak dapat memiliki dua aturan cabang yang diaktifkan dalam satu repositori dengan filter cabang main.

    Jika beberapa aturan berlaku untuk cabang, aturan cabang dengan nama cabang tertentu sebagai filter cabang akan mengganti aturan karakter pengganti. Misalnya, aturan cabang dengan filter cabang main akan mengganti aturan cabang dengan filter cabang .*. Aturan tidak digabungkan.

  7. Di bagian Branch protection rule details, tentukan persyaratan untuk aturan cabang Anda dari opsi berikut:

    • Require a pull request before merging: jika diaktifkan, commit langsung ke cabang akan diblokir. Permintaan pull harus dibuka sebelum digabungkan ke cabang yang dilindungi.

    • Jumlah peninjau yang diperlukan: tentukan jumlah peninjau yang diperlukan untuk menyetujui penggabungan permintaan pull.

    • Jumlah pemberi persetujuan yang diperlukan: tentukan jumlah pemberi persetujuan yang diperlukan untuk menyetujui penggabungan permintaan pull.

      Peninjau dan pemberi persetujuan adalah pengguna dengan peran IAM tertentu. Untuk mempelajari peran mana yang diperlukan untuk peninjau dan pemberi persetujuan, lihat Ringkasan perlindungan cabang.

    • Block merge on stale reviews and approvals: jika diaktifkan, peninjauan atau persetujuan akan dihapus jika commit baru di-push ke permintaan pull setelah peninjauan atau persetujuan diberikan.

    • Require conversation resolution before merging: jika diaktifkan, semua komentar kode dan permintaan perubahan peninjauan harus diselesaikan sebelum digabungkan.

    • Wajibkan histori linear: jika diaktifkan, permintaan pull yang akan membuat histori Git non-linear tidak dapat digabungkan.

    • Periksa status yang diperlukan: jika diaktifkan, pemeriksaan status build yang dipilih harus berhasil sebelum permintaan pull dapat digabungkan. Anda harus mengonfigurasi pemicu dalam file pemicu sebelum dapat memilihnya sebagai pemeriksaan status untuk perlindungan cabang.

  8. Untuk menyimpan aturan cabang, klik Submit.

Tab Branch rules akan ditampilkan, dengan aturan cabang baru Anda tercantum.

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform. Untuk mengetahui informasi selengkapnya, lihat Terraform dokumentasi referensi penyedia.

Untuk membuat aturan perlindungan cabang baru dengan Terraform, gunakan google_secure_source_manager_branch_rule resource.

Contoh konfigurasi berikut membuat aturan perlindungan cabang untuk cabang main.

Sebelum menggunakan sampel, ganti hal berikut:

  • BRANCH_RULE_ID: ID aturan perlindungan cabang.
  • PROJECT_ID: project ID.
  • LOCATION: lokasi repositori.
  • REPOSITORY_ID: ID repositori.
  • BRANCH_NAME_PATTERN: nama cabang atau pola regex, seperti main.
resource "google_secure_source_manager_branch_rule" "default" {
  branch_rule_id = "BRANCH_RULE_ID"
  project = "PROJECT_ID"
  location = "LOCATION"
  repository_id = "REPOSITORY_ID"
  include_pattern = "BRANCH_NAME_PATTERN"
  minimum_approvals_count   = 2
  minimum_reviews_count     = 2
  require_comments_resolved = true
  require_linear_history    = true
  require_pull_request      = true
  disabled = false
  allow_stale_reviews = false
}

Mengubah aturan perlindungan cabang

Untuk mengubah aturan perlindungan cabang, lakukan hal berikut:

  1. Di antarmuka web Secure Source Manager, pilih repositori dengan aturan perlindungan cabang yang ingin Anda ubah.
  2. Dari halaman repositori, klik Settings.
  3. Klik tab Branch rules.
  4. Klik nama aturan cabang yang ingin Anda ubah.
  5. Edit aturan perlindungan cabang.
  6. Klik Update.

Aturan perlindungan cabang akan diperbarui.

Menghapus aturan perlindungan cabang

Untuk menghapus aturan perlindungan cabang, lakukan hal berikut:

  1. Di antarmuka web Secure Source Manager, pilih repositori yang ingin Anda hapus aturan cabangnya.
  2. Dari halaman repositori, klik Settings.
  3. Klik tab Branch rule.
  4. Di baris aturan yang ingin Anda hapus, klik ikon Delete delete.
  5. Di layar konfirmasi Remove branch rule, klik Yes.

Aturan perlindungan cabang akan dihapus.

Langkah berikutnya