Skip to content

Decision Executor Lifecycle (HyOps Module)

platform/network/decision-executor installs the last non-destructive stage in the current control loop. It watches approved execution records and stages normalized execution-attempt records for later real execution planes.

What it does

  • runs as systemd on the shared control host
  • watches /opt/hybridops/decision-consumer/state/executions
  • writes dry-run execution-attempt records under /opt/hybridops/decision-executor/state/attempts
  • does not invoke hyops, a runner, or GitHub Actions in v1

Current operating model

  1. platform/network/decision-service emits decision records.
  2. platform/network/decision-dispatcher emits routed dispatch requests.
  3. platform/network/decision-consumer emits approved-ready execution records.
  4. platform/network/decision-executor emits dry-run-ready execution-attempt records.

This keeps the first release posture safe while making the control loop fully observable.

Paths

  • executor config: /opt/hybridops/decision-executor/config/config.json
  • executor state: /opt/hybridops/decision-executor/state/state.json
  • executor attempts: /opt/hybridops/decision-executor/state/attempts
  • executor log: /opt/hybridops/decision-executor/logs/executor.log

Preconditions

  • platform/network/decision-consumer is already installed and healthy
  • the control host is reachable from the current HyOps controller

Apply

hyops apply --env dev \
  --module platform/network/decision-executor \
  --inputs "$HOME/.hybridops/envs/dev/config/modules/platform__network__decision-executor/latest.inputs.yml"

Verify

Module state:

jq '.status, .outputs' \
  "$HOME/.hybridops/envs/dev/state/modules/platform__network__decision-executor/latest.json"

Host runtime:

ssh opsadmin@5.161.116.216 \
  'sudo systemctl is-active hyops-decision-executor && sudo cat /opt/hybridops/decision-executor/state/state.json'

Expected:

  • cap.control.decision_executor = ready
  • decision_executor.execution_mode = dry-run
  • the hyops-decision-executor service is active

Destroy

hyops destroy --env dev \
  --module platform/network/decision-executor \
  --inputs "$HOME/.hybridops/envs/dev/config/modules/platform__network__decision-executor/latest.inputs.yml"

References