@pubgcorp/semantic-release-helm

semantic-release-helm

Helm plugin for semantic-release

It updates Helm chart's version and appVersion in Chart.yaml

Install

npm install -D @pubgcorp/semantic-release-helm

Configuration

Options	Descriptions	Required	type	Default
chartRepository	URI for chart repository	yes*	string	none
ociRegistry	URI for OCI regisitry	yes*	string	none
chartDirectory	Chart directory where Chart.yml is located	no	string	.
versionUpdatePolicy	Set update policy for version field of Chart.yaml	no	"fixed" | "sync" | "desync"	"sync"
appVersionUpdatePolicy	Set update policy for appVersion field of Chart.yaml	no	"fixed" | "sync" | "desync"	"sync"

* At least one of ociRegistry or chartrepository is required.

Pass credentials through environment variable to login helm repository.

export HELM_REPOSITORY_USERNAME=<USERNAME>
export HELM_REPOSITORY_PASSWORD=<PASSWORD>

About versionUpdatePolicy & appVersionUpdatePolicy

Update policy

• fixed: Use Fixed version. The version will not be updated
• sync: Use nextRelease.version. New version will be set to nextRelease.version
• desync: Version will be increased according to nextRelease.type (one of major, premajor, minor, preminor, patch, prepatch, prerelease)

Example

{
  "plugins": [
    [
      "@pubgcorp/semantic-release-helm",
      {
        "chartRepository": "https://mychart.company.org/chartrepo/myproject",
        "ociRegistry": "mychart.company.org/myproject",
        "chartDirectory": "./chart",
        "versionUpdatePolicy": "sync",
        "appVersionUpdatePolicy": "fixed"
      }
    ]
  ]
}

• Your chart repository is https://mychart.company.org/chartrepo/myproject and OCI registry is mychart.company.org/myproject.
• Chart.yaml is in chart sub-directory
• version will follow next release version and appVersion will not modified

Old version

# semantic-release version: 1.2.3
version: 1.2.3
appVersion: 2.3.1

New version - Case #1 patch

# semantic-release version: 1.2.4
version: 1.2.4
appVersion: 2.3.1

New version - Case #2 minor

# semantic-release version: 1.3.0
version: 1.3.0
appVersion: 2.3.1

New version - Case #3 major

# semantic-release version: 2.0.0
version: 2.0.0
appVersion: 2.3.1