Skip to main content
Version: 5.1.x

Configuration

We provide a simple DSL to configure the CI/CD pipeline. Compared with typical configuration for Buildkite, CircleCI, etc. it is significantly simpler.

We expect the configuration file to be checked into the source repository. The default location is /.aspect/workflows/config.yaml.

An example config looks like this:

.aspect/workflows/config.yaml
---
tasks:
# Checks that the branch is current
branch_freshness:
# Rebase PR changes on main, to avoid churning the repository cache
update_strategy: rebase
# Checks that BUILD file content is up-to-date with sources
gazelle:
flags:
- --remote_cache=grpc://remote-cache.elb.us-east-1.amazonaws.com:8980
# Checks that all tests are passing
test:
collect_coverage: true
# These flags are guaranteed to come after those added by Rosetta,
# so we are sure to override them.
# Most flags belong in your .bazelrc file.
flags:
# Preferences for your code coverage system
- --combined_report=lcov
# Details of local deployment
- --remote_cache=grpc://remote-cache.elb.us-east-1.amazonaws.com:8980
# Allow tests to fetch private container images from dockerhub
- --test_env=DOCKER_USERNAME
- --test_env=DOCKER_PASSWORD
targets:
- //...
- -//experimental/...
info

We're working on exhaustive API documentation for Workflows!