Skip to main content

Remover executores auto-hospedados

Você pode remover permanentemente um executor auto-hospedado de um repositório ou organização.

Remover um executor de um repositório

Observação: Este procedimento remove permanentemente o executor auto-hospedado. Se você só quiser impedir temporariamente que um executor seja designado a trabalhos, você pode desligar a máquina ou parar o aplicativo run. O executor permanecerá atribuído em um estado "Offline" e não executará nenhum trabalho até que você reinicie o executor usando o aplicativo run.

Um executor auto-hospedado é automaticamente removido de GitHub se não se conectar a GitHub Actions por mais de 30 dias.

Para remover um executor auto-hospedado de um repositório de usuário, você deve ser o proprietário do repositório. Para um repositório da organização, você deve ser um proprietário da organização ou ter acesso de administrador ao repositório. Recomendamos que você também tenha acesso à máquina do executor auto-hospedado. Para obter informações sobre como remover um executor auto-hospedado com a API REST, consulte "Executores auto-hospedados."

Alternatively, if you don't have access to the repository or organization on GitHub to remove a runner, but you would like to re-use the runner machine, then you can delete the .runner file inside the self-hosted runner application directory. 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. No nome do seu repositório, clique em Configurações. Botão de configurações do repositório

  3. Na barra lateral esquerda, clique em Actions (Ações).

  4. In the left sidebar, under "Actions", click Runners.

  5. In the list of runners, click the runner you'd like to configure.

  6. Click Remove.

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

    • If you have access to the runner machine: (Se você tiver acesso à máquina do executor:) Siga as instruções na tela para que o sistema operacional da sua máquina 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.
      • 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.
    • If you don't have access to the machine: Click Force remove this runner to force GitHub to remove the runner.

Remover um executor de uma organização

Observação: Este procedimento remove permanentemente o executor auto-hospedado. Se você só quiser impedir temporariamente que um executor seja designado a trabalhos, você pode desligar a máquina ou parar o aplicativo run. O executor permanecerá atribuído em um estado "Offline" e não executará nenhum trabalho até que você reinicie o executor usando o aplicativo run.

Um executor auto-hospedado é automaticamente removido de GitHub se não se conectar a GitHub Actions por mais de 30 dias.

Para remover um executor auto-hospedado de uma organização, você deve ser um proprietário da organização. Recomendamos que você também tenha acesso à máquina do executor auto-hospedado. Para obter informações sobre como remover um executor auto-hospedado com a API REST, consulte "Executores auto-hospedados."

Alternatively, if you don't have access to the repository or organization on GitHub to remove a runner, but you would like to re-use the runner machine, then you can delete the .runner file inside the self-hosted runner application directory. Isso permite que o runner seja registrado sem ter que baixar novamente o aplicativo do runner auto-hospedado.

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

  2. Abaixo do nome da sua organização, clique em Settings.

    Botão de configurações da organização

  3. Na barra lateral esquerda, clique em Actions (Ações).

  4. In the left sidebar, under "Actions", click Runners.

  5. In the list of runners, click the runner you'd like to configure.

  6. Click Remove.

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

    • If you have access to the runner machine: (Se você tiver acesso à máquina do executor:) Siga as instruções na tela para que o sistema operacional da sua máquina 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.
      • 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.
    • If you don't have access to the machine: Click Force remove this runner to force GitHub to remove the runner.

Remover um executor de uma empresa

Se você usar GitHub Enterprise Cloud, você também pode remover executores de uma empresa. Para obter mais informações, consulte a documentação de GitHub Enterprise Cloud.