Module helm/v2

APIs

APIs

class Chart

class Chart extends CollectionComponentResource

Chart is a component representing a collection of resources described by an arbitrary Helm Chart. The Chart can be fetched from any source that is accessible to the helm command line. Values in the values.yml file can be overridden using ChartOpts.values (equivalent to --set or having multiple values.yml files). Objects can be transformed arbitrarily by supplying callbacks to ChartOpts.transformations.

Chart does not use Tiller. The Chart specified is copied and expanded locally; the semantics are equivalent to running helm template and then using Pulumi to manage the resulting YAML manifests. Any values that would be retrieved in-cluster are assigned fake values, and none of Tiller’s server-side validity testing is executed.

constructor

new Chart(releaseName: string, config: ChartOpts | LocalChartOpts, opts?: pulumi.ComponentResourceOptions)

Create an instance of the specified Helm chart.

  • releaseName Name of the Chart (e.g., nginx-ingress).
  • config Configuration options for the Chart.
  • opts A bag of options that control this resource's behavior.

method getCustomResource

public getCustomResource<T>(groupVersionKind: string, namespace: string): pulumi.Output<T>

getCustomResource returns a resource defined by a CRD with the given group/version/kind and name.

For example: getCustomResource(“monitoring.coreos.com/v1/ServiceMonitor”, “kube-prometheus-exporter-kubernetes”)

public getCustomResource<T>(groupVersionKind: string, namespace: string, name: string): pulumi.Output<T>

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method getResource

public getResource(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfiguration", name: string): pulumi.Output<k8s.admissionregistration.v1beta1.MutatingWebhookConfiguration>

getResource returns a resource defined by a built-in Kubernetes group/version/kind and name.

For example: getResource(“apps/v1/Deployment”, “nginx”)

public getResource(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfiguration", namespace: string, name: string): pulumi.Output<k8s.admissionregistration.v1beta1.MutatingWebhookConfiguration>
public getResource(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfigurationList", name: string): pulumi.Output<k8s.admissionregistration.v1beta1.MutatingWebhookConfigurationList>
public getResource(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfigurationList", namespace: string, name: string): pulumi.Output<k8s.admissionregistration.v1beta1.MutatingWebhookConfigurationList>
public getResource(groupVersionKind: "admissionregistration.k8s.io/v1beta1/ValidatingWebhookConfiguration", name: string): pulumi.Output<k8s.admissionregistration.v1beta1.ValidatingWebhookConfiguration>
public getResource(groupVersionKind: "admissionregistration.k8s.io/v1beta1/ValidatingWebhookConfiguration", namespace: string, name: string): pulumi.Output<k8s.admissionregistration.v1beta1.ValidatingWebhookConfiguration>
public getResource(groupVersionKind: "admissionregistration.k8s.io/v1beta1/ValidatingWebhookConfigurationList", name: string): pulumi.Output<k8s.admissionregistration.v1beta1.ValidatingWebhookConfigurationList>
public getResource(groupVersionKind: "admissionregistration.k8s.io/v1beta1/ValidatingWebhookConfigurationList", namespace: string, name: string): pulumi.Output<k8s.admissionregistration.v1beta1.ValidatingWebhookConfigurationList>
public getResource(groupVersionKind: "apiextensions.k8s.io/v1beta1/CustomResourceDefinition", name: string): pulumi.Output<k8s.apiextensions.v1beta1.CustomResourceDefinition>
public getResource(groupVersionKind: "apiextensions.k8s.io/v1beta1/CustomResourceDefinition", namespace: string, name: string): pulumi.Output<k8s.apiextensions.v1beta1.CustomResourceDefinition>
public getResource(groupVersionKind: "apiextensions.k8s.io/v1beta1/CustomResourceDefinitionList", name: string): pulumi.Output<k8s.apiextensions.v1beta1.CustomResourceDefinitionList>
public getResource(groupVersionKind: "apiextensions.k8s.io/v1beta1/CustomResourceDefinitionList", namespace: string, name: string): pulumi.Output<k8s.apiextensions.v1beta1.CustomResourceDefinitionList>
public getResource(groupVersionKind: "apiregistration.k8s.io/v1/APIService", name: string): pulumi.Output<k8s.apiregistration.v1.APIService>
public getResource(groupVersionKind: "apiregistration.k8s.io/v1/APIService", namespace: string, name: string): pulumi.Output<k8s.apiregistration.v1.APIService>
public getResource(groupVersionKind: "apiregistration/v1/APIService", name: string): pulumi.Output<k8s.apiregistration.v1.APIService>
public getResource(groupVersionKind: "apiregistration/v1/APIService", namespace: string, name: string): pulumi.Output<k8s.apiregistration.v1.APIService>
public getResource(groupVersionKind: "apiregistration.k8s.io/v1/APIServiceList", name: string): pulumi.Output<k8s.apiregistration.v1.APIServiceList>
public getResource(groupVersionKind: "apiregistration.k8s.io/v1/APIServiceList", namespace: string, name: string): pulumi.Output<k8s.apiregistration.v1.APIServiceList>
public getResource(groupVersionKind: "apiregistration/v1/APIServiceList", name: string): pulumi.Output<k8s.apiregistration.v1.APIServiceList>
public getResource(groupVersionKind: "apiregistration/v1/APIServiceList", namespace: string, name: string): pulumi.Output<k8s.apiregistration.v1.APIServiceList>
+ 332 additional overloads

method getResourceProperty

public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfiguration", name: string, property: "api_version"): pulumi.Output<"admissionregistration.k8s.io/v1beta1">

getResourceProperty returns a single property of a resource defined by a built-in Kubernetes group/version/kind and name.

For example: getResourceProperty(“v1/Service”, “nginx”, “spec”)

public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfiguration", namespace: string, name: string, property: "api_version"): pulumi.Output<"admissionregistration.k8s.io/v1beta1">
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfiguration", name: string, property: "kind"): pulumi.Output<"MutatingWebhookConfiguration">
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfiguration", namespace: string, name: string, property: "kind"): pulumi.Output<"MutatingWebhookConfiguration">
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfiguration", name: string, property: "metadata"): pulumi.Output<outputs.meta.v1.ObjectMeta>
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfiguration", namespace: string, name: string, property: "metadata"): pulumi.Output<outputs.meta.v1.ObjectMeta>
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfiguration", name: string, property: "webhooks"): pulumi.Output<outputs.admissionregistration.v1beta1.MutatingWebhook[]>
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfiguration", namespace: string, name: string, property: "webhooks"): pulumi.Output<outputs.admissionregistration.v1beta1.MutatingWebhook[]>
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfigurationList", name: string, property: "api_version"): pulumi.Output<"admissionregistration.k8s.io/v1beta1">
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfigurationList", namespace: string, name: string, property: "api_version"): pulumi.Output<"admissionregistration.k8s.io/v1beta1">
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfigurationList", name: string, property: "items"): pulumi.Output<outputs.admissionregistration.v1beta1.MutatingWebhookConfiguration[]>
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfigurationList", namespace: string, name: string, property: "items"): pulumi.Output<outputs.admissionregistration.v1beta1.MutatingWebhookConfiguration[]>
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfigurationList", name: string, property: "kind"): pulumi.Output<"MutatingWebhookConfigurationList">
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfigurationList", namespace: string, name: string, property: "kind"): pulumi.Output<"MutatingWebhookConfigurationList">
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfigurationList", name: string, property: "metadata"): pulumi.Output<outputs.meta.v1.ListMeta>
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/MutatingWebhookConfigurationList", namespace: string, name: string, property: "metadata"): pulumi.Output<outputs.meta.v1.ListMeta>
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/ValidatingWebhookConfiguration", name: string, property: "api_version"): pulumi.Output<"admissionregistration.k8s.io/v1beta1">
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/ValidatingWebhookConfiguration", namespace: string, name: string, property: "api_version"): pulumi.Output<"admissionregistration.k8s.io/v1beta1">
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/ValidatingWebhookConfiguration", name: string, property: "kind"): pulumi.Output<"ValidatingWebhookConfiguration">
public getResourceProperty(groupVersionKind: "admissionregistration.k8s.io/v1beta1/ValidatingWebhookConfiguration", namespace: string, name: string, property: "kind"): pulumi.Output<"ValidatingWebhookConfiguration">
+ 1622 additional overloads

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

method parseTemplate

parseTemplate(yamlStream: string, transformations: (o: any, opts: pulumi.CustomResourceOptions) => void[] | undefined, resourcePrefix: string | undefined, dependsOn: pulumi.Resource[]): pulumi.Output<{[key: string]: pulumi.CustomResource}>

method registerOutputs

protected registerOutputs(outputs?: Inputs | Promise<Inputs> | Output<Inputs>): void

property resources

resources: pulumi.Output<{[key: string]: pulumi.CustomResource}>;

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

interface ChartOpts

interface ChartOpts extends BaseChartOpts

property chart

chart: pulumi.Input<string>;

The chart to deploy. If [repo] is provided, this chart name is looked up in the given repository. Else this chart name must be a fully qualified chart URL or repo/chartname.

property fetchOpts

fetchOpts?: pulumi.Input<FetchOpts>;

Additional options to customize the fetching of the Helm chart.

property namespace

namespace?: pulumi.Input<string>;

The optional namespace to install chart resources into.

property repo

repo?: pulumi.Input<string>;

The repository containing the desired chart. If not provided, [chart] must be a fully qualified chart URL or repo/chartname.

property resourcePrefix

resourcePrefix?: undefined | string;

An optional prefix for the auto-generated resource names. Example: A resource created with resourcePrefix=“foo” would produce a resource named “foo-resourceName”.

property transformations

transformations?: (o: any, opts: pulumi.CustomResourceOptions) => void[];

Optional array of transformations to apply to resources that will be created by this chart prior to creation. Allows customization of the chart behaviour without directly modifying the chart itself.

property values

values?: pulumi.Inputs;

Overrides for chart values.

property version

version?: pulumi.Input<string>;

The version of the chart to deploy. If not provided, the latest version will be deployed.

function fetch

fetch(chart: string, opts?: ResolvedFetchOpts): void

Retrieve a package from a package repository, and download it locally.

This is useful for fetching packages to inspect, modify, or repackage. It can also be used to perform cryptographic verification of a chart without installing the chart.

There are options for unpacking the chart after download. This will create a directory for the chart and uncompress into that directory.

If the verify option is specified, the requested chart MUST have a provenance file, and MUST pass the verification process. Failure in any part of this will result in an error, and the chart will not be saved locally.

interface FetchOpts

interface FetchOpts

Additional options to customize the fetching of the Helm chart.

property caFile

caFile?: pulumi.Input<string>;

Verify certificates of HTTPS-enabled servers using this CA bundle.

property certFile

certFile?: pulumi.Input<string>;

Identify HTTPS client using this SSL certificate file.

property destination

destination?: pulumi.Input<string>;

Location to write the chart. If this and tardir are specified, tardir is appended to this (default “.”).

property devel

devel?: pulumi.Input<boolean>;

Use development versions, too. Equivalent to version ‘>0.0.0-0’. If –version is set, this is ignored.

property home

home?: pulumi.Input<string>;

Location of your Helm config. Overrides $HELM_HOME (default “/Users/alex/.helm”).

property keyFile

keyFile?: pulumi.Input<string>;

Identify HTTPS client using this SSL key file.

property keyring

keyring?: pulumi.Input<string>;

Keyring containing public keys (default “/Users/alex/.gnupg/pubring.gpg”).

property password

password?: pulumi.Input<string>;

Chart repository password.

property prov

prov?: pulumi.Input<boolean>;

Fetch the provenance file, but don’t perform verification.

property repo

repo?: pulumi.Input<string>;

Chart repository url where to locate the requested chart.

property untar

untar?: pulumi.Input<boolean>;

If set to false, will leave the chart as a tarball after downloading.

property untardir

untardir?: pulumi.Input<string>;

If untar is specified, this flag specifies the name of the directory into which the chart is expanded (default “.”).

property username

username?: pulumi.Input<string>;

Chart repository username.

property verify

verify?: pulumi.Input<boolean>;

Verify the package against its signature.

property version

version?: pulumi.Input<string>;

Specific version of a chart. Without this, the latest version is fetched.

interface LocalChartOpts

interface LocalChartOpts extends BaseChartOpts

property namespace

namespace?: pulumi.Input<string>;

The optional namespace to install chart resources into.

property path

path: string;

The path to the chart directory which contains the Chart.yaml file.

property resourcePrefix

resourcePrefix?: undefined | string;

An optional prefix for the auto-generated resource names. Example: A resource created with resourcePrefix=“foo” would produce a resource named “foo-resourceName”.

property transformations

transformations?: (o: any, opts: pulumi.CustomResourceOptions) => void[];

Optional array of transformations to apply to resources that will be created by this chart prior to creation. Allows customization of the chart behaviour without directly modifying the chart itself.

property values

values?: pulumi.Inputs;

Overrides for chart values.