Skip to main content

Removing self-hosted runners

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

Removing a runner from a repository

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

自托管运行器与 GitHub Actions 未连接超过 14 天,将被自动从 GitHub 中删除。
临时自托管运行器与 GitHub Actions 未连接超过 1 天,将被自动从 GitHub 中删除。

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. For information about how to remove a self-hosted runner with the REST API, see "Self-hosted runners."

或者,如果无权访问 GitHub 上的存储库或组织 来删除运行器,但想重新使用运行器计算机,则可以删除自托管运行器应用程序目录中的 .runner 文件。 这允许将运行器注册,而无需重新下载自托管的运行器应用程序。

  1. 在 GitHub.com 上,导航到存储库的主页。

  2. 在存储库名称下,单击 “设置”。 “存储库设置”按钮

  3. In the left sidebar, click Actions, then click Runners.

  4. 在运行器列表中,单击要配置的运行器。

  5. 单击 “删除”

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

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

      删除命令执行以下任务:

      • 从 GitHub 删除运行器。
      • 删除机器上的任何自托管运行器应用程序配置文件。
      • 如果未在交互模式下运行,删除配置的任何服务。
    • 如果无权访问计算机:单击“强制删除此运行器”以强制 GitHub 删除运行器 。

Removing a runner from an organization

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

自托管运行器与 GitHub Actions 未连接超过 14 天,将被自动从 GitHub 中删除。
临时自托管运行器与 GitHub Actions 未连接超过 1 天,将被自动从 GitHub 中删除。

To remove a self-hosted runner from an organization, you must be an organization owner. We recommend that you also have access to the self-hosted runner machine. For information about how to remove a self-hosted runner with the REST API, see "Self-hosted runners."

或者,如果无权访问 GitHub 上的存储库或组织 来删除运行器,但想重新使用运行器计算机,则可以删除自托管运行器应用程序目录中的 .runner 文件。 这允许将运行器注册,而无需重新下载自托管的运行器应用程序。

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

  2. 在组织名称下,单击“设置”。 组织设置按钮

  3. In the left sidebar, click Actions, then click Runners.

  4. 在运行器列表中,单击要配置的运行器。

  5. 单击 “删除”

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

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

      删除命令执行以下任务:

      • 从 GitHub 删除运行器。
      • 删除机器上的任何自托管运行器应用程序配置文件。
      • 如果未在交互模式下运行,删除配置的任何服务。
    • 如果无权访问计算机:单击“强制删除此运行器”以强制 GitHub 删除运行器 。

Removing a runner from an enterprise

If you use GitHub Enterprise Cloud, you can also remove runners from an enterprise. For more information, see the GitHub Enterprise Cloud documentation.