👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.
Versão do artigo: Enterprise Server 2.19

Configurar branches protegidos e verificações de status obrigatórias

Você pode habilitar branches protegidos para limitar a manipulação dos branches, além de impor verificações de status obrigatórias antes de fazer merge de um branch em uma pull request ou antes de fazer push de commits em um branch local para o branch remoto protegido.

Neste artigo

Qualquer pessoa com permissões de administrador em um repositório pode habilitar restrições de branch.

Habilitar branches protegidos em um repositório

  1. No GitHub Enterprise, navegue até a página principal do repositório.
  2. Under your repository name, click Settings.
    Repository settings button
  3. In the left menu, click Branches.
    Repository options sub-menu
  4. Next to "Branch protection rules", click Add rule.
    Add branch protection rule button
  5. Under "Branch name pattern", type the branch name or pattern you want to protect.
    Branch rule field
  6. Click Create.

Tipos de verificações de status obrigatórias

Tipo de verificação de status obrigatóriaConfiguraçãoRequisitos de mergeConsiderações
RígidaA caixa de seleção Require branches to be up-to-date before merging (Exigir a atualização dos branches antes de fazer merge) fica marcada.O branch precisa ser atualizado no branch base antes do merge.Este é o comportamento padrão para verificações de status obrigatórias. Podem ser necessárias mais compilações, já que você precisará atualizar o branch head depois que outros colaboradores fizerem merge de pull requests no branch base protegido.
FlexívelA caixa de seleção Require branches to be up-to-date before merging (Exigir a atualização dos branches antes de fazer merge) não fica marcada.O branch não precisa ser atualizado no branch base antes do merge.Serão necessárias menos compilações, já que você não precisará atualizar o branch head depois que outros colaboradores fizerem merge de pull requests. As verificações de status poderão falhar depois que você fizer merge do branch, caso haja alterações incompatíveis com o branch base.
DesabilitadaA caixa de seleção Require status checks to pass before merging (Exigir verificações de status para aprovação antes de fazer merge) não fica marcada.O branch não tem restrições de merge.Se as verificações de status obrigatórias não estiverem habilitadas, os colaboradores poderão fazer merge do branch a qualquer momento, estando ou não atualizados com o branch base. Isso aumenta a possibilidade de alterações incompatíveis.

Habilitar verificações de status obrigatórias

  1. No GitHub Enterprise, navegue até a página principal do repositório.
  2. Under your repository name, click Settings.
    Repository settings button
  3. In the left menu, click Branches.
    Repository options sub-menu
  4. Next to "Branch protection rules", click Add rule.
    Add branch protection rule button
  5. Under "Branch name pattern", type the branch name or pattern you want to protect.
    Branch rule field
  6. Selecione Require status checks to pass before merging (Exigir verificações de status para aprovação antes de fazer merge).
    Opção Required status checks (Verificações de status obrigatórias)
  7. Na lista de verificações de status disponíveis, selecione aquelas que você deseja tornar obrigatórias.
    Lista de verificações de status disponíveis
  8. Outra opção é selecionar Include administrators (Incluir administradores). This enforces all configured restrictions for repository administrators.
    Caixa de seleção Include administrators (Incluir administradores)
  9. Outra opção é desmarcar Require branches to be up to date before merging (Exigir que os branches sejam atualizados antes de fazer merge). Se selecionada, isso garante que o branch foi testado com o código mais recente no branch básico.
    Caixa de seleção Status obrigatório rígido ou flexível
  10. Optionally, select Restrict who can push to matching branches.
    Caixa de seleção restrição de branch
  11. Search for and select the people, teams, or apps who will have permission to push to the protected branch.
    Pesquisa de restrição de branch
  12. Click Create.

Tip: To successfully merge a pull request into a base branch that has required status checks enabled, the pull request's head branch must be up-to-date with the base branch.

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato