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 recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Remover executores auto-hospedados

Você pode remover um executor auto-hospedado de GitHub Actions permantentemente.

Neste artigo

Remover um executor de um repositório

Observação: This procedure permanently removes the self-hosted runner. If you only want to temporarily stop a runner from being assigned jobs, you can either shut down the machine or stop the run application. The runner will remain assigned in an "Offline" state, and won't execute any jobs until you restart the runner using the run application.

A self-hosted runner is automatically removed from GitHub if it has not connected to GitHub Actions for more than 30 days.

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.

Como alternativa, se você não tiver acesso ao repositório em GitHub para remover um executor (por exemplo, o repositório foi excluído), mas gostaria de reutilizar a máquina executora, você poderá excluir o arquivo .runner dentro do diretório de aplicação do executor auto-hospedado. Isso permite que o executor seja registrado em outro repositório ou organização sem ter que baixar novamente o aplicativo do executor auto-hospedado.

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

  2. Under your repository name, click Settings.

    Repository settings button

  3. In the left sidebar, click Actions.

    Actions setting

  4. Under "Self-hosted runners", find the runner you want to remove, open the menu using , and click Remove:

    Removing a self-hosted runner setting

  5. You will see instructions for removing the self-hosted runner. Complete either of the following steps to remove the runner, depending on whether it is still accessible:

    • If you have access to the runner machine: Follow the on-screen instructions for your machine's operating system to run the removal command. The instructions include the required URL and an automatically-generated, time-limited token.

      The removal command does the following tasks:

      • Removes the runner from GitHub.
      • Removes any self-hosted runner application configuration files on the machine.
      • Removes any services configured if not running in interactive mode.
    • If you don't have access to the machine: Click Yes, force remove this runner to force GitHub to remove the runner.

Remover um executor de uma organização

Observação: This procedure permanently removes the self-hosted runner. If you only want to temporarily stop a runner from being assigned jobs, you can either shut down the machine or stop the run application. The runner will remain assigned in an "Offline" state, and won't execute any jobs until you restart the runner using the run application.

A self-hosted runner is automatically removed from GitHub if it has not connected to GitHub Actions for more than 30 days.

Para remover um executor auto-hospedado de uma organização, você deve ser um proprietário da organização. We recommend that you also have access to the self-hosted runner machine.

Como alternativa, se você não tiver acesso à organização em GitHub para remover um executor (por exemplo, a organização foi excluída), mas você gostaria de reutilizar a máquina executora, você poderá excluir o arquivo .runner dentro do diretório de aplicação do executor auto-hospedado. Isso permite que o executor seja registrado em outra organização ou repositório sem ter que baixar novamente o aplicativo do executor auto-hospedado.

  1. On GitHub, navigate to the main page of the organization.

  2. Under your organization name, click Settings.

    Organization settings button

  3. In the left sidebar, click Actions.

    Actions setting

  4. Under "Self-hosted runners", find the runner you want to remove, open the menu using , and click Remove:

    Removing a self-hosted runner setting

  5. You will see instructions for removing the self-hosted runner. Complete either of the following steps to remove the runner, depending on whether it is still accessible:

    • If you have access to the runner machine: Follow the on-screen instructions for your machine's operating system to run the removal command. The instructions include the required URL and an automatically-generated, time-limited token.

      The removal command does the following tasks:

      • Removes the runner from GitHub.
      • Removes any self-hosted runner application configuration files on the machine.
      • Removes any services configured if not running in interactive mode.
    • If you don't have access to the machine: Click Yes, force remove this runner to force GitHub to remove the runner.

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato