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.
Note
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 Selbst-gehostete Runner hinzufügen.
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.
Note
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 finden Sie unter Selbst-gehostete Runner entfernen und unter Selbst-gehostete Runner hinzufügen.
Du kannst den Runnerdienst in der Windows-Anwendung Services verwalten oder PowerShell verwenden, um die folgenden Befehle auszuführen.
Note
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 Selbst-gehostete Runner hinzufügen.
Ö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
-
Beende die selbstgehostete Runneranwendung, wenn sie gerade ausgeführt wird.
-
Installiere den Dienst mit folgendem Befehl:
sudo ./svc.sh install -
Der Befehl verwendet alternativ ein optionales
user-Argument, um den Dienst als anderer Benutzer zu installieren../svc.sh install USERNAME
Den Dienst installieren
-
Beende die selbstgehostete Runneranwendung, wenn sie gerade ausgeführt wird.
-
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 Überwachen und Behandeln von Problemen mit 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
-
Beende den Dienst, falls er gerade läuft.
-
De-installiere den Dienst mit folgendem Befehl:
sudo ./svc.sh uninstall
```shell
Remove-Service "actions.runner.*"
```
</div>
```shell
./svc.sh uninstall
```
</div>
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.