Skip to main content

删除自托管的运行器

You can permanently remove a self-hosted runner from a repository or organization.

从仓库中删除运行器

注意: 此程序将永久删除自托管运行器。 如果您只想暂停运行器执行分配的作业,可以关闭机器或停止 run 应用程序。 运行器仍将保持“离线”状态,在您使用 run 应用程序重新启动运行器之前,将不会执行任何作业。

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

要从用户仓库删除自托管的运行器,您必须是仓库所有者。 对于组织仓库,您必须是组织所有者或拥有该仓库管理员的权限。 建议您也访问自托管的运行器机器。 有关如何使用 REST API 删除自托管运行器的信息,请参阅“自托管运行器”。

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. 这允许将运行器注册,而无需重新下载自托管的运行器应用程序。

  1. 在 GitHub.com 上,导航到仓库的主页面。

  2. 在仓库名称下,单击 Settings(设置)仓库设置按钮

  3. 在左侧边栏中,单击 Actions(操作)

  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. 您将看到删除自托管运行器的说明。 完成以下任一步骤来删除运行器,具体取决于它是否仍然可以访问:

    • 如果您可以访问运行器机器:按照您机器操作系统的屏幕说明运行删除命令。 该说明包括必需的 URL 和一个自动生成的有时限的令牌。

      删除命令执行以下任务:

      • 从 GitHub 删除运行器。
      • 删除机器上的任何自托管运行器应用程序配置文件。
      • 如果未在交互模式下运行,删除配置的任何服务。
    • If you don't have access to the machine: Click Force remove this runner to force GitHub to remove the runner.

从组织中删除运行器

注意: 此程序将永久删除自托管运行器。 如果您只想暂停运行器执行分配的作业,可以关闭机器或停止 run 应用程序。 运行器仍将保持“离线”状态,在您使用 run 应用程序重新启动运行器之前,将不会执行任何作业。

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

要从组织删除自托管的运行器,您必须是组织所有者。 建议您也访问自托管的运行器机器。 有关如何使用 REST API 删除自托管运行器的信息,请参阅“自托管运行器”。

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. 这允许将运行器注册,而无需重新下载自托管的运行器应用程序。

  1. 在 GitHub.com 上,导航到组织的主页面。

  2. 在组织名称下,单击 设置.

    组织设置按钮

  3. 在左侧边栏中,单击 Actions(操作)

  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. 您将看到删除自托管运行器的说明。 完成以下任一步骤来删除运行器,具体取决于它是否仍然可以访问:

    • 如果您可以访问运行器机器:按照您机器操作系统的屏幕说明运行删除命令。 该说明包括必需的 URL 和一个自动生成的有时限的令牌。

      删除命令执行以下任务:

      • 从 GitHub 删除运行器。
      • 删除机器上的任何自托管运行器应用程序配置文件。
      • 如果未在交互模式下运行,删除配置的任何服务。
    • If you don't have access to the machine: Click Force remove this runner to force GitHub to remove the runner.

从企业中删除运行器

如果您使用 GitHub Enterprise Cloud, you can also remove runners from an enterprise. For more information, see the GitHub Enterprise Cloud documentation.