Configurar o Dependabot em executores auto-hospedados

Você pode configurar executores auto-hospedados que Dependabot usam para acessar seus registros privados e recursos de rede internos.

Quem pode usar esse recurso?

Proprietários da organização e administradores do repositório

Neste artigo

Pré-requisitos

  • Dependabot está instalado e habilitado.
  • GitHub Actions está habilitado e em uso.

Adicionar executores auto-hospedados para atualizações do Dependabot

  1. Prover executores auto-hospedados, no nível do repositório ou da organização. Para saber mais, confira Executores auto-hospedados e Adicionar executores auto-hospedados.
  2. Configure o ambiente e os executores para atender aos requisitos do Dependabot. Consulte Requisitos para usar Dependabot com executores auto-hospedados.
  3. Atribua o rótulo padrão dependabot ou um rótulo personalizado a cada executor que você deseja que o Dependabot use. Consulte Usar rótulos com os executores auto-hospedados.
  4. Opcionalmente, habilite os fluxos de trabalho acionados por Dependabot para usar permissões além de somente leitura e ter acesso a todos os segredos normalmente disponíveis. Para saber mais, confira Solução de problemas do Dependabot no GitHub Actions.

Configurando executores auto-hospedados para Dependabot updates

Aviso

Antes de selecionar executor com rótulo, verifique se um executor possui o rótulo que você pretende usar. Se você especificar um grupo de executores, verifique se o grupo existe e se o repositório pode acessá-lo. Consulte Dependabot nos executores do GitHub Actions.

Depois de configurar os executores auto-hospedados para Dependabot updates, você poderá selecioná-los no nível de organização ou de repositório.

Observação

Alterar a configuração do executor não dispara uma nova Dependabot execução.

Para seu repositório privado

  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 seção "Segurança e qualidade" da barra lateral, clique em Advanced Security.

  4. Em "Verificação de dependências", na seção de atualizações de versão "Dependabot", ao lado de "Tipo de executor", clique em .

  5. No menu suspenso "Tipo de executor", selecione Executor rotulado.

  6. Opcionalmente, insira um nome de grupo de executores e um rótulo de executor personalizado. Se você não inserir um rótulo, Dependabot usará o dependabot rótulo.

  7. Clique em Salvar seleção do executor.

    Observação

    Se você não puder alterar a configuração do executor, sua organização poderá restringir ações e executores auto-hospedados para o repositório. Entre em contato com o proprietário da sua organização para obter mais informações.

Para sua organização

Você pode habilitar o Dependabot em executores auto-hospedados para todos os repositórios privados existentes em uma organização. Somente os repositórios já configurados para execução Dependabot no GitHub Actions serão atualizados para serem executados em executores auto-hospedados do Dependabot na próxima vez em que um trabalho do Dependabot for disparado.

  1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

  2. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  4. Na seção "Security" da barra lateral, clique em Advanced Security e, em seguida, em Global settings.

  5. Na seção "Dependabot", ao lado de "Tipo de executor", clique em .

  6. Selecione o menu suspenso "Tipo de executor", clique em Executor rotulado, em seguida, forneça qualquer informação adicional. Se você tiver aplicado um rótulo personalizado aos seus executores auto-hospedados, digite esse rótulo no campo "Rótulo do executor".

  7. Para habilitar o recurso para todos os novos repositórios na organização, clique em Salvar seleção do executor.