evaluate(1) General Commands Manual evaluate(1)

evaluate - Evaluate a local build script

evaluate [-f|--forward] [-s|--stdin] [-d|--debug] [-n|--name] [-h|--help] [SOURCE]

Evaluate a build configuration from the given source. If --stdin is active then the desired collection/name/[branch] will be read from the input. This will evaluate each step in the build process until a non-continuable error is reached or all steps complete successfully. You can use the quipu(1) command to inspect build artifacts, logs, and other properties.

When the --debug flag is enabled anytime a step fails the user will be prompted to attach to the failed build in an external terminal and investigate the error. Once the user is finished they can press enter and the build will continue.

Users have many different desires in terms of configuration file format. Natively Ayllu will only accept a JSON configuration file for it's build input but supports the use pre-processors to allow users to specify their build in the configuration language of their choosing. Jsonnet is the recommend configuration system supported by Ayllu.

You can configure it in your Ayllu config file as such:


[build.pre_processor]
source = ".ayllu-build.jsonnet"
program = "jsonnet"
args = ["-"]

If the standard streams should be forwarded to the terminal
Read the collection / name from stdin
Pause on step failures so you can attach to the environment
Unique build name
Print help (see a summary with '-h')
[SOURCE]
Build Source can be - for STDIN, PATH, or collection/name
evaluate