Diagnostic code

ZBX-E0801

can't read the build file

Kind

error

Blame

user

Exit code

1

What it means

zbx build reads zbx.build.zon in the project directory (the nearest directory up with a zbx.lock, else the working directory), or the file named with -f, which must be inside the project. It is a small subset of ZON: structs, strings, string lists, true and false, and .version = 1, with // comments. The cause names the line and column and what was expected there, or the value that is refused and why.

The fields: .version and .image are required, .steps is optional. A step has .name ([a-z0-9-], at most 32 bytes, not "image"), .base (an image reference), .run (an argv), and optionally .inputs, .needs, .env (KEY=VALUE) and .network. .image has an optional .base, .add (each with .from, a step, and .to, an absolute path) and .config.

Print what a file says, once it reads, with zbx build --graph.

Offline

The same text, without a network:

zbx explain E0801