Definindo limites de cobertura de código para solicitações de pull

Impedir que as solicitações de pull sejam mescladas quando a cobertura de código carregada estiver abaixo dos níveis exigidos pela sua equipe.

Quem pode usar esse recurso?

Proprietários de repositório, proprietários da organização e usuários com a função de administrador

Neste artigo

A seguir

Phase 4: Assess the pilot and decide

Observação

Esse recurso está dentro prévia pública e sujeito a alterações.

Como funciona a regra de cobertura de código

A regra Restringir cobertura de código avalia os dados de cobertura de linha carregados com base nos limites configurados. Ele não aguarda a conclusão dos uploads de cobertura.

Para impedir que um pull request seja mesclado antes que todos os resultados de cobertura esperados estejam disponíveis, torne obrigatória cada verificação de status associada a um upload de cobertura esperado. Isso inclui dados de cobertura enviados de tarefas ou fluxos de trabalho separados.

Para obter mais informações sobre a cobertura de linha, consulte Referência de cobertura de código.

Pré-requisitos

Criando uma regra de limite de cobertura

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja-escuro.

  3. Na barra lateral esquerda, em "Código, planejamento e automação""Código e automação", clique em Conjuntos de Regras, depois clique em Conjuntos de Regras.

  4. Crie um novo conjunto de regras de branch ou clique em um existente para editá-lo.

  5. Em "Regras de ramificação", selecione Restringir cobertura de código.

  6. Expanda configurações adicionais para configurar limites. Um valor de 0 significa que o limite está desabilitado.

    • Percentual mínimo de cobertura de linha: insira um valor para bloquear solicitações de pull em que a cobertura de linha agregada fique abaixo desse percentual.
    • Queda máxima da cobertura de linhas: insira um valor para bloquear pull requests em que a cobertura de linhas caia mais do que este número de pontos percentuais em relação ao branch padrão.

  7. Clique em Criar ou Salvar alterações.

Dica

Considere configurar seu conjunto de regras no modo Avaliar antes de alternar para Ativo. Isso permite observar quais solicitações de pull teriam sido bloqueadas sem impor a regra, dando a você a chance de calibrar seus limites.