Share via


Een vertakkingsbeleid configureren voor een externe service

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Vertakkingsbeleid is een krachtige functie om code van hoge kwaliteit in uw opslagplaats te garanderen door vereisten vast te stellen voor alle pull-aanvragen. Externe services kunnen de PR-status-API gebruiken om gedetailleerde status te posten op uw PULL's. Het vertakkingsbeleid voor externe services biedt de mogelijkheid voor deze services van derden om deel te nemen aan de pull-werkstroom en beleidsvereisten vast te stellen. In dit artikel wordt u begeleid bij het configureren van een vertakkingsbeleid voor een service die de pr-status plaatst. Zie Werkstromen voor pull-aanvragen aanpassen en uitbreiden met de status van de pull-aanvraag voor meer informatie over pr-status.

Vereisten

  • Een organisatie in Azure DevOps met een Git-opslagplaats. Als u geen organisatie hebt, meldt u zich aan om code te uploaden en te delen in gratis onbeperkte privĂ©-Git-opslagplaatsen.
  • Een service die de status aan PULL's plaatst. Zie Een statusserver voor pull-aanvragen maken.

Het vertakkingsbeleid configureren

  1. Navigeer naar codevertakkingen> en zoek de vertakking waarvoor u het beleid wilt configureren (meestal main ofdevelop). Selecteer in het contextmenu de optie Vertakkingsbeleid .

    Vertakkingsbeleid selecteren in het contextmenu

  2. Schuif omlaag om statuscontroles te vinden. Selecteer de knop +.

    Selecteer de knop Beleid toevoegen

  3. Selecteer de service waarvoor u een beleid wilt maken in de lijst. Als de status eerder is gepost, kunt u deze kiezen in de lijst; als het een nieuw beleid is, kunt u de naam van het beleid typen.

    Selecteer het beleid in de lijst

    • De beleidsvereiste bepaalt of dit beleid optioneel of vereist is om pull-aanvragen in de vertakking te voltooien.
    • Geautoriseerde identiteit wordt gebruikt om die status van alleen de opgegeven identiteit af te dwingen voor de uitvoering van het beleid.
    • Voorwaarden voor opnieuw instellen worden gebruikt om te bepalen wanneer een geplaatste status niet meer geldig is. Als de status die is gepost specifiek is voor de meest recente code (bijvoorbeeld een build), controleert u de status opnieuw instellen wanneer er nieuwe wijzigingen zijn om de status opnieuw in te stellen wanneer de bronbranch verandert.
    • U kunt desgewenst een padfilter instellen. Meer informatie over padfilters in vertakkingsbeleid.
    • De toepasselijkheid van het beleid bepaalt of dit beleid van toepassing is zodra een pull-aanvraag is gemaakt of of het beleid pas van toepassing is nadat de eerste status op de pull-aanvraag is geplaatst.
    • Met de standaardweergavenaam kunt u een optionele weergavenaam voor uw beleid opgeven.

Een nieuwe pull-aanvraag maken

  1. Maak een nieuwe pull-aanvraag in de vertakking waarin het beleid is gedefinieerd. Zie Een pull-aanvraag maken voor meer informatie.

  2. Nadat u de pull-aanvraag hebt gemaakt, wordt het nieuwe beleid weergegeven in de sectie Beleid van de detailweergave van de pull-aanvraag. In eerste instantie wordt het beleid weergegeven als niet ingesteld totdat de externe service de status heeft gepost.

    Beleidsstatus is zichtbaar in de sectie Beleid

    Wanneer de service de status heeft gepost, wordt het beleid dienovereenkomstig bijgewerkt. Voltooiing wordt geblokkeerd totdat het beleid de pull-aanvraag goedkeurt.

    Beleidsstatusupdates

    Wanneer aan de beleidscriteria wordt voldaan en de service een succeeded status plaatst, wordt de pull-aanvraag goedgekeurd en wordt de voltooiing opgeheven.

    Goedgekeurde beleidsstatus en voltooiing opgeheven

Samenvatting

In dit artikel hebt u geleerd hoe u een vertakkingsbeleid voor een externe service configureert.