Bagikan melalui


Mengonfigurasi kebijakan cabang bagi layanan eksternal

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Kebijakan cabang adalah fitur yang kuat untuk memastikan kode berkualitas tinggi di repositori Anda dengan menetapkan persyaratan untuk semua permintaan pull. Layanan eksternal dapat menggunakan PR Status API untuk memposting status terperinci ke PR Anda. Kebijakan cabang untuk layanan eksternal membawa kemampuan bagi layanan pihak ke-3 tersebut untuk berpartisipasi dalam alur kerja PR dan menetapkan persyaratan kebijakan. Artikel ini memandu Anda melalui proses konfigurasi kebijakan cabang untuk layanan yang memposting status PR. Untuk informasi selengkapnya tentang status PR, lihat Menyesuaikan dan memperpanjang alur kerja permintaan pull dengan status permintaan pull.

Prasyarat

  • Organisasi di Azure DevOps dengan repositori Git. Jika Anda tidak memiliki organisasi, daftar untuk mengunggah dan berbagi kode di repositori Git privat tanpa batas gratis.
  • Layanan yang memposting status ke PR. Lihat Membuat server status permintaan pull.

Mengonfigurasi kebijakan cabang

  1. Navigasi ke Cabang Kode>dan temukan cabang tempat Anda ingin mengonfigurasi kebijakan (biasanya main atau develop). Dari menu konteks, pilih opsi Kebijakan cabang.

    Pilih Kebijakan cabang dari menu konteks

  2. Gulir ke bawah untuk menemukan pemeriksaan Status. Pilih tombol +.

    Pilih tombol Tambahkan kebijakan

  3. Pilih layanan yang ingin Anda buat kebijakannya dari daftar. Jika status telah diposting sebelumnya, Anda dapat memilihnya dari daftar; jika itu adalah kebijakan baru, Anda dapat mengetikkan nama kebijakan.

    Pilih kebijakan dari daftar

    • Persyaratan kebijakan menentukan apakah kebijakan ini opsional atau tidak diperlukan untuk menyelesaikan permintaan pull ke cabang.
    • Identitas resmi digunakan untuk memberlakukan status tersebut hanya dari identitas yang ditentukan yang akan dihitung dalam pemenuhan kebijakan.
    • Kondisi reset digunakan untuk menentukan kapan status yang diposting tidak lagi valid. Jika status yang diposting khusus untuk kode terbaru (yaitu build), periksa Reset status setiap kali ada perubahan baru untuk mengatur ulang status saat cabang sumber berubah.
    • Secara opsional atur filter Jalur. Pelajari selengkapnya tentang filter jalur dalam kebijakan cabang.
    • Penerapan kebijakan menentukan apakah kebijakan ini berlaku segera setelah permintaan pull dibuat, atau apakah kebijakan hanya berlaku setelah status pertama diposting ke permintaan pull.
    • Nama tampilan default memungkinkan Anda menentukan nama tampilan opsional untuk kebijakan Anda.

Membuat permintaan pull baru

  1. Buat permintaan pull baru ke cabang tempat kebijakan ditentukan. Untuk informasi selengkapnya, lihat Membuat permintaan pull.

  2. Setelah membuat PR, kebijakan baru akan muncul di bagian Kebijakan dari tampilan detail PR. Awalnya, kebijakan akan muncul sebagai tidak ditetapkan sampai layanan eksternal telah memposting status.

    Status kebijakan terlihat di bagian Kebijakan

    Ketika layanan telah memposting status, kebijakan akan diperbarui sesuai. Penyelesaian akan diblokir hingga kebijakan menyetujui PR.

    Pembaruan status kebijakan

    Ketika kriteria kebijakan terpenuhi, dan layanan memposting succeeded status, PR akan disetujui dan penyelesaian akan dibuka blokirnya.

    Status kebijakan disetujui dan penyelesaian tidak diblokir

Ringkasan

Dalam artikel ini, Anda mempelajari cara mengonfigurasi kebijakan cabang untuk layanan eksternal.