Files

T

Jon Chery 4c2e59cf3f fix(P06): workloadToTaskSpecs command split + runnable examples

Root cause: orca job run <example>.md failed with fork/exec: no such
file or directory on every example. Two compounding problems:

1. workloadToTaskSpecs (internal/cli/job.go:340) passed the entire
   runtime.command string (e.g. "/usr/bin/httpd -f /etc/orca/web-app/
   httpd.conf") as a single binary path to exec.Command, which then
   looked for a file literally named "/usr/bin/httpd -f ..." and
   failed. The v0.9 markdown parser stores command: as a raw string;
   the legacy HCL path had separate command+args fields. Fix: add
   splitCommand helper that splits on strings.Fields into binary+args,
   with /bin/true fallback for empty commands.

2. The example commands referenced binaries that don't exist on a bare
   Linux machine (/usr/bin/httpd, postgres, api-server, fluent-bit).
   Fix: rewrite the 5 example runtime.command values to use /bin/sleep
   3600 (long-running services) or /bin/echo (one-shot job) so they
   run out-of-the-box. Each file has a Production substitution note
   showing the real binary to use in deployment.

Verified: orca job run examples/full-stack/worker.md now succeeds
(exit 0). All 4 services (web-app, api, log-shipper, postgres) start
correctly (task started, pid assigned). 12 new unit tests pass
(splitCommand: 7 cases, workloadToTaskSpecs: 5 cases). All 5 example
jobspecs still parse + validate (gate C-20). make lint clean.

---ci---
project: orca
phase: 6
milestone: v0.10
status: execute
decisions:
  - id: D-195
    decision: split command string via strings.Fields in workloadToTaskSpecs
    rationale: exec.Command expects binary path + args as separate elements;
      the v0.9 markdown parser stores command: as a single string with no
      args field (unlike legacy HCL). strings.Fields is dep-free and handles
      multiple spaces/tabs. Shell quoting (single/double quotes inside the
      command) is not handled — examples avoid sh -c with quoted strings.
    confidence: 0.95
    alternatives: [shellquote.Split from mvdan/sh (adds dependency)]
lessons:
  - The v0.9 markdown jobspec path needs the same command+args split that
    the legacy HCL path had via separate command/args fields. The parser
    stores command: as a raw string; the CLI must split it before passing
    to exec.Command.
  - Example jobspecs should use /bin/sleep and /bin/echo (binaries that
    exist on every Linux machine) so they run out-of-the-box. Descriptive
    production commands belong in a comment block, not in runtime.command.
---/ci---

2026-08-05 21:23:32 +00:00

1.2 KiB

Raw Blame History

kind, name, count, runtime, ports, restart, update, service, health, constraints, affinity, lifecycle

kind

name

count

runtime

ports

restart

update

service

health

constraints

affinity

lifecycle

Service

web-app

one_of	command
process	/bin/sleep 3600

name	port
http	8080

mode	attempts	delay
service	5	2s

strategy	max_parallel	min_healthy_time	healthy_deadline
rolling	1	10s	2m

name	port
web-app	8080

check_type	interval	timeout	unhealthy_threshold
http	5s	1s	2

node.role == "web"

target	weight
zone == "a"	80

post_start

pre_stop

/bin/sh -c 'echo cache warmed'

/bin/sh -c 'sleep 5'

/bin/sh -c 'echo draining web-app'

Web App

Frontend web application serving HTTP on port 8080 via Unix socket. Three replicas with rolling updates, anti-affinity for zone spreading, and lifecycle hooks for cache warm-up and graceful drain.

Production substitution: this example uses /bin/sh -c 'echo ... sleep 3600' so it runs out-of-the-box on any Linux machine. In a real deployment, replace the runtime.command with your actual binary, e.g. /usr/bin/httpd -f /etc/orca/web-app/httpd.conf, and replace the lifecycle hooks with your real scripts (/usr/local/bin/warm-cache.sh, /usr/local/bin/drain.sh).

1.2 KiB Raw Blame History

Web App

1.2 KiB

Raw Blame History