Digite para filtrar os verbetes do Glossário.

    Git e qualidade · Vibe Coding: Do Zero ao MVP

    O que é Branch protection?

    A branch protection define exigências para atualizar uma branch. No GitHub, pode exigir revisões e verificações, com exceções de permissão configuráveis.

    Também chamado de: proteção de branch, ramo protegido

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    A branch protection é uma configuração do repositório que restringe atualizações de uma branch. No GitHub, você pode exigir que uma alteração seja apresentada por pull request e receba aprovações ou verificações automatizadas para ser integrada. As exigências efetivas dependem das opções habilitadas e das permissões de exceção.

    A branch de destino e as exigências

    A configuração pode selecionar uma branch pelo nome, como main, ou alcançar várias branches por um padrão. Você define as condições para atualizar as referências selecionadas. Na configuração padrão de proteção do GitHub, a exclusão da branch e o envio forçado que reescreve seu histórico ficam desabilitados, mas essas restrições podem ser alteradas.

    A documentação do GitHub também descreve exceções para administradores e papéis autorizados a ignorar a proteção. Uma configuração que exige revisão dos colaboradores pode permitir alterações por esses perfis. A opção de aplicar as restrições a eles precisa ser conferida no próprio repositório.

    Uma aprovação e um teste na main

    Neste exemplo didático, a main exige um pull request com uma aprovação e a verificação testes. O teste termina com sucesso, mas nenhuma revisão foi aprovada. Para uma contribuição sujeita à proteção, a integração continua indisponível porque falta a aprovação exigida.

    Com a aprovação registrada, o pull request atende a essas duas condições. Outras exigências configuradas ainda podem impedir a integração. O GitHub também permite invalidar aprovações antigas após novas alterações, conforme as opções de configuração.

    A proteção verifica o cumprimento dessas etapas. Um teste que não examina uma falha de autorização pode terminar com sucesso mesmo com essa falha presente. Você ainda precisa ler o código e conferir se os testes exercitam o comportamento alterado.

    Dúvidas frequentes

    Perguntas frequentes sobre Branch protection

    Proteger uma branch exige revisão automaticamente?
    A exigência de aprovação precisa ser habilitada. No GitHub, a configuração também permite escolher o número de aprovações e exigir uma nova revisão quando houver alterações posteriores.
    Administradores podem ignorar a proteção?
    Por padrão, as restrições não se aplicam a administradores nem a papéis com permissão para ignorar proteções de branch. O GitHub oferece uma opção para submeter esses perfis às exigências também.
    Uma verificação obrigatória precisa terminar com sucesso?
    O GitHub aceita verificações nos estados successful, skipped ou neutral para essa exigência. Você precisa examinar o que o teste executou, pois um resultado aceito pode corresponder a uma verificação dispensada.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao integrar alterações produzidas com agentes de código, você precisa configurar quais revisões e verificações serão exigidas na branch de destino.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano