Configurar uma política de filial 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 do PR para publicar um status detalhado nos seus PRs. 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 mais informações sobre o estado da solicitação pull, consulte Personalizar e expandir fluxos de trabalho de solicitação pull com status de solicitação pull.

Pré-requisitos

Categoria	Requerimentos
Acesso ao projeto	Membro de um projeto .
Permissões	- Ver código em projetos privados: Acesso pelo menos Básico. - Clone ou contribua para o código em projetos privados: Membro do grupo de segurança Contributors ou permissões correspondentes no projeto. - Definir permissões de ramo ou repositório: Gerir permissões para o ramo ou repositório. - Alterar ramificação padrão: Editar políticas e permissões para o repositório. - Importar um repositório: Membro do grupo de segurança Administradores de Projeto ou com permissão de Criar repositório ao nível do projeto Git definida como Permitir. Para obter mais informações, consulte Definir permissões do repositório Git.
Serviços	Repos ativado.
Ferramentas	Opcional. Utilize os comandos az repos: Azure DevOps CLI.

Observação

Em projetos públicos, os usuários com acesso Partes Interessadas têm acesso total aos repositórios do Azure, incluindo visualização, clonagem e contribuição para o código.

Configurar a política de branches

1. Navega até Código>Ramificações e localiza a ramificação onde desejas configurar a política (normalmente main ou develop). No menu de contexto, selecione a opção Políticas de branches.

   

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.

   

   • de requisitos 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 que apenas a identidade especificada será contada para o cumprimento da política.
   • Condições de redefinição é usado para determinar quando um estado publicado 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 mudar.
   • Opcionalmente, defina um filtro de caminho. Saiba mais sobre filtros de caminho em políticas de ramificação.
   • de 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.
   • Nome de exibição padrão permite especificar um nome de exibição opcional para sua política.

Criar um novo pull request

1. Crie um novo pull request para a ramificação onde a política está definida. Para mais informações, consulte Criar um pull request.

2. Depois de criar o PR, a nova política aparecerá na secção Políticas da visualização de detalhes de PR. 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 status succeeded, 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.