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.
Currently build.yml is transformed using a Docker bake HCL specific generator. However since it acts as an interface with minimal intent you can easily clone the code and implement your own generators.
Main output
The generated Bake file lives here:
.buildcharts/docker-bake.hcl
buildcharts generate
docker buildx bake --file .buildcharts/docker-bake.hcl
Related pages
