Release

class Release : KotlinCustomResource

A Release is an instance of a chart running in a Kubernetes cluster. A Chart is a Helm package. It contains all the resource definitions necessary to run an application, tool, or service inside a Kubernetes cluster. This resource models a Helm Release as if it were created by the Helm CLI. The underlying implementation embeds Helm as a library to perform the orchestration of the resources. As a result, the full spectrum of Helm features are supported natively. You may also want to consider the Chart resource as an alternative method for managing helm charts. For more information about the trade-offs between these options see: Choosing the right Helm resource for your use case

Example Usage

Local Chart Directory

No Java example available.

Remote Chart

No Java example available.

Set Chart Values

No Java example available.

Deploy Chart into Namespace

No Java example available.

Depend on a Chart resource

No Java example available.

Specify Helm Chart Values in File and Code

No Java example available.

Query Kubernetes Resource Installed By Helm Chart

No Java example available.

Import

An existing Helm Release resource can be imported using its type token, name and identifier, e.g.

$ pulumi import kubernetes:helm.sh/v3:Release myRelease <namespace>/<releaseName>

Properties

Link copied to clipboard
val allowNullValues: Output<Boolean>?

Whether to allow Null values in helm chart configs.

Link copied to clipboard
val atomic: Output<Boolean>?

If set, installation process purges chart on fail. skipAwait will be disabled automatically if atomic is used.

Link copied to clipboard
val chart: Output<String>

Chart name to be installed. A path may be used.

Link copied to clipboard
val cleanupOnFail: Output<Boolean>?

Allow deletion of new resources created in this upgrade when upgrade fails.

Link copied to clipboard
val createNamespace: Output<Boolean>?

Create the namespace if it does not exist.

Link copied to clipboard

Run helm dependency update before installing the chart.

Link copied to clipboard
val description: Output<String>?

Add a custom description

Link copied to clipboard
val devel: Output<Boolean>?

Use chart development versions, too. Equivalent to version '>0.0.0-0'. If version is set, this is ignored.

Link copied to clipboard
val disableCRDHooks: Output<Boolean>?

Prevent CRD hooks from running, but run other hooks. See helm install --no-crd-hook

Link copied to clipboard

If set, the installation process will not validate rendered templates against the Kubernetes OpenAPI Schema

Link copied to clipboard
val disableWebhooks: Output<Boolean>?

Prevent hooks from running.

Link copied to clipboard
val forceUpdate: Output<Boolean>?

Force resource update through delete/recreate if needed.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val keyring: Output<String>?

Location of public keys used for verification. Used only if verify is true

Link copied to clipboard
val lint: Output<Boolean>?

Run helm lint when planning.

Link copied to clipboard
val manifest: Output<Map<String, Any>>?

The rendered manifests as JSON. Not yet supported.

Link copied to clipboard
val maxHistory: Output<Int>?

Limit the maximum number of revisions saved per release. Use 0 for no limit.

Link copied to clipboard
val name: Output<String>?

Release name.

Link copied to clipboard
val namespace: Output<String>?

Namespace to install the release into.

Link copied to clipboard
val postrender: Output<String>?

Postrender command to run.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val recreatePods: Output<Boolean>?

Perform pods restart during upgrade/rollback.

Link copied to clipboard

If set, render subchart notes along with the parent.

Link copied to clipboard
val replace: Output<Boolean>?

Re-use the given name, even if that name is already used. This is unsafe in production

Link copied to clipboard

Specification defining the Helm chart repository to use.

Link copied to clipboard
val resetValues: Output<Boolean>?

When upgrading, reset the values to the ones built into the chart.

Link copied to clipboard

Names of resources created by the release grouped by "kind/version".

Link copied to clipboard
val reuseValues: Output<Boolean>?

When upgrading, reuse the last release's values and merge in any overrides. If 'resetValues' is specified, this is ignored

Link copied to clipboard
val skipAwait: Output<Boolean>?

By default, the provider waits until all resources are in a ready state before marking the release as successful. Setting this to true will skip such await logic.

Link copied to clipboard
val skipCrds: Output<Boolean>?

If set, no CRDs will be installed. By default, CRDs are installed if not already present.

Link copied to clipboard
val status: Output<ReleaseStatus>

Status of the deployed release.

Link copied to clipboard
val timeout: Output<Int>?

Time in seconds to wait for any individual kubernetes operation.

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val values: Output<Map<String, Any>>?

Custom values set for the release.

Link copied to clipboard
val valueYamlFiles: Output<List<AssetOrArchive>>?

List of assets (raw yaml files). Content is read and merged with values (with values taking precedence).

Link copied to clipboard
val verify: Output<Boolean>?

Verify the package before installing it.

Link copied to clipboard
val version: Output<String>?

Specify the exact chart version to install. If this is not specified, the latest version is installed.

Link copied to clipboard
val waitForJobs: Output<Boolean>?

Will wait until all Jobs have been completed before marking the release as successful. This is ignored if skipAwait is enabled.