Skip to content

Commit 703cab2

Browse files
committed
fix(module-11): correct cron output location — gateway writes to ~/.hermes/cron/output/, not terminal
1 parent 5e83c25 commit 703cab2

1 file changed

Lines changed: 28 additions & 14 deletions

File tree

course-site/docs/module-11-triggers/lab/LAB-track-c-kubernetes.mdx

Lines changed: 28 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -133,30 +133,44 @@ hermes cron run <job-id>
133133
# Example: hermes cron run f8081a091378
134134
```
135135

136-
Watch the terminal. The agent will:
137-
1. Load the `sre-k8s-pod-health` SKILL.md runbook
138-
2. Run `kubectl get pods --all-namespaces` against your KIND cluster
139-
3. Print its findings to the terminal
136+
**How cron execution works:**
140137

141-
Expected output shape (from a healthy KIND cluster):
138+
`hermes cron run` does NOT execute the job in your terminal. It schedules the job
139+
for the gateway's next scheduler tick (within 60 seconds). The gateway runs the job
140+
in its own thread, and with `--deliver local`, the output is saved to a file.
141+
142+
**Check your gateway terminal** -- you should see execution status in the gateway logs.
143+
144+
**Read the output file:**
145+
146+
```bash
147+
# Wait ~60 seconds for the gateway scheduler to pick up the job, then:
148+
ls ~/.hermes/cron/output/
149+
# You should see a directory named with your job ID
142150

151+
# Read the output (replace with your job ID)
152+
cat ~/.hermes/cron/output/<job-id>/*.md
143153
```
144-
[Cron] Firing job: daily-k8s-check
145154

146-
Kubernetes Health Check -- kind-lab
155+
Expected output shape (from a healthy KIND cluster):
156+
157+
```markdown
158+
# Kubernetes Health Check -- kind-lab
159+
147160
Namespaces scanned: kube-system, default, local-path-storage
148161

149162
All pods running. No restarts detected above threshold.
150163
Node kind-control-plane: Ready, allocatable CPU 4 cores, memory 8Gi.
151-
152-
[SILENT] (no anomalies to report)
153164
```
154165

155-
:::info About [SILENT]
156-
When the cron agent finds nothing to report, it responds with `[SILENT]`.
157-
This suppresses delivery -- you will not receive a Slack or Telegram notification. This is by
158-
design: agents that cry wolf on every run lose their usefulness. The agent only delivers a
159-
full report when it finds something worth reporting.
166+
:::info About [SILENT] and delivery
167+
When the cron agent finds nothing to report, it may respond with `[SILENT]`.
168+
This suppresses delivery to external channels -- you will not receive a Slack or Telegram
169+
notification. This is by design: agents that cry wolf on every run lose their usefulness.
170+
The agent only delivers a full report when it finds something worth reporting.
171+
172+
With `--deliver local`, output is always saved to `~/.hermes/cron/output/<job-id>/` regardless
173+
of whether the agent reports findings or stays silent. Check the file to see what happened.
160174
:::
161175

162176
### Lifecycle demo: pause and resume

0 commit comments

Comments
 (0)