Skip to main content

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.

Platform navigation

Hinweis: Du musst GitHub 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.

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

Hinweis: Du musst GitHub 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

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

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

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