Helm

“auths” defines the registry credentials, keyed by registry host without scheme.

remark:

• when empty, Updatecli uses the local OCI credentials, such as the Docker ones.

example:

auths:
  "ghcr.io":
    token: "xxx"
  "index.docker.io":
    username: "admin"
    password: "password"

“password” defines the container registry password used for authentication.

default: credentials are retrieved from the local environment, such as ~/.docker/config.json.

remark:

• “password” requires “username”.
• “token” cannot be combined with both “username” and “password”.

“token” defines the container registry bearer token used for authentication.

default: credentials are retrieved from the local environment, such as ~/.docker/config.json.

remark:

• “token” cannot be combined with both “username” and “password”.

“username” defines the container registry username used for authentication.

default: credentials are retrieved from the local environment, such as ~/.docker/config.json.

remark:

• “username” requires “password”.
• “token” cannot be combined with both “username” and “password”.

“digest” defines whether the generated manifests pin the image digest in addition to the tag.

default: true

remark:

• it applies to container images only.

“ignore” defines rules to exclude matching chart dependencies or container images from the autodiscovery.

remark:

• a chart dependency or container image is ignored when it matches at least one rule.

“containers” defines the container images to match, keyed by image name.

remark:

• an empty value matches any version.
• otherwise the value is a semantic version constraint, such as “>=1.0.0”.
• when the version or the constraint cannot be parsed, the value must equal the version.
• the value is compared with the image tag.

“dependencies” defines the chart dependencies to match, keyed by dependency name.

remark:

• an empty value matches any version.
• otherwise the value is a semantic version constraint, such as “>=1.0.0”.
• when the version or the constraint cannot be parsed, the value must equal the version.

“path” defines a Helm chart directory path pattern.

remark:

• the pattern must match the whole path, not just a substring.
• the pattern follows the Go filepath.Match syntax, such as “*” or “?”.

“ignorechartdependency” disables the chart dependency updates.

default: false

“ignorecontainer” disables the container image updates.

default: false

“only” defines rules to restrict the autodiscovery to matching chart dependencies or container images.

remark:

• a chart dependency or container image is kept only when it matches at least one rule.

“containers” defines the container images to match, keyed by image name.

remark:

• an empty value matches any version.
• otherwise the value is a semantic version constraint, such as “>=1.0.0”.
• when the version or the constraint cannot be parsed, the value must equal the version.
• the value is compared with the image tag.

“dependencies” defines the chart dependencies to match, keyed by dependency name.

remark:

• an empty value matches any version.
• otherwise the value is a semantic version constraint, such as “>=1.0.0”.
• when the version or the constraint cannot be parsed, the value must equal the version.

“path” defines a Helm chart directory path pattern.

remark:

• the pattern must match the whole path, not just a substring.
• the pattern follows the Go filepath.Match syntax, such as “*” or “?”.

“rootdir” defines the directory where the crawler starts searching for Helm charts.

default: the scm directory when “scmid” is set, otherwise the directory relative paths resolve from, by default the working directory.

remark:

• a relative path is resolved from the default directory.
• an absolute path is used as is, instead of the scm directory.

“skippackaging” sets “skippackaging” on the generated helm targets.

default: false

remark:

• see the “skippackaging” field of the helm resource.

“versionfilter” defines the version filter used by the generated manifests.

default:

• chart dependencies: kind “semver” with pattern “*”, the latest version.
• container images: kind “semver” with pattern “>=”, combined with a tag filter derived from the current tag.

remark:

• with kind “semver”, “pattern” accepts:
  • “prerelease”: the latest prerelease of the current version.
  • “patch”: patch updates only.
  • “minor”: patch and minor updates.
  • “minoronly”: minor updates only.
  • “major”: patch, minor and major updates.
  • “majoronly”: major updates only.
  • a version constraint, such as “>= 1.0.0”.
• with kind “regex”, “pattern” accepts a regular expression.
• more examples at https://www.updatecli.io/docs/core/versionfilter/

example:

versionfilter:
  kind: semver
  pattern: minor

“kind” defines the versioning scheme used to select a version.

default: latest

remark:

• accepted values are “latest”, “semver”, “regex”, “regex/semver”, “time”, “regex/time”, “lex” and “pep440”.
• “latest” returns the last version of the list.
• “lex” sorts the versions lexicographically and returns the last one.
• “pep440” follows https://peps.python.org/pep-0440/

example:

• kind: semver

“pattern” defines the version pattern, according to “kind”.

default:

• latest: “latest”
• semver and pep440: “*”
• regex: “.*”
• time and regex/time: “2006-01-02”

remark:

• for “latest”, “latest” returns the last version, any other value must match a version exactly.
• for “semver” and “regex/semver”, it is a semantic versioning constraint.
• for “pep440”, it is a pep440 version specifier.
• for “regex”, it is a regular expression.
• for “time” and “regex/time”, it is a Go date layout.
• ignored by “lex”.

example:

• pattern: ~1.2
• pattern: “>=1.0.0 <2.0.0”
• pattern: ^v\d+.\d+.\d+$

“regex” defines the regular expression extracting the version from each entry.

remark:

• only used by the kinds “regex/semver” and “regex/time”.
• the value of the first capture group is used as the version.

example:

• regex: ^v(\d+.\d+.\d+)$

“replaceall” applies a regular expression replacement to each version before filtering.

remark:

• only used by the kinds “regex”, “regex/semver” and “regex/time”.
• the replacement runs before “pattern” or “regex” is evaluated.

example:

replaceall:
  pattern: "_"
  replacement: "."

turns “curl-8_15_0” into “curl-8.15.0”.

“pattern” defines the regular expression matching the text to replace.

example:

• pattern: “_”

“replacement” defines the text replacing each match of “pattern”.

remark:

• capture groups can be referenced with $1, $2, and so on.

example:

• replacement: “.”

“strict” enforces strict semantic versioning rules when parsing versions.

default: false

remark:

• only used by the kinds “semver” and “regex/semver”.

“versionincrement” sets “versionincrement” on the generated helm targets.

It defines how the chart version is bumped when the chart changes.

default: minor, the helm target default.

remark:

• accepted values are a comma separated list of “major”, “minor” and “patch”, or one of “auto” or “none” on its own.

example:

• versionincrement: patch
• versionincrement: none