Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
As políticas de branch são um recurso poderoso para garantir o código de alta qualidade em seu repositório estabelecendo requisitos para todas as solicitações de pull. Os serviços externos podem usar a API de Status de PR para postar o status detalhado em suas PRs. A política de branch para serviços externos permite que esses serviços de terceiros participem do fluxo de trabalho de PR e estabeleçam requisitos de política. Este artigo orienta você pelo processo de configuração de uma política de branch para um serviço que está postando o status de PR. Para obter mais informações sobre o status de PR, consulte Personalizar e estender fluxos de trabalho de solicitação de pull com o status da solicitação de pull.
Pré-requisitos
| Categoria | Requirements |
|---|---|
| Acesso ao Projeto | Membro de um projeto. |
| Permissões | - Exibir código em projetos privados: pelo menos acesso básico . - Clonar ou contribuir para o código em projetos privados: membro do grupo de segurança Colaboradores ou permissões correspondentes no projeto. - Definir permissões de branch ou repositório: gerenciar permissões de permissões para o branch ou repositório. - Alterar o branch padrão: editar permissões de políticas para o repositório. - Importar um repositório: membro do grupo de segurança Administradores do Projeto ou da permissão Criar repositório no nível do projeto do Git definida como Permitir. Para obter mais informações, consulte Definir permissões de repositório Git. |
| Serviços | Repositórios habilitados. |
| Ferramentas | Optional. Use comandos az repos : CLI do Azure DevOps. |
Observação
Em projetos públicos, os usuários com acesso ao Stakeholder têm acesso total ao Azure Repos, incluindo exibição, clonagem e contribuição para o código.
| Categoria | Requirements |
|---|---|
| Acesso ao Projeto | Membro de um projeto. |
| Permissões | - Exibir código: pelo menos acesso básico . - Clonar ou contribuir com o código: membro do grupo de segurança Colaboradores ou permissões correspondentes no projeto. |
| Serviços | Repositórios habilitados. |
Configurar a política de branch
Navegue até Ramificações de Código> e localize o branch no qual você deseja configurar a política (normalmente
mainoudevelop). No menu de contexto, selecione a opção Políticas do Branch .
Role para baixo para encontrar verificações de status. Selecione o + botão.
Selecione o serviço para o qual você deseja criar uma política na lista. Se o status tiver sido postado anteriormente, você poderá selecioná-lo na lista; se for uma nova política, você poderá digitar o nome da política.
- O requisito de política determina se essa política é opcional ou não necessária para concluir solicitações de pull no branch.
- A identidade autorizada é usada para impor que o status somente da identidade especificada será contado 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, um build), verifique o status de redefinição sempre que houver novas alterações para redefinir o status quando o branch de origem for alterado.
- Opcionalmente, defina um filtro Path. Saiba mais sobre filtros de caminho em políticas de branch.
- A aplicabilidade da política determina se essa política se aplica assim que uma solicitação de pull é criada ou se a política se aplica somente depois que o primeiro status é postado na solicitação de pull.
- O nome de exibição padrão permite que você especifique um nome de exibição opcional para sua política.
Criar uma nova solicitação de pull
Crie uma nova solicitação de pull no branch em que a política é definida. Para obter mais informações, consulte Criar uma solicitação de pull.
Depois de criar a PR, a nova política será exibida na seção Políticas do modo de exibiçã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 postado o status, a política será atualizada adequadamente. A conclusão será bloqueada até que a política aprove a PR.
Quando os critérios de política forem atendidos e o serviço postar um
succeededstatus, a PR será aprovada e a conclusão será desbloqueada.
Resumo
Neste artigo, você aprendeu a configurar uma política de branch para um serviço externo.