Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

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

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, confira "Ações".

Como alternativa, se você não tiver acesso ao repositório ou à organização no GitHub 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. 1. Abaixo do nome do repositório, clique em Configurações. Caso não consiga ver a guia suspensa "Configurações", selecione o menu suspenso e 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. 1. Na barra lateral esquerda, clique em Ações e em Executores. 1. Na lista de executores, clique no nome do executor que você deseja configurar. 1. Clique em Remover.

  1. 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.
      • 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 a remover o executor.

Remover um executor de uma organização

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

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, confira "Ações".

Como alternativa, se você não tiver acesso ao repositório ou à organização no GitHub 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. 1. No nome da sua organização, clique em Configurações.

Botão Configurações da organização 1. Na barra lateral esquerda, clique em Ações e em Executores. 1. Na lista de executores, clique no nome do executor que você deseja configurar. 1. Clique em Remover.

  1. 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.
      • 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 a remover o executor.

Remover um executor de uma empresa

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