configurator

README

Configurator

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.

Basic Usage

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.

Usage with Prow

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.

Deserialization Options

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.