Skip to main content
Wir veröffentlichen regelmäßig Aktualisierungen unserer Dokumentation, und die Übersetzung dieser Seite ist möglicherweise noch nicht abgeschlossen. Aktuelle Informationen findest du in der englischsprachigen Dokumentation.
All products
GitHub Actions

Selbst-gehostete Runner entfernen

In diesem Artikel

Du kannst selbstgehostet Runner dauerhaft aus einem Repository, einer Organisation oder einem Unternehmen entfernen.

Hinweis: GitHub-gehostete Runner werden auf GitHub Enterprise Server derzeit nicht unterstützt. Weitere Informationen zur geplanten zukünftigen Unterstützung findest Du in der GitHub public roadmap.

Einen Runner aus einem Repository entfernen

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 Enterprise Server entfernt, wenn er sich länger als 14 Tage nicht mehr mit GitHub Actions verbunden hat.
Ein kurzlebiger selbstgehosteter Runner wird automatisch aus GitHub Enterprise Server entfernt, wenn er sich länger als 1 Tag nicht mehr mit GitHub Actions verbunden hat.

Um einen selbstgehosteten Runner aus einem Benutzerrepository zu entfernen, musst du der Repositorybesitzer sein. Für ein Organisationsrepository musst du der Besitzer der Organisation sein oder über Administratorzugriff auf das Repository verfügen. Es empfiehlt sich, auch Zugriff auf den selbstgehosteten Runnercomputer zu besitzen. Weitere Informationen zum Entfernen eines selbstgehosteten Runners mit der REST-API findest du unter Aktionen.

Wenn du keinen Zugriff auf das Repository , Organisation oder Enterprise in GitHub Enterprise Server hast, um einen Runner zu entfernen, aber den Runner-Computer wieder verwenden möchtest, kannst du alternativ die .runner-Datei im Verzeichnis der selbst gehosteten Runner-Anwendung löschen. Dadurch kann der Runner registriert werden, ohne die Anwendung für selbst-gehostete Runner erneut herunterladen zu müssen. 1. Navigiere auf deine GitHub Enterprise Server-Instanz zur Hauptseite des Repositorys. 1. 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. 1. Klicke in der linken Seitenleiste auf Aktionen, und klicke dann auf Runner. 1. Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest. 1. Klicken Sie auf Entfernen.

  1. 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 Läufer aus GitHub Enterprise Server.
      • 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 Enterprise Server zu erzwingen.

Einen Runner aus einer Organisation entfernen

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 Enterprise Server entfernt, wenn er sich länger als 14 Tage nicht mehr mit GitHub Actions verbunden hat.
Ein kurzlebiger selbstgehosteter Runner wird automatisch aus GitHub Enterprise Server entfernt, wenn er sich länger als 1 Tag nicht mehr mit GitHub Actions verbunden hat.

Um einen selbst-gehosteten Runner aus einer Organisation zu entfernen, musst du ein Organisationsinhaber sein. Es empfiehlt sich, auch Zugriff auf den selbstgehosteten Runnercomputer zu besitzen. Weitere Informationen zum Entfernen eines selbstgehosteten Runners mit der REST-API findest du unter Aktionen.

Wenn du keinen Zugriff auf das Repository , Organisation oder Enterprise in GitHub Enterprise Server hast, um einen Runner zu entfernen, aber den Runner-Computer wieder verwenden möchtest, kannst du alternativ die .runner-Datei im Verzeichnis der selbst gehosteten Runner-Anwendung löschen. Dadurch kann der Runner registriert werden, ohne die Anwendung für selbst-gehostete Runner erneut herunterladen zu müssen. 1. Navigiere auf deine GitHub Enterprise Server-Instanz zur Hauptseite der Organisation. 1. Klicke unter deinem Organisationsnamen auf die Option Einstellungen. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

Screenshot: Horizontale Navigationsleiste für eine Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet. 1. Klicke in der linken Seitenleiste auf Aktionen, und klicke dann auf Runner. 1. Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest. 1. Klicken Sie auf Entfernen.

  1. 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 Läufer aus GitHub Enterprise Server.
      • 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 Enterprise Server zu erzwingen.

Entfernen eines Runners aus einem Unternehmen

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 Enterprise Server entfernt, wenn er sich länger als 14 Tage nicht mehr mit GitHub Actions verbunden hat.
Ein kurzlebiger selbstgehosteter Runner wird automatisch aus GitHub Enterprise Server entfernt, wenn er sich länger als 1 Tag nicht mehr mit GitHub Actions verbunden hat.

Um einen selbstgehosteten Runner aus einem Unternehmen zu entfernen, musst du ein Unternehmensbesitzer sein. Es empfiehlt sich, auch Zugriff auf den selbstgehosteten Runnercomputer zu besitzen. Weitere Informationen zum Entfernen eines selbstgehosteten Runners mit der REST-API findest du unter den Unternehmensendpunkten in der GitHub Actions-REST-API.

Wenn du keinen Zugriff auf das Repository , Organisation oder Enterprise in GitHub Enterprise Server hast, um einen Runner zu entfernen, aber den Runner-Computer wieder verwenden möchtest, kannst du alternativ die .runner-Datei im Verzeichnis der selbst gehosteten Runner-Anwendung löschen. Dadurch kann der Runner registriert werden, ohne die Anwendung für selbst-gehostete Runner erneut herunterladen zu müssen. 1. Klicke oben rechts auf GitHub Enterprise Server auf dein Profilfoto und dann auf Unternehmenseinstellungen.

![A screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.](/assets/images/enterprise/settings/enterprise-settings.png)

  1. Wähle auf der Randleiste des Unternehmenskontos die Option Richtlinien aus. 1. Klicke unter „ Richtlinien“ auf Aktionen. 1. Klicke auf die Registerkarte Runner. 1. Klicke in der Liste der Runner auf den Namen des Runners, den du konfigurieren möchtest. 1. Klicken Sie auf Entfernen.

  2. 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 Läufer aus GitHub Enterprise Server.
      • 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 Enterprise Server zu erzwingen.