Skip to content

Automated Dependency Updates for Buildpacks

Categories: docker, ci, cd

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 managerFilePatterns value, please follow this link.

Supported datasources

This manager supports extracting the following datasources: docker, buildpacks-registry.

Default config

{
  "commitMessageTopic": "buildpack {{depName}}",
  "managerFilePatterns": [
    "/(^|/)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)

Note: 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