| Typ-ID | process |
| Runner | Agent |
| Zweck | Prüft ob ein benannter Prozess auf dem Host läuft |
Der Prozess-Check führt pgrep -f <prozessname> auf dem Host-System aus. Findet pgrep mindestens einen laufenden Prozess, dessen vollständige Befehlszeile den konfigurierten String enthält, ist der Check erfolgreich.
Dieser Check läuft nur auf einem Agenten (AgentOnly) und benötigt die Option pid: host in der Docker-Konfiguration. Ohne pid: host sieht der Agent nur Prozesse in seinem eigenen Container-Namensraum.
Benötigte Agent-Konfiguration:
# compose.stage.yml
agent:
pid: host # Pflicht — gibt den Host-pid-Namensraum frei
Das Host-Volume (/:/host/root:ro) wird von diesem Check nicht benötigt.
| Feld | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
| Prozessname | text |
Ja | — | Name oder Teilstring, der gegen laufende Prozesse abgeglichen wird (pgrep -f). Beispiel: nginx, php-fpm, mysqld. |
| Ergebnis | Status |
|---|---|
| Mindestens ein passender Prozess gefunden | ok |
| Kein passender Prozess gefunden | fail |
pgrep nicht verfĂĽgbar |
unknown |
| Kein Prozessname konfiguriert | unknown |
-f gleicht gegen die vollständige Befehlszeile ab, nicht nur den Prozessnamen — das ermöglicht das Finden von Prozessen wie php-fpm: master processnginx: master statt nginxdocker als Prozessname prüft ob der Docker-Daemon läuftpid: host ist Pflicht — ohne es werden immer Fail-Ergebnisse zurückgegeben, da Container-Prozesse isoliert sind