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.

Esta versão do GitHub Enterprise será descontinuada em Esta versão do GitHub Enterprise foi descontinuada em 2020-01-22. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

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. Em Protected Branches (Branches protegidos), selecione o branch que deseja proteger usando o menu suspenso.

    Menu suspenso Selecting a protected branch (Selecionar branch protegido)

  5. Selecione Protect this branch (Proteger este branch).

    Caixa de seleção Proteger branch

  6. Clique em Save changes (Salvar alterações).

Tipos de verificações de status obrigatórias

Tipo de verificação de status obrigatória Configuração Requisitos de merge Considerações
Rígida A 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ível A 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.
Desabilitada A 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. Em Protected Branches (Branches protegidos), selecione o branch que deseja marcar com verificação de status obrigatória usando o menu suspenso.

    Menu suspenso Selecionar branch protegido

  5. 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)

  6. 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

  7. Outra opção é selecionar Include administrators (Incluir administradores). This enforces all configured restrictions for repository administrators.

    Caixa de seleção Include administrators (Incluir administradores)

  8. 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

  9. Você também pode selecionar Restrict who can push to this branch (Restringir quem pode fazer push para este branch).

    Caixa de seleção restrição de branch

  10. Pesquise e selecione os usuários, equipes que terão permissão para fazer push para o branch protegido.

    Pesquisa de restrição de branch

  11. Clique em Save changes (Salvar alterações).

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