Skip to content

Automated Dependency Updates for Helmfile

Categories: cd, helm, kubernetes

Renovate supports updating Helmfile dependencies.

File Matching

By default, Renovate will check any files matching the following regular expression: (^|/)helmfile\.ya?ml(?:\.gotmpl)?$.

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

Supported datasources

This manager supports extracting the following datasources: helm, docker.

Default config

{
  "registryAliases": {
    "stable": "https://charts.helm.sh/stable"
  },
  "commitMessageTopic": "helm chart {{depName}}",
  "fileMatch": [
    "(^|/)helmfile\\.ya?ml(?:\\.gotmpl)?$"
  ]
}

Additional Information

Checks helmfile.yaml files and extracts dependencies for the helm datasource.

The helmfile manager defines this default registryAlias:

{
  "registryAliases": {
    "stable": "https://charts.helm.sh/stable"
  }
}

If your Helm charts make use of repository aliases then you will need to configure an registryAliases object in your config to tell Renovate where to look for them. Be aware that alias values must be properly formatted URIs.

If you need to change the versioning format, read the versioning documentation to learn more.

Private repositories and registries

To use private sources of Helm charts, you must set the password and username you use to authenticate to the private source. For this you use a custom hostRules array.

OCI registries

{
  hostRules: [
    {
      // global login
      matchHost: 'ghcr.io',
      hostType: 'docker',
      username: '<some-username>',
      password: '<some-password>',
    },
    {
      // login with encrypted password
      matchHost: 'https://ghci.io',
      hostType: 'docker',
      username: '<some-username>',
      encrypted: {
        password: 'some-encrypted-password',
      },
    },
  ],
}

Open items

The below list of features were current when this page was generated on December 07, 2024.

Feature requests

  • helmfile: gracefully ignore relative paths outside of repository #29814
  • helmfile: support dependencies of a release #23344