Configurator takes some YAML TestGrid config files and (optionally) a Prow configuration and generates a complete TestGrid configuration.
This utility is important for the inner workings of TestGrid, but if
you're looking to just add to or modify an existing configuration, read config.md
instead.
configurator --yaml=config.yaml --print-text --oneshot will read the configuration from the YAML
file and print it to standard output for humans to read.
If --oneshot is omitted, it will do the same thing and continue running. If the configuration it's
reading is modified, it will generate again.
Instead of --print-text, you can just --validate-config-file, or specify an --output.
--output=/path/outputfile # Writes the generated configuration to that file
--output=gcs://bucket/object # Writes the generated configuration to a GCS bucket. Credentials are needed.--default specifies default settings to use whenever a setting isn't specified in the YAML configuration.
If TestGrid is running in parallel with Prow, configuration can be annotated to a Prow job instead
of separately configured in a YAML file. Details for how to write these annotations are in config.md.
The options --prow-config and --prow-job-config are used to specify where the Prow configurations are.
They must be specified together.
Configurator reads YAML configurations. TestGrid itself expects its configuration to be formatted as a protocol buffer, and has no concept of a YAML configuration.
By default, Configurator outputs a config.proto, since it usually serves configurations to TestGrid.
Configuration can also output a YAML configuration; for an example, see transfigure.