Configurar uma política de ramificação para um serviço externo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

As políticas de filial são um recurso poderoso para garantir código de alta qualidade em seu repositório, estabelecendo requisitos para todas as solicitações pull. Os serviços externos podem usar a API de status de RP para postar status detalhado em seus RPs. A política de filial para serviços externos traz a capacidade para esses serviços de terceiros de participar do fluxo de trabalho de RP e estabelecer requisitos de política. Este artigo orienta você pelo processo de configuração de uma política de filial para um serviço que está postando status de RP. Para obter mais informações sobre o status de RP, consulte Personalizar e estender fluxos de trabalho de solicitação pull com status de solicitação pull.

Pré-requisitos

• Uma organização no Azure DevOps com um repositório Git. Se você não tiver uma organização, inscreva-se para carregar e compartilhar código em repositórios Git privados ilimitados e gratuitos.
• Um serviço que publica status para RPs. Consulte Criar um servidor de status de solicitação pull.

Configurar a política de ramificação

1. Navegue até Ramificações de código>e localize a ramificação na qual você deseja configurar a política (normalmente main ou develop). No menu de contexto, selecione a opção Políticas de filial .

   

2. Desloque-se para baixo para encontrar Verificações de estado. Selecione o botão +.

   

3. Selecione o serviço para o qual deseja criar uma política na lista. Se o status foi postado anteriormente, você pode escolhê-lo na lista; Se for uma nova política, você pode digitar o nome da política.

   

   • O requisito de política determina se essa política é opcional ou necessária para concluir solicitações pull na ramificação.
   • A identidade autorizada é usada para impor esse status somente a identidade especificada será contada para o cumprimento da política.
   • As condições de redefinição são usadas para determinar quando um status postado não é mais válido. Se o status postado for específico para o código mais recente (ou seja, uma compilação), marque Redefinir status sempre que houver novas alterações para redefinir o status quando a ramificação de origem for alterada.
   • Opcionalmente, defina um filtro de caminho. Saiba mais sobre filtros de caminho em políticas de filial.
   • A aplicabilidade da política determina se essa política se aplica assim que uma solicitação pull é criada ou se a política se aplica somente depois que o primeiro status é postado na solicitação pull.
   • O nome de exibição padrão permite que você especifique um nome de exibição opcional para sua política.

Criar um novo pull request

1. Crie uma nova solicitação pull na ramificação onde a política está definida. Para obter mais informações, consulte Criar uma solicitação pull.

2. Depois de criar o PR, a nova política aparecerá na seção Políticas da visualização de detalhes de RP. Inicialmente, a política aparecerá como não definida até que o serviço externo tenha postado o status.

   

   Quando o serviço tiver publicado o status, a política será atualizada de acordo. A conclusão será bloqueada até que a política aprove o PR.

   

   Quando os critérios da política forem atendidos e o serviço postar um succeeded status, o PR será aprovado e a conclusão será desbloqueada.

   

Resumo

Neste artigo, você aprendeu como configurar uma política de filial para um serviço externo.