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 you don't, 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. Give each variable a lower-case name. It is 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

# to pass input files, append one or more filenames, each prefixed with @
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.
  • Schedule — run the job automatically on a cron schedule.
  • Runs — inspect a run's log, output, stats and status.