Diese Version von GitHub Enterprise Server wurde eingestellt am 2024-03-26. Es wird keine Patch-Freigabe vorgenommen, auch nicht fĂŒr kritische Sicherheitsprobleme. FĂŒr bessere Leistung, verbesserte Sicherheit und neue Features aktualisiere auf die neueste Version von GitHub Enterprise Server. Wende dich an den GitHub Enterprise-Support, um Hilfe zum Upgrade zu erhalten.

Selbst-gehostete Runner entfernen

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

In diesem Artikel

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

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 Enterprise Server entfernt, wenn er lĂ€nger als 14 Tage keine Verbindung mehr mit GitHub Actions hergestellt 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. Organisationsbesitzer 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, die Organisation oder das Unternehmen auf GitHub Enterprise Server 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. Navigiere auf Ihre GitHub Enterprise Server-Instance 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 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

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 Enterprise Server entfernt, wenn er lĂ€nger als 14 Tage keine Verbindung mehr mit GitHub Actions hergestellt 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, mĂŒssen Sie ein Organisationsbesitzer 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 REST-API-Endpunkte fĂŒr selbst gehostete Runner.

Wenn Sie keinen Zugriff auf das Repository, die Organisation oder das Unternehmen auf GitHub Enterprise Server 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. Navigiere auf Ihre GitHub Enterprise Server-Instance 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 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

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 Enterprise Server entfernt, wenn er lĂ€nger als 14 Tage keine Verbindung mehr mit GitHub Actions hergestellt 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 Sie keinen Zugriff auf das Repository, die Organisation oder das Unternehmen auf GitHub Enterprise Server 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. Klicken Sie in der oberen rechten Ecke von GitHub Enterprise Server auf Ihr Profilfoto und dann auf Unternehmenseinstellungen.

    Screenshot des DropdownmenĂŒs, das angezeigt wird, wenn du auf GitHub Enterprise Server auf das Profilfoto klickst. Die Option „Unternehmenseinstellungen “ ist dunkelorange umrandet.

  2. WĂ€hle auf der Randleiste des Unternehmenskontos die Option Richtlinien aus.

  3. Klicke unter „ Richtlinien“ auf Actions.

  4. Klicke auf die Registerkarte Runner.

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

  6. Klicken Sie auf Entfernen.

  7. 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.