删除自托管运行器

您可以永久从仓库或组织中删除自托管运行器。

本文内容

从仓库中删除运行器

注意

  • 此过程会永久删除自托管运行器。如果您只想暂时停止为运行器分配作业，您可以关闭机器或停止 `run` 应用程序。运行器将保持“离线”状态，并且在您使用 `run` 应用程序重新启动运行器之前不会执行任何作业。
  • 如果自托管运行器在 14 天内未连接到 GitHub Actions，则该运行器将自动从 GitHub 中删除。如果临时自托管运行器在 1 天内未连接到 GitHub Actions，则该运行器将自动从 GitHub 中删除。
  • 即时 (JIT) 运行器只能运行单个作业。如果 JIT 运行器从未运行过作业，它们将自动被删除。要删除 JIT 运行器，您必须在 GitHub.com 上删除它。

要从用户仓库中删除自托管运行器，您必须是仓库所有者。组织所有者可以从组织中的仓库中删除运行器。

我们建议您也拥有对自托管运行器机器的访问权限。

有关如何使用 REST API 删除自托管运行器的信息，请参阅“自托管运行器的 REST API 端点”。

如果您没有权限在 GitHub 上移除运行器，但想要重新使用运行器机器，您可以删除自托管运行器应用程序目录（即您下载并解压缩运行器软件的目录）中的 `.runner` 文件。这样，运行器就可以注册，而无需重新下载自托管运行器应用程序。

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

  2. 在您的仓库名称下方，点击 **设置**。如果您看不到“设置”选项卡，请选择 **** 下拉菜单，然后点击 **设置**。

    Screenshot of a repository header showing the tabs. The "Settings" tab is highlighted by a dark orange outline.

  3. 在左侧边栏中，点击 **Actions**，然后点击 **Runners**。

  4. 在运行器列表中，点击您要配置的运行器的名称。

  5. 点击 **移除**。

  6. 您将看到移除自托管运行器的说明。根据运行器是否仍然可访问，完成以下任一步骤以移除运行器。

    • **如果您有权访问运行器机器：** 按照屏幕上的说明，根据您的机器操作系统运行移除命令。说明包括所需的 URL 和自动生成的、有限时长的令牌。

      移除命令将执行以下任务：

      • 从 GitHub 移除运行器。
      • 移除机器上的任何自托管运行器应用程序配置文件。
      • 移除任何配置的服务（如果未在交互模式下运行）。

    • **如果您没有权访问机器：** 点击 **强制移除此运行器** 以强制 GitHub 移除运行器。

从组织中移除运行器

注意

  • 此过程会永久删除自托管运行器。如果您只想暂时停止为运行器分配作业，您可以关闭机器或停止 `run` 应用程序。运行器将保持“离线”状态，并且在您使用 `run` 应用程序重新启动运行器之前不会执行任何作业。
  • 如果自托管运行器在 14 天内未连接到 GitHub Actions，则该运行器将自动从 GitHub 中删除。如果临时自托管运行器在 1 天内未连接到 GitHub Actions，则该运行器将自动从 GitHub 中删除。
  • 即时 (JIT) 运行器只能运行单个作业。如果 JIT 运行器从未运行过作业，它们将自动被删除。要删除 JIT 运行器，您必须在 GitHub.com 上删除它。

要从组织中移除自托管运行器，您必须是组织所有者。我们建议您也拥有对自托管运行器机器的访问权限。有关如何使用 REST API 移除自托管运行器的信息，请参阅 "自托管运行器的 REST API 端点"。

如果您没有权限在 GitHub 上移除运行器，但想要重新使用运行器机器，您可以删除自托管运行器应用程序目录（即您下载并解压缩运行器软件的目录）中的 `.runner` 文件。这样，运行器就可以注册，而无需重新下载自托管运行器应用程序。

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

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

    Screenshot of the tabs in an organization's profile. The "Settings" tab is outlined in dark orange.

  3. 在左侧边栏中，点击 **Actions**，然后点击 **Runners**。

  4. 在运行器列表中，点击您要配置的运行器的名称。

  5. 点击 **移除**。

  6. 您将看到移除自托管运行器的说明。根据运行器是否仍然可访问，完成以下任一步骤以移除运行器。

    • **如果您有权访问运行器机器：** 按照屏幕上的说明，根据您的机器操作系统运行移除命令。说明包括所需的 URL 和自动生成的、有限时长的令牌。

      移除命令将执行以下任务：

      • 从 GitHub 移除运行器。
      • 移除机器上的任何自托管运行器应用程序配置文件。
      • 移除任何配置的服务（如果未在交互模式下运行）。

    • **如果您没有权访问机器：** 点击 **强制移除此运行器** 以强制 GitHub 移除运行器。

从企业中移除运行器

如果您使用 GitHub Enterprise Cloud，您也可以从企业中移除运行器。有关更多信息，请参阅 GitHub Enterprise Cloud 文档。