helm-ci
Installation
Entrypoint
Types
HelmCi

helm-ci

This Dagger scenario composes the local Helm and Git modules into portable
Helm chart verification and publication workflows.

Installation

dagger install github.com/riftonix/daggerverse/scenarios/helm-ci@v1.2.0

Entrypoint

Return Type

HelmCi !

Arguments

Name	Type	Default Value	Description
source	Directory	-	Repository root directory
helmImageRegistry	String	"docker.io"	Helm image registry
helmImageRepository	String	"alpine/helm"	Helm image repository
helmImageTag	String	"4.2.3"	Helm image tag
helmContainerUserId	String	"65532"	Helm container user
gitImageRegistry	String	"docker.io"	Git image registry for changed-chart detection
gitImageRepository	String	"alpine/git"	Git image repository for changed-chart detection
gitImageTag	String	"v2.54.0"	Git image tag for changed-chart detection
gitContainerUserId	String	"65532"	Git container user for changed-chart detection
helmUnittestImageRegistry	String	"docker.io"	Helm unittest image registry
helmUnittestImageRepository	String	"helmunittest/helm-unittest"	Helm unittest image repository
helmUnittestImageTag	String	"4.2.0-1.1.0"	Helm unittest image tag
helmUnittestContainerUserId	String	"65532"	Helm unittest container user

Example

dagger -m github.com/riftonix/daggerverse/scenarios/helm-ci@a98bdd026dada8f30696714b9f9fe68f324a1b86 call \

func (m *MyModule) Example() *dagger.HelmCi  {
	return dag.
			Helmci()
}

@function
def example() -> dagger.HelmCi:
	return (
		dag.helm_ci()
	)

@func()
example(): HelmCi {
	return dag
		.helmCi()
}

Types

HelmCi 🔗

getChartOciUrl() 🔗

Return the chart OCI namespace URL derived from its Git tag prefix.

Return Type

String !

Arguments

Name	Type	Default Value	Description
ociBaseUrl	String !	-	Base OCI registry URL without chart namespace
gitTagPrefix	String !	-	Git release tag prefix for the chart

Example

dagger -m github.com/riftonix/daggerverse/scenarios/helm-ci@a98bdd026dada8f30696714b9f9fe68f324a1b86 call \
 get-chart-oci-url --oci-base-url string --git-tag-prefix string

func (m *MyModule) Example(ctx context.Context, ociBaseUrl string, gitTagPrefix string) string  {
	return dag.
			Helmci().
			Getchartociurl(ctx, ociBaseUrl, gitTagPrefix)
}

@function
async def example(ocibaseurl: str, gittagprefix: str) -> str:
	return await (
		dag.helm_ci()
		.getchartociurl(ocibaseurl, gittagprefix)
	)

@func()
async example(ociBaseUrl: string, gitTagPrefix: string): Promise<string> {
	return dag
		.helmCi()
		.getChartOciUrl(ociBaseUrl, gitTagPrefix)
}

getChartReleaseTag() 🔗

Return the chart-scoped Git release tag.

Return Type

String !

Arguments

Name	Type	Default Value	Description
gitTagPrefix	String !	-	Git release tag prefix for the chart
chartSource	Directory	null	Optional Helm chart directory; defaults to the scenario source
version	String	null	Optional chart version override

Example

dagger -m github.com/riftonix/daggerverse/scenarios/helm-ci@a98bdd026dada8f30696714b9f9fe68f324a1b86 call \
 get-chart-release-tag --git-tag-prefix string

func (m *MyModule) Example(ctx context.Context, gitTagPrefix string) string  {
	return dag.
			Helmci().
			Getchartreleasetag(ctx, gitTagPrefix)
}

@function
async def example(gittagprefix: str) -> str:
	return await (
		dag.helm_ci()
		.getchartreleasetag(gittagprefix)
	)

@func()
async example(gitTagPrefix: string): Promise<string> {
	return dag
		.helmCi()
		.getChartReleaseTag(gitTagPrefix)
}

publishChart() 🔗

Publish one Helm chart and push its Git release tag.

Return Type

String !

Arguments

Name	Type	Default Value	Description
ociBaseUrl	String !	-	Base OCI registry URL without chart namespace
gitTagPrefix	String !	-	Git release tag prefix for the chart
gitToken	Secret	null	Optional HTTPS token used to push the release Git tag
chartSource	Directory	null	Optional Helm chart directory; defaults to the scenario source
version	String	null	Optional chart version override
appVersion	String	null	Optional appVersion override
withDependencyUpdate	Boolean !	true	Run Helm dependency update before publishing
username	String	null	Registry username for login
password	Secret	null	Registry password
insecure	Boolean	false	Allow plain http pushes
gitHost	String !	"github.com"	HTTPS Git host used for release tag authentication
gitUsername	String !	"x-access-token"	HTTPS Git username used for release tag authentication
gitRemote	String !	"origin"	Git remote that receives the release tag

Example

dagger -m github.com/riftonix/daggerverse/scenarios/helm-ci@a98bdd026dada8f30696714b9f9fe68f324a1b86 call \
 publish-chart --oci-base-url string --git-tag-prefix string --with-dependency-update boolean --git-host string --git-username string --git-remote string

func (m *MyModule) Example(ctx context.Context, ociBaseUrl string, gitTagPrefix string, withDependencyUpdate bool, gitHost string, gitUsername string, gitRemote string) string  {
	return dag.
			Helmci().
			Publishchart(ctx, ociBaseUrl, gitTagPrefix, withDependencyUpdate, gitHost, gitUsername, gitRemote)
}

@function
async def example(ocibaseurl: str, gittagprefix: str, withdependencyupdate: bool, githost: str, gitusername: str, gitremote: str) -> str:
	return await (
		dag.helm_ci()
		.publishchart(ocibaseurl, gittagprefix, withdependencyupdate, githost, gitusername, gitremote)
	)

@func()
async example(ociBaseUrl: string, gitTagPrefix: string, withDependencyUpdate: boolean, gitHost: string, gitUsername: string, gitRemote: string): Promise<string> {
	return dag
		.helmCi()
		.publishChart(ociBaseUrl, gitTagPrefix, withDependencyUpdate, gitHost, gitUsername, gitRemote)
}

verifyChart() 🔗

Verify the Helm chart supplied as the scenario source.

Return Type

String !

Arguments

Name	Type	Default Value	Description
values	File	null	Optional values.yaml file
releaseName	String !	"ci-release"	Helm release name for templating
chartSource	Directory	null	Optional Helm chart directory; defaults to the scenario source
unittestSuiteFiles	[String ! ]	null	Optional Helm unittest suite file glob patterns

Example

dagger -m github.com/riftonix/daggerverse/scenarios/helm-ci@a98bdd026dada8f30696714b9f9fe68f324a1b86 call \
 verify-chart --release-name string

func (m *MyModule) Example(ctx context.Context, releaseName string) string  {
	return dag.
			Helmci().
			Verifychart(ctxreleaseName)
}

@function
async def example(releasename: str) -> str:
	return await (
		dag.helm_ci()
		.verifychart(releasename)
	)

@func()
async example(releaseName: string): Promise<string> {
	return dag
		.helmCi()
		.verifyChart(releaseName)
}