Skip to main content

Removing self-hosted runners

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

注意

GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。 可以在 GitHub public roadmap 上查看有关未来支持计划的更多信息。

Removing a runner from a repository

注意

  • 此程序将永久删除自托管运行器。 如果只想暂停运行器执行分配的作业,可以关闭运行器或停止 run 应用程序。 运行器仍将保持“脱机”状态,在使用 run 应用程序重启运行器之前,它不会执行任何作业。
  • 自托管运行器与 GitHub Actions 未连接超过 14 天,将被自动从 GitHub 中删除。 临时自托管运行器与 GitHub Actions 未连接超过 1 天,将被自动从 GitHub 中删除。
  • 实时 (JIT) 运行器只能运行单个作业。 如果 JIT 运行器从未运行过作业,它们将自动删除。 若要在自动删除之前删除 JIT 运行器,必须删除 GitHub 上的 JIT 运行器。

To remove a self-hosted runner from a user repository you must be the repository owner. Organization owners and users with the "Manage organization runners and runner groups" permission can remove a runner from a repository in the organization. For more information about custom organization roles, see 关于自定义组织角色.

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 自托管运行器的 REST API 终结点.

另外,如果无权访问 GitHub 上的仓库、组织或企业 来删除运行器,但想重新使用运行器计算机,则可以删除自托管运行器应用程序目录(即运行器软件下载并解包到的目录)中的 .runner 文件。 这允许将运行器注册,而无需重新下载自托管的运行器应用程序。

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

  2. 在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”。

    存储库标头的屏幕截图,其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。

  3. 在左侧边栏中,单击 “操作”,然后单击“运行器” 。

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

  5. 单击 “删除”

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

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

      删除命令执行以下任务:

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

Removing a runner from an organization

注意

  • 此程序将永久删除自托管运行器。 如果只想暂停运行器执行分配的作业,可以关闭运行器或停止 run 应用程序。 运行器仍将保持“脱机”状态,在使用 run 应用程序重启运行器之前,它不会执行任何作业。
  • 自托管运行器与 GitHub Actions 未连接超过 14 天,将被自动从 GitHub 中删除。 临时自托管运行器与 GitHub Actions 未连接超过 1 天,将被自动从 GitHub 中删除。
  • 实时 (JIT) 运行器只能运行单个作业。 如果 JIT 运行器从未运行过作业,它们将自动删除。 若要在自动删除之前删除 JIT 运行器,必须删除 GitHub 上的 JIT 运行器。

To remove a self-hosted runner from an organization, you must be an organization owner or have the "Manage organization runners and runner groups" permission. 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 自托管运行器的 REST API 终结点.

For more information about custom organization roles, see 关于自定义组织角色.

另外,如果无权访问 GitHub 上的仓库、组织或企业 来删除运行器,但想重新使用运行器计算机,则可以删除自托管运行器应用程序目录(即运行器软件下载并解包到的目录)中的 .runner 文件。 这允许将运行器注册,而无需重新下载自托管的运行器应用程序。

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

  2. 在组织名称下,单击 “设置”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  3. 在左侧边栏中,单击 “操作”,然后单击“运行器” 。

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

  5. 单击 “删除”

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

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

      删除命令执行以下任务:

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

Removing a runner from an enterprise

注意

  • 此程序将永久删除自托管运行器。 如果只想暂停运行器执行分配的作业,可以关闭运行器或停止 run 应用程序。 运行器仍将保持“脱机”状态,在使用 run 应用程序重启运行器之前,它不会执行任何作业。
  • 自托管运行器与 GitHub Actions 未连接超过 14 天,将被自动从 GitHub 中删除。 临时自托管运行器与 GitHub Actions 未连接超过 1 天,将被自动从 GitHub 中删除。
  • 实时 (JIT) 运行器只能运行单个作业。 如果 JIT 运行器从未运行过作业,它们将自动删除。 若要在自动删除之前删除 JIT 运行器,必须删除 GitHub 上的 JIT 运行器。

To remove a self-hosted runner from an enterprise, you must be an enterprise 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 the enterprise endpoints in the GitHub Actions REST API.

另外,如果无权访问 GitHub 上的仓库、组织或企业 来删除运行器,但想重新使用运行器计算机,则可以删除自托管运行器应用程序目录(即运行器软件下载并解包到的目录)中的 .runner 文件。 这允许将运行器注册,而无需重新下载自托管的运行器应用程序。

  1. 在 的右上角,单击你的个人资料照片,然后单击“企业设置”****。

    单击 GitHub Enterprise Server 上的个人资料照片时显示的下拉菜单的屏幕截图。 框出了“企业设置”选项。

  2. 在页面左侧的企业帐户边栏中,单击“ Policies”****

  3. 在“ 策略”下,单击“操作”。****

  4. 单击“运行器”选项卡。

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

  6. 单击 “删除”

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

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

      删除命令执行以下任务:

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