Skip to content

Automated Dependency Updates for Buildpacks

Categories: docker

Renovate supports updating Buildpacks dependencies.

File Matching

By default, Renovate will check any files matching the following regular expression: (^|/)project\.toml$.

For details on how to extend a manager's fileMatch value, please follow this link.

Supported datasources

This manager supports extracting the following datasources: docker.

Default config

{
  "commitMessageTopic": "buildpack {{depName}}",
  "fileMatch": [
    "(^|/)project\\.toml$"
  ],
  "pinDigests": false
}

Additional Information

The buildpacks manager updates Cloud Native Buildpacks project descriptors in project.toml files. A project.toml file can reference builder / buildpack images by URIs. Renovate can update a project.toml file if:

  • It can find the file
  • The file follows the project descriptor specifications
  • The buildpack uri is an OCI image reference (references to a local file or buildpack registry are ignored)

If you use buildpacks in the io.buildpacks.group array, then you must configure the Docker reference (uri) for Renovate to work.

Example of a project.toml file with Docker reference URIs
[_]
schema-version = "0.2"

[io.buildpacks]
builder = "registry.corp/builder/noble:1.1.1"

[[io.buildpacks.group]]
uri = "docker://buildpacks/java:2.2.2"

[[io.buildpacks.group]]
uri = "buildpacks/nodejs:3.3.3"

[[io.buildpacks.group]]
uri = "file://local.oci" # will be ignored