Skip to main content

Removing self-hosted runners

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

Removing a runner from a repository

Note: 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 é automaticamente removido de GitHub Enterprise Cloud se não se conectar a GitHub Actions por mais de 14 dias.
Um executor auto-hospedado efêmero é removido automaticamente de GitHub Enterprise Cloud se não estiver conectado a GitHub Actions por mais de 1 dia.

To remove a self-hosted runner from a user repository you must be the repository owner. For an organization repository, you must be an organization owner or have admin access to the repository. 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 "Self-hosted runners."

Como alternativa, se você não tiver acesso ao repositório, à organização ou à empresa no GitHub Enterprise Cloud para remover um executor, mas desejar reutilizar o computador do executor, exclua o arquivo .runner dentro do diretório do aplicativo do executor auto-hospedado. Isso permite que o runner seja registrado sem ter que baixar novamente o aplicativo do runner auto-hospedado.

  1. No GitHub.com, navegue até a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Configurações. Botão Configurações do repositório

  3. In the left sidebar, click Actions, then click Runners.

  4. Na lista de executores, clique no executor que 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 de GitHub Enterprise Cloud.
      • 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 Forçar a remoção deste executor para forçar o GitHub Enterprise Cloud a remover o executor.

Removing a runner from an organization

Note: 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 é automaticamente removido de GitHub Enterprise Cloud se não se conectar a GitHub Actions por mais de 14 dias.
Um executor auto-hospedado efêmero é removido automaticamente de GitHub Enterprise Cloud se não estiver conectado a GitHub Actions por mais de 1 dia.

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 "Self-hosted runners."

Como alternativa, se você não tiver acesso ao repositório, à organização ou à empresa no GitHub Enterprise Cloud para remover um executor, mas desejar reutilizar o computador do executor, exclua o arquivo .runner dentro do diretório do aplicativo do executor auto-hospedado. Isso permite que o runner seja registrado sem ter que baixar novamente o aplicativo do runner auto-hospedado.

  1. No GitHub.com, navegue até a página principal da organização.

  2. No nome da sua organização, clique em Configurações. Botão Configurações da organização

  3. In the left sidebar, click Actions, then click Runners.

  4. Na lista de executores, clique no executor que 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 de GitHub Enterprise Cloud.
      • 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 Forçar a remoção deste executor para forçar o GitHub Enterprise Cloud a remover o executor.

Removing a runner from an enterprise

Note: 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 é automaticamente removido de GitHub Enterprise Cloud se não se conectar a GitHub Actions por mais de 14 dias.
Um executor auto-hospedado efêmero é removido automaticamente de GitHub Enterprise Cloud se não estiver conectado a GitHub Actions por mais de 1 dia.

To remove a self-hosted runner from an enterprise, you must be an enterprise 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 the enterprise endpoints in the GitHub Actions REST API.

Como alternativa, se você não tiver acesso ao repositório, à organização ou à empresa no GitHub Enterprise Cloud para remover um executor, mas desejar reutilizar o computador do executor, exclua o arquivo .runner dentro do diretório do aplicativo do executor auto-hospedado. Isso permite que o runner seja registrado sem ter que baixar novamente o aplicativo do runner auto-hospedado.

  1. No canto superior direito do GitHub.com, clique na foto do seu perfil e em Suas empresas. "Suas empresas" no menu suspenso na foto de perfil no GitHub Enterprise Cloud

  2. Na lista de empresas, clique na empresa que você deseja visualizar. Nome de uma empresa na lista das suas empresas

  3. Na barra lateral da empresa, clique em Políticas. Guia Políticas na barra lateral da conta corporativa

  4. Em " Políticas", clique em Actions.

  5. Clique na guia Executores.

  6. Na lista de executores, clique no executor que deseja configurar.

  7. Clique em Remover.

  8. 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 de GitHub Enterprise Cloud.
      • 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 Forçar a remoção deste executor para forçar o GitHub Enterprise Cloud a remover o executor.