Selbst-gehostete Runner entfernen

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

In diesem Artikel

Einen Runner aus einem Repository entfernen

Hinweise:

  • 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 länger als 14 Tage keine Verbindung mehr mit GitHub Actions hergestellt 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.

Um einen selbstgehosteten Runner aus einem Benutzerrepository zu entfernen, musst du der Repositorybesitzer sein. Organisationsbesitzer*innen können einen Runner aus einem Repository in der Organisation entfernen.

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

Wenn Sie keinen Zugriff auf das Repository oder die Organisation auf GitHub haben, um einen Runner zu entfernen, aber den Runner-Rechner wiederverwenden möchten, können Sie alternativ die Datei .runner im Verzeichnis der selbst gehosteten Runner-Anwendung löschen (d. h. das Verzeichnis, in das Sie die Runner-Software heruntergeladen und entpackt haben). 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 Läufer 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.

Einen Runner aus einer Organisation entfernen

Hinweise:

  • 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 länger als 14 Tage keine Verbindung mehr mit GitHub Actions hergestellt 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.

Um einen selbstgehosteten Runner aus einer Organisation zu entfernen, müssen Sie Organisationsbesitzer*in. 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 REST-API-Endpunkte für selbst gehostete Runner.

Wenn Sie keinen Zugriff auf das Repository oder die Organisation auf GitHub haben, um einen Runner zu entfernen, aber den Runner-Rechner wiederverwenden möchten, können Sie alternativ die Datei .runner im Verzeichnis der selbst gehosteten Runner-Anwendung löschen (d. h. das Verzeichnis, in das Sie die Runner-Software heruntergeladen und entpackt haben). 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 Läufer 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.

Entfernen eines Runners aus einem Unternehmen

Wenn du GitHub Enterprise Cloud verwendest, kannst du auch Runner aus einem Unternehmen entfernen. Weitere Informationen findest du in der Dokumentation zu GitHub Enterprise Cloud.