Remover executores auto-hospedados

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

Neste artigo

Remover um executor de um repositório

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

Para remover um executor auto-hospedado de um repositório de usuário, você deve ser o proprietário do repositório. Os proprietários da organização e os usuários com a permissão "Gerenciar executores e grupos de executores da organização" podem remover um executor de um repositório na organização. Para obter mais informações sobre funções de organização personalizadas, confira Sobre as funções da organização personalizadas.

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 Pontos de extremidade da API REST para executores auto-hospedados.

Como alternativa, se você não tiver acesso ao repositório, organização ou empresa 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.

Remover um executor de uma organização

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

Para remover um executor auto-hospedado de uma organização, você precisa ser um proprietário da organização ou ter a permissão "Gerenciar executores ou grupos de executores 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 Pontos de extremidade da API REST para executores auto-hospedados.

Para obter mais informações sobre funções de organização personalizadas, confira Sobre as funções da organização personalizadas.

Como alternativa, se você não tiver acesso ao repositório, organização ou empresa 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.

Remover um executor de uma empresa

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

Para remover um executor auto-hospedado de uma empresa, você deverá ser um proprietário corporativo. 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 os pontos de extremidade corporativos na API REST do GitHub Actions.

Como alternativa, se você não tiver acesso ao repositório, organização ou empresa 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. No canto superior direito do GitHub, selecione sua foto de perfil.

  2. Dependendo do ambiente, selecione Sua empresa ou Suas empresas e escolha a empresa que deseja ver.

  3. Do lado esquerdo da página, na barra lateral da conta empresarial, clique em Políticas.

  4. Em " Políticas", clique em Ações.

  5. Clique na guia Executores.

  6. Na lista de executores, clique no nome do executor que você 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 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.