Gerenciar pull requests para atualizações de dependências

Note

O administrador do site precisa configurar as Dependabot updates do sua instância do GitHub Enterprise Server para que você possa usar esse recurso. Para obter mais informações, confira "Habilitando o Dependabot para sua empresa".

Talvez você não consiga habilitar ou desabilitar Dependabot updates se um proprietário da empresa tiver definido uma política no nível da empresa. Para obter mais informações, confira "Como impor políticas para segurança e análise de código na empresa".

Sobre pull requests Dependabot

O Dependabot gera pull requests para atualizar dependências. Dependendo de como o repositório está configurado, o Dependabot poderá gerar solicitações de pull para atualizações de versão e/ou para atualizações de segurança. Você gerencia essas pull requests da mesma forma que qualquer outra pull request, mas também existem alguns comandos extras disponíveis. Para obter mais informações sobre como habilitar as atualizações de dependência de Dependabot, confira "Configurando as atualizações de segurança do Dependabot" e "Configurando a versão das atualizações do Dependabot".

Quando o Dependabot cria uma pull request, você é notificado pelo método escolhido para o repositório. Cada pull request contém informações detalhadas sobre a mudança proposta, retirada do gerenciador de pacotes. Essas pull requests seguem as verificações e testes normais definidas no seu repositório.

Se você tem muitas dependências para gerenciar, você pode querer personalizar a configuração para cada gerenciador de pacotes para que as pull requests tenham revisores, responsáveis e etiquetas específicos. Para saber mais, confira Manter suas dependências atualizadas automaticamente com as atualizações da versão do Dependabot e Configurando as atualizações de segurança do Dependabot.

Note

Se você não interagir com pull requests do Dependabot para um repositório durante um período de 90 dias, o Dependabot considerará seu repositório inativo e pausará automaticamente o Dependabot updates. Para saber mais sobre critérios de inatividade, confira Sobre as atualizações da versão do Dependabot e Sobre as atualizações de segurança do Dependabot.

Visualizando pull requests Dependabot

Em GitHub, acesse a página principal do repositório.
Abaixo do nome do repositório, clique em Solicitações de pull.
Todos os pull requests de atualização de segurança ou versão são fáceis de identificar.
- O autor é dependabot, a conta de bot usada pelo Dependabot.
- Por padrão, elas têm o rótulo dependencies.

Alterando a estratégia de rebase para pull requests Dependabot

Por padrão, o Dependabot faz o rebasamento automaticamente das pull requests para resolver quaisquer conflitos. Se uma solicitação de pull não for mesclada em 30 dias, o Dependabot interromperá a troca de base da solicitação de pull. Você ainda poderá trocar a base manualmente e mesclar a solicitação de pull. Se preferir lidar com conflitos de mesclagem manualmente, você pode desativar isso usando a opção rebase-strategy. Para obter detalhes, confira Dependabot options reference.

Ao permitir que o Dependabot troque de base e imponha o envio por push sem vez de obre confirmações adicionais

Por padrão, o Dependabot interromperá a troca de base de uma solicitação de pull assim que as confirmações adicionais forem enviadas por push para ele. Para permitir que o Dependabot imponha o envio por push em vez da adição de conformações às ramificações, inclua qualquer uma das seguintes cadeias de caracteres: [dependabot skip], [skip dependabot], [dependabot-skip] ou [skip-dependabot], minúsculas ou maiúsculas, na a mensagem de confirmação.

Gerenciando pull requests Dependabot com comandos de comentário

O Dependabot responde a comandos simples nos comentários. Cada pull request contém detalhes dos comandos que você pode usar para processar a pull request (por exemplo: fazer merge, combinação por squash, abrir, fechar ou rebasear a pull request) na seção "comandos e opções de Dependabot". O objetivo é facilitar ao máximo a triagem dessas pull requests geradas automaticamente.

Você pode usar qualquer um dos seguintes comandos em um pull request de Dependabot.

@dependabot cancel merge cancela uma mesclagem já solicitada.
@dependabot close fecha a solicitação de pull e impede que o Dependabot recrie essa solicitação de pull. Você pode obter o mesmo resultado fechando a pull request manualmente.
@dependabot ignore this dependency fecha a solicitação de pull e impede que o Dependabot crie mais solicitações de pull para essa dependência (a menos que você reabra a solicitação de pull ou faça upgrade para a versão sugerida da dependência por conta própria).
@dependabot ignore this major version fecha a solicitação de pull e impede que o Dependabot crie mais solicitações de pull para essa versão principal (a menos que você reabra a solicitação de pull ou faça upgrade para essa versão principal por conta própria).
@dependabot ignore this minor version fecha a solicitação de pull e impede que o Dependabot crie mais solicitações de pull para essa versão secundária (a menos que você reabra a solicitação de pull ou faça upgrade para essa versão secundária por conta própria).
@dependabot ignore this patch version fecha a solicitação de pull e impede que o Dependabot crie mais solicitações de pull para essa versão de patch (a menos que você reabra a solicitação de pull ou faça upgrade para essa versão de patch por conta própria).
@dependabot merge mescla a solicitação de pull depois que os testes de CI são aprovados.
@dependabot rebase troca a base da solicitação de pull.
@dependabot recreate recria a solicitação de pull, substituindo todas as edições feitas na solicitação de pull.
@dependabot reopen reabrirá a solicitação de pull se ela estiver fechada.
@dependabot squash and merge faz uma mesclagem squash e mescla a solicitação de pull depois que os testes de CI são aprovados.

Dependabot reagirá com um emoji "positivo" para reconhecer o comando e pode responder com um comentário na pull request. Embora Dependabot normalmente responda rapidamente, alguns comandos podem levar vários minutos para serem concluídos se Dependabot estiver ocupado processando outras atualizações ou comandos.

Se você executar algum comando para ignorar dependências ou versões, o Dependabot armazena centralmente as preferências para o repositório. Embora esta seja uma solução rápida, para repositórios com mais de um colaborador é melhor definir explicitamente as dependências e versões para ignorar no arquivo de configuração. Isso facilita que todos os colaboradores vejam por que uma determinada dependência não está sendo atualizada automaticamente.

Para saber mais, confira Dependabot options reference.