Jobs

Quick Start

This guide runs the image you built in the repo quick start: create a job, point it at your repo, trigger a run, and read the output.

AI assisted, human approved — novem uses AI to review and keep our documentation up to date.

This guide assumes you have a built repo image — if not, run through the repo quick start first to create hello_repo.

novem -j hello_job -C

It comes up as the chains runtime by default.

The chain is a single step: the image built from hello_repo.

echo "hello_repo" | novem -j hello_job -w config/chains

novem resolves the bare name to your image @<your_username>/hello_repo:latest.

Anything under config/env is injected into the container at run time. Use a lower-case name — it's exposed inside the job in both lower- and upper-case.

printf '%s' "world" | novem -j hello_job -w config/env/greet_target

novem -j hello_job -R

# pass input files to the run by appending one or more @file.ext
novem -j hello_job -R @data.csv

# save the run's output files to disk with -o/--output
novem -j hello_job -R -o ./out

Each run is recorded under runs with its own log.

novem -j hello_job -r runs/latest/log

You should see your program's output (Hello from my novem repo!).

Note: Run logs redact the values of your environment variables — a variable printed by your code shows up as ***. That's intentional, so secrets don't leak into logs.

  • Chains — pipe several repo images into a pipeline.
  • Add a cron config/schedule to run the job automatically.