Removing self-hosted runners

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

In diesem Artikel

Removing a runner from a repository

Hinweis

  • Dieses Verfahren entfernt den selbst-gehosteten Läufer dauerhaft. Wenn du nur vorübergehend verhindern möchtest, dass einem Runner Aufträge zugewiesen werden, kannst du entweder die Maschine herunterfahren oder die run-Anwendung beenden. Der Runner bleibt im Status „Offline“ weiterhin zugewiesen und führt erst dann wieder Aufträge aus, wenn du ihn über die run-Anwendung neu startest.
  • Ein selbstgehosteter Runner wird automatisch aus GitHub entfernt, wenn er sich länger als 14 Tage nicht mehr mit GitHub Actions verbunden hat. Ein kurzlebiger selbstgehosteter Runner wird automatisch aus GitHub entfernt, wenn er sich länger als 1 Tag nicht mehr mit GitHub Actions verbunden hat.
  • JIT-Runner (Just-In-Time) können nur einen einzelnen Auftrag ausführen. Wenn JIT-Runner nie einen Auftrag ausführen, werden sie automatisch entfernt. Wenn Sie einen JIT-Runner vor dem automatischen Entfernen löschen möchten, müssen Sie den JIT-Runner auf GitHub entfernen.

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 Informationen zu benutzerdefinierten Organisationsrollen.

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-Endpunkte für selbst gehostete Runner.

Wenn du keinen Zugriff auf das Repository, die Organisation oder das Unternehmen auf GitHub hast, um einen Runner zu entfernen, aber den Runner-Rechner wiederverwenden möchten, kannst du alternativ die Datei .runner im Verzeichnis der selbstgehosteten Runner-Anwendung löschen (d. h. das Verzeichnis, in das du die Runner-Software heruntergeladen und entpackt hast). Dadurch kann der Runner registriert werden, ohne die Anwendung für selbst-gehostete Runner erneut herunterladen zu müssen.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Wähle unter dem Namen deines Repositorys die Option Einstellungen aus. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot eines Repositoryheaders mit den Registerkarten. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.

  4. Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest.

  5. Klicken Sie auf Entfernen.

  6. Du wirst Anweisungen zum Entfernen des selbst gehosteten Läufers sehen. Vervollständige einen der folgenden Schritte, um den Läufer zu entfernen, abhängig davon, ob er noch zugänglich ist:

    • Wenn du Zugriff auf den Runnercomputer hast: Folge den Anweisungen auf dem Bildschirm für das Betriebssystem deines Computers, um den Befehl zum Entfernen auszuführen. Die Anweisungen beinhalten die erforderliche URL und ein automatisch generiertes, zeitlich begrenztes Token.

      Der Befehl zum Entfernen führt die folgenden Aufgaben aus:

      • Entfernt den Runner aus GitHub.
      • Entfernt alle selbst-gehosteten Läufer-Anwendungskonfigurationsdateien auf der Maschine.
      • Entfernt alle konfigurierten Dienste, wenn sie nicht im interaktiven Modus ausgeführt werden.

    • Wenn du keinen Zugriff auf den Computer hast: Klicke auf Entfernen dieses Runners erzwingen, um das Entfernen des Runners durch GitHub zu erzwingen.

Removing a runner from an organization

Hinweis

  • Dieses Verfahren entfernt den selbst-gehosteten Läufer dauerhaft. Wenn du nur vorübergehend verhindern möchtest, dass einem Runner Aufträge zugewiesen werden, kannst du entweder die Maschine herunterfahren oder die run-Anwendung beenden. Der Runner bleibt im Status „Offline“ weiterhin zugewiesen und führt erst dann wieder Aufträge aus, wenn du ihn über die run-Anwendung neu startest.
  • Ein selbstgehosteter Runner wird automatisch aus GitHub entfernt, wenn er sich länger als 14 Tage nicht mehr mit GitHub Actions verbunden hat. Ein kurzlebiger selbstgehosteter Runner wird automatisch aus GitHub entfernt, wenn er sich länger als 1 Tag nicht mehr mit GitHub Actions verbunden hat.
  • JIT-Runner (Just-In-Time) können nur einen einzelnen Auftrag ausführen. Wenn JIT-Runner nie einen Auftrag ausführen, werden sie automatisch entfernt. Wenn Sie einen JIT-Runner vor dem automatischen Entfernen löschen möchten, müssen Sie den JIT-Runner auf GitHub entfernen.

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-Endpunkte für selbst gehostete Runner.

For more information about custom organization roles, see Informationen zu benutzerdefinierten Organisationsrollen.

Wenn du keinen Zugriff auf das Repository, die Organisation oder das Unternehmen auf GitHub hast, um einen Runner zu entfernen, aber den Runner-Rechner wiederverwenden möchten, kannst du alternativ die Datei .runner im Verzeichnis der selbstgehosteten Runner-Anwendung löschen (d. h. das Verzeichnis, in das du die Runner-Software heruntergeladen und entpackt hast). Dadurch kann der Runner registriert werden, ohne die Anwendung für selbst-gehostete Runner erneut herunterladen zu müssen.

  1. Navigieren Sie auf GitHub zur Hauptseite der Organisation.

  2. Klicke unter deinem Organisationsnamen auf die Option Einstellungen. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicke in der linken Seitenleiste auf Aktionen und dann auf Runner.

  4. Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest.

  5. Klicken Sie auf Entfernen.

  6. Du wirst Anweisungen zum Entfernen des selbst gehosteten Läufers sehen. Vervollständige einen der folgenden Schritte, um den Läufer zu entfernen, abhängig davon, ob er noch zugänglich ist:

    • Wenn du Zugriff auf den Runnercomputer hast: Folge den Anweisungen auf dem Bildschirm für das Betriebssystem deines Computers, um den Befehl zum Entfernen auszuführen. Die Anweisungen beinhalten die erforderliche URL und ein automatisch generiertes, zeitlich begrenztes Token.

      Der Befehl zum Entfernen führt die folgenden Aufgaben aus:

      • Entfernt den Runner aus GitHub.
      • Entfernt alle selbst-gehosteten Läufer-Anwendungskonfigurationsdateien auf der Maschine.
      • Entfernt alle konfigurierten Dienste, wenn sie nicht im interaktiven Modus ausgeführt werden.

    • Wenn du keinen Zugriff auf den Computer hast: Klicke auf Entfernen dieses Runners erzwingen, um das Entfernen des Runners durch GitHub zu erzwingen.

Removing a runner from an enterprise

Hinweis

  • Dieses Verfahren entfernt den selbst-gehosteten Läufer dauerhaft. Wenn du nur vorübergehend verhindern möchtest, dass einem Runner Aufträge zugewiesen werden, kannst du entweder die Maschine herunterfahren oder die run-Anwendung beenden. Der Runner bleibt im Status „Offline“ weiterhin zugewiesen und führt erst dann wieder Aufträge aus, wenn du ihn über die run-Anwendung neu startest.
  • Ein selbstgehosteter Runner wird automatisch aus GitHub entfernt, wenn er sich länger als 14 Tage nicht mehr mit GitHub Actions verbunden hat. Ein kurzlebiger selbstgehosteter Runner wird automatisch aus GitHub entfernt, wenn er sich länger als 1 Tag nicht mehr mit GitHub Actions verbunden hat.
  • JIT-Runner (Just-In-Time) können nur einen einzelnen Auftrag ausführen. Wenn JIT-Runner nie einen Auftrag ausführen, werden sie automatisch entfernt. Wenn Sie einen JIT-Runner vor dem automatischen Entfernen löschen möchten, müssen Sie den JIT-Runner auf GitHub entfernen.

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.

Wenn du keinen Zugriff auf das Repository, die Organisation oder das Unternehmen auf GitHub hast, um einen Runner zu entfernen, aber den Runner-Rechner wiederverwenden möchten, kannst du alternativ die Datei .runner im Verzeichnis der selbstgehosteten Runner-Anwendung löschen (d. h. das Verzeichnis, in das du die Runner-Software heruntergeladen und entpackt hast). Dadurch kann der Runner registriert werden, ohne die Anwendung für selbst-gehostete Runner erneut herunterladen zu müssen.

  1. Klicke auf GitHub in der oberen rechten Ecke auf dein Profilfoto.

  2. Klicke je nach deiner Umgebung auf Dein Unternehmenoder auf Deine Unternehmen, und klicke dann auf das Unternehmen, das du anzeigen möchtest.

  3. Klicke oben auf der Seite auf Policies.

  4. Klicke unter „ Richtlinien“ auf Actions.

  5. Klicke auf die Registerkarte Runner.

  6. Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest.

  7. Klicken Sie auf Entfernen.

  8. Du wirst Anweisungen zum Entfernen des selbst gehosteten Läufers sehen. Vervollständige einen der folgenden Schritte, um den Läufer zu entfernen, abhängig davon, ob er noch zugänglich ist:

    • Wenn du Zugriff auf den Runnercomputer hast: Folge den Anweisungen auf dem Bildschirm für das Betriebssystem deines Computers, um den Befehl zum Entfernen auszuführen. Die Anweisungen beinhalten die erforderliche URL und ein automatisch generiertes, zeitlich begrenztes Token.

      Der Befehl zum Entfernen führt die folgenden Aufgaben aus:

      • Entfernt den Runner aus GitHub.
      • Entfernt alle selbst-gehosteten Läufer-Anwendungskonfigurationsdateien auf der Maschine.
      • Entfernt alle konfigurierten Dienste, wenn sie nicht im interaktiven Modus ausgeführt werden.

    • Wenn du keinen Zugriff auf den Computer hast: Klicke auf Entfernen dieses Runners erzwingen, um das Entfernen des Runners durch GitHub zu erzwingen.