buildcharts generate is the core step that turns repository metadata into an executable Docker Buildx Bake plan.
What it reads
During generation, BuildCharts reads:
build.ymlcharts/buildcharts/Chart.yamlcharts/buildcharts/Chart.lock if it exists
What it validates
Before writing output, BuildCharts validates:
- There is exactly one
build target
- Every target
type matches a chart alias from Chart.yaml
When Chart.lock exists and --ignore-lock is not set, buildcharts generate checks:
- Missing lock entries
- Version mismatches between
Chart.yaml and Chart.lock
- Orphaned lock entries
- Registry digest mismatches during pull
If the lock file is out of sync, BuildCharts stops and tells you to refresh it. See Lock files.
What it does
- Removes the previous
.buildcharts folder.
- Pulls chart artifacts into
.buildcharts.
- Runs configured plugins.
- Writes
.buildcharts/docker-bake.hcl.
build.yml currently targets Docker Bake HCL through a dedicated generator. Since the interface is intentionally minimal, future work may add more generators. You can also clone the project and build your own.
Usage
The generated Bake file lives here:
Run it with:
Related pages
