Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Diese Version von GitHub Enterprise wird eingestellt am 2023-03-15. 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. Wende dich an den GitHub Enterprise-Support, um Hilfe zum Upgrade zu erhalten.

Die Anwendung für selbst-gehostete Runner als Dienst konfigurieren

Du kannst die Anwendung für selbstgehostete Runner als Dienst konfigurieren, um die Runneranwendung automatisch zu starten, wenn der Rechner hochfährt.

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.

Hinweis: Du musst GitHub Enterprise Server einen Runner hinzufügen, bevor du die Anwendung für selbstgehostete Runner als Dienst konfigurieren kannst. Weitere Informationen findest du unter Hinzufügen von selbstgehosteten Runnern.

Für Linux-Systeme mit systemd kannst du das Skript svc.sh verwenden, das nach dem erfolgreichen Hinzufügen des Runners erstellt wird, um die Anwendung als Dienst zu installieren und deren Nutzung zu verwalten.

Öffne auf dem Runnercomputer eine Shell in dem Verzeichnis, in dem du die selbst gehostete Runneranwendung installiert hast. Verwende die folgenden Befehle, um den Dienst für selbstgehostete Runner zu installieren und zu verwalten.

Hinweis: Die Konfiguration der Anwendung für selbstgehostete Runner als Windows-Dienst ist Teil des Anwendungskonfigurationsprozesses. Wenn du die Anwendung für selbst-gehostete Runner bereits konfiguriert hast, aber nicht als Dienst, dann musst du den Runner aus GitHub entfernen und die Anwendung neu konfigurieren. Wenn du die Anwendung neu konfigurierst, wähle die Option, die Anwendung als Dienst zu konfigurieren.

Weitere Informationen findest du unter Entfernen von selbstgehosteten Runnern und Hinzufügen selbstgehosteter Runner.

Du kannst den Runnerdienst in der Windows-Anwendung Services verwalten oder PowerShell verwenden, um die folgenden Befehle auszuführen.

Hinweis: Du musst GitHub Enterprise Server einen Runner hinzufügen, bevor du die Anwendung für selbstgehostete Runner als Dienst konfigurieren kannst. Weitere Informationen findest du unter Hinzufügen von selbstgehosteten Runnern.

Öffne auf dem Runnercomputer eine Shell in dem Verzeichnis, in dem du die selbst gehostete Runneranwendung installiert hast. Verwende die folgenden Befehle, um den Dienst für selbstgehostete Runner zu installieren und zu verwalten.

Den Dienst installieren

  1. Beende die selbstgehostete Runneranwendung, wenn sie gerade ausgeführt wird.

  2. Installiere den Dienst mit folgendem Befehl:

    sudo ./svc.sh install
  3. Der Befehl verwendet alternativ ein optionales user-Argument, um den Dienst als anderer Benutzer zu installieren.

    ./svc.sh install USERNAME

Den Dienst installieren

  1. Beende die selbstgehostete Runneranwendung, wenn sie gerade ausgeführt wird.

  2. Installiere den Dienst mit folgendem Befehl:

    ./svc.sh install

Den Dienst starten

Starte den Dienst mit folgendem Befehl:

sudo ./svc.sh start
Start-Service "actions.runner.*"
./svc.sh start

Den Status des Dienstes überprüfen

Überprüfe den Status des Dienstes mit folgendem Befehl:

sudo ./svc.sh status
Get-Service "actions.runner.*"
./svc.sh status

Weitere Informationen zum Anzeigen des Status deines selbstgehosteten Runners findest du unter Überwachung und Problembehandlung bei selbstgehosteten Runnern.

Den Dienst beenden

Beende den Dienst mit dem folgenden Befehl:

sudo ./svc.sh stop
Stop-Service "actions.runner.*"
./svc.sh stop

Den Dienst de-installieren

  1. Beende den Dienst, falls er gerade läuft.

  2. De-installiere den Dienst mit folgendem Befehl:

    sudo ./svc.sh uninstall
    Remove-Service "actions.runner.*"
    ./svc.sh uninstall

Dienst für selbst-gehosteten Runner anpassen

Wenn du die oben genannte Standardkonfiguration des systemd-Dienstes nicht verwenden möchtest, kannst du einen angepassten Dienst erstellen oder deinen bevorzugten Dienstmechanismus nutzen. Erwäge die Verwendung der serviced-Vorlage unter actions-runner/bin/actions.runner.service.template als Referenz. Wenn du einen angepassten Dienst verwendest, muss der selbstgehostete Runnerdienst immer mit dem Einstiegspunkt runsvc.sh aufgerufen werden.

Dienst für selbst-gehosteten Runner anpassen

Wenn du die oben genannte Standardkonfiguration des „launchd“-Dienstes nicht verwenden möchtest, kannst du einen angepassten Dienst erstellen oder deinen bevorzugten Dienstmechanismus nutzen. Erwäge die Verwendung der plist-Vorlage unter actions-runner/bin/actions.runner.plist.template als Referenz. Wenn du einen angepassten Dienst verwendest, muss der selbstgehostete Runnerdienst immer mit dem Einstiegspunkt runsvc.sh aufgerufen werden.