Remover executores auto-hospedados

Neste artigo

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

Remover um executor de um repositório

Observações:

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

  • 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.com.

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.

  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 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ções:

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

  • 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.com.

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.

  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 da barra de navegação horizontal para 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 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.