Removing self-hosted runners

You can permanently remove a self-hosted runner from a repository or organization.

Neste artigo

Removing a runner from a repository

Observação

  • Este procedimento remove permanentemente o executor auto-hospedado. Caso você deseje apenas impedir temporariamente que um executor seja atribuído a trabalhos, desligue o computador ou interrompa o aplicativo run. O executor permanecerá atribuído em um estado "Offline" e não executará nenhum trabalho até que você o reinicie usando o aplicativo run.
  • Um executor auto-hospedado é removido automaticamente do GitHub quando não se conecta ao GitHub Actions por mais de 14 dias. Um executor auto-hospedado efêmero é removido automaticamente do GitHub quando não se conecta ao GitHub Actions por mais de 1 dia.
  • Os executores JIT (Just-In-Time) só podem executar um único trabalho. Se os executores JIT nunca executarem um trabalho, eles serão removidos automaticamente. Para remover um executor JIT antes da remoção automática, você deve fazê-lo em GitHub.

To remove a self-hosted runner from a user repository you must be the repository owner. Organization owners can remove a runner from a repository in the organization.

We recommend that you also have access to the self-hosted runner machine.

For information about how to remove a self-hosted runner with the REST API, see Pontos de extremidade da API REST para executores auto-hospedados.

Como alternativa, se você não tiver acesso ao repositório ou organização no GitHub para remover um executor, mas quiser reutilizar o computador executor, poderá excluir o arquivo .runner no diretório do aplicativo executor auto-hospedado (ou seja, o diretório no qual você baixou e descompactou o software do executor). Isso permite que o runner seja registrado sem ter que baixar novamente o aplicativo do runner auto-hospedado.

  1. Em GitHub, acesse a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Configurações. 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 barra lateral esquerda, clique em Ações e clique em Executores.

  4. Na lista de executores, clique no nome do executor que você deseja configurar.

  5. Clique em Remover.

  6. Você verá instruções para remover o executor auto-hospedado. Complete qualquer um dos seguintes passos para remover o executor, dependendo se ele ainda está acessível:

    • Se você tiver acesso ao computador do executor: siga as instruções na tela para que o sistema operacional do computador execute o comando de remoção. As instruções incluem a URL necessária e um token gerado automaticamente, limitado por tempo.

      O comando de remoção executa as seguintes tarefas:

      • Remove o executor do GitHub.
      • Remove todos os arquivos de configuração do aplicativo de executor auto-hospedado na máquina.
      • Remove todos os serviços configurados se não estiver em execução no modo interativo.

    • Se você não tiver acesso ao computador: clique em Force remove this runner para forçar o GitHub a remover o executor.

Removing a runner from an organization

Observação

  • Este procedimento remove permanentemente o executor auto-hospedado. Caso você deseje apenas impedir temporariamente que um executor seja atribuído a trabalhos, desligue o computador ou interrompa o aplicativo run. O executor permanecerá atribuído em um estado "Offline" e não executará nenhum trabalho até que você o reinicie usando o aplicativo run.
  • Um executor auto-hospedado é removido automaticamente do GitHub quando não se conecta ao GitHub Actions por mais de 14 dias. Um executor auto-hospedado efêmero é removido automaticamente do GitHub quando não se conecta ao GitHub Actions por mais de 1 dia.
  • Os executores JIT (Just-In-Time) só podem executar um único trabalho. Se os executores JIT nunca executarem um trabalho, eles serão removidos automaticamente. Para remover um executor JIT antes da remoção automática, você deve fazê-lo em GitHub.

To remove a self-hosted runner from an organization, you must be an organization owner. We recommend that you also have access to the self-hosted runner machine. For information about how to remove a self-hosted runner with the REST API, see Pontos de extremidade da API REST para executores auto-hospedados.

Como alternativa, se você não tiver acesso ao repositório ou organização no GitHub para remover um executor, mas quiser reutilizar o computador executor, poderá excluir o arquivo .runner no diretório do aplicativo executor auto-hospedado (ou seja, o diretório no qual você baixou e descompactou o software do executor). Isso permite que o runner seja registrado sem ter que baixar novamente o aplicativo do runner auto-hospedado.

  1. Em GitHub, acesse a página principal da organização.

  2. No nome da sua organização, clique Configurações. 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.

  3. Na barra lateral esquerda, clique em Ações e clique em Executores.

  4. Na lista de executores, clique no nome do executor que você deseja configurar.

  5. Clique em Remover.

  6. Você verá instruções para remover o executor auto-hospedado. Complete qualquer um dos seguintes passos para remover o executor, dependendo se ele ainda está acessível:

    • Se você tiver acesso ao computador do executor: siga as instruções na tela para que o sistema operacional do computador execute o comando de remoção. As instruções incluem a URL necessária e um token gerado automaticamente, limitado por tempo.

      O comando de remoção executa as seguintes tarefas:

      • Remove o executor do GitHub.
      • Remove todos os arquivos de configuração do aplicativo de executor auto-hospedado na máquina.
      • Remove todos os serviços configurados se não estiver em execução no modo interativo.

    • Se você não tiver acesso ao computador: clique em Force remove this runner para forçar o GitHub a remover o executor.

Removing a runner from an enterprise

If you use GitHub Enterprise Cloud, you can also remove runners from an enterprise. For more information, see the GitHub Enterprise Cloud documentation.