Documentation Index
Fetch the complete documentation index at: https://docs.aspect.build/llms.txt
Use this file to discover all available pages before exploring further.
This diagram shows the functional architecture of the Aspect Workflows product. The product builds on a set of Features that optimize technical workflows.
The core features are:
- Aspect Configuration Language (AXL), which lets you define custom configurations.
- BUILD file generation for process automation.
- Acceleration services such as Remote Cache and Remote Execution, which boost performance.
These features support a set of modular Tasks essential for the development and delivery cycle, such as “Build & Test,” “Delivery,” “Format,” and “Lint.” The architecture lets you extend capabilities through Custom Tasks using the Aspect Configuration Language, ensuring flexibility and integration with existing workflows.
Powering Aspect Open Source Projects
You can see Workflows in action on our open-source repositories.
Here is an example configuration file from aspect-build/bazel-examples:
.aspect/workflows/config.yaml
---
tasks:
- gazelle:
- buildifier:
- lint:
- format:
- test:
targets:
- //...
bazel:
flags:
- --config=rbe
- --test_tag_filters=-skip-on-aspect-workflows
- delivery:
auto_deliver: true
stamp_flags:
- --config=release
rules:
- deliverable: 'kind("oci_push rule", //...)'
condition:
branches:
- '^main$'
- '^release-.*$'
rosetta run <task_id>.
Running Aspect Workflows on Buildkite, the above Workflows configuration powers a Buildkite pipeline that looks like this.
Browse live examples
Bazel examples: source code
Config file: Aspect config file
Check out the live examples for your CI provider below.
Buildkite
bazel-examples running on Aspect Workflows + Buildkite
CircleCI
bazel-examples-cci running on Aspect Workflows + CircleCI
GitHub Actions
bazel-examples-gha running on Aspect Workflows + GitHub Actions
GitLab CI/CD
bazel-examples-gl running on Aspect Workflows + GitLab
