Helm

@hashicorp

The Helm plugin deploys to Kubernetes from a Helm chart. The Helm chart can be a local path or a chart in a repository.

Official
Built-in

Updated 9 months ago

GitHub
(opens in new tab)

Helm Platform

Deploy to Kubernetes from a Helm chart. The Helm chart can be a local path or a chart in a repository.

Entrypoint Functionality

Waypoint entrypoint functionality such as logs, exec, app configuration, and more require two properties to be true:

The running image must already have the Waypoint entrypoint installed and configured as the entrypoint. This should happen in the build stage.
Proper environment variables must be set so the entrypoint knows how to communicate to the Waypoint server. This step happens in this deployment stage.

Step 2 does not happen automatically. You must manually set the entrypoint environment variables using the templating feature. These must be passed in using Helm values (i.e. the chart must make environment variables configurable).

This is documented in more detail with a full example in the Kubernetes Helm Deployment documentation.

URL Service

If you want your workload to be accessible by the Waypoint URL service, you must set the PORT environment variable within the pod with your web service and also be using the Waypoint entrypoint (documented in the previous section).

The PORT environment variable should be the port that your web service is listening on that the URL service will connect to. See one of the examples below for more details.

Interface

Input: None
Output: k8s_helm.Deployment

Examples

// Configuring an image to match the build. This assumes the chart
// has a value named "deployment.image".
deploy {
  use "helm" {
    chart = "${path.app}/chart"

    set {
      name  = "deployment.image"
      value = artifact.name
    }
  }
}

Parameters

Required only

13 Results

chartRequiredstring
The name or path of the chart to install. If you're installing a local chart, this is the path to the chart. If you're installing a chart from a repository (have the repository configuration set), then this is the name of the chart in the repository.
contextOptionalstring
The kubectl context to use, as defined in the kubeconfig file.
create_namespaceOptionalbool
Create Namespace if it doesn't exist. This option will instruct Helm to create a namespace if it doesn't exist.
develOptionalbool
True to considered non-released chart versions for installation. This is equivalent to the --devel flag to helm install.
driverOptionalstring
The Helm storage driver to use. This can be one of configmap, secret, memory, or sql. The SQL connection string can not be set currently so this must be set on the runners.
kubeconfigOptionalstring
Path to the kubeconfig file to use. If this isn't set, the default lookup used by kubectl will be used.
nameRequiredstring
Name of the Helm release. This must be globally unique within the context of your Helm installation.
namespaceOptionalstring
Namespace to deploy the Helm chart. This will be created if it does not exist (see create_namespace). This defaults to the current namespace of the auth settings.
repositoryOptionalstring
URL of the Helm repository that contains the chart. This only needs to be set if you're NOT using a local chart.
setRequiredlist of struct { Name string "hcl:\"name,attr\""; Value string "hcl:\"value,attr\""; Type string "hcl:\"type,optional\"" }
A single value to set. This can be repeated multiple times. This sets a single value. Separate nested values with a .. This is the same as the --set flag on helm install.
skip_crdsOptionalbool
Do not create CRDs This option will tell Helm to skip the creation of CRDs.
valuesOptionallist of string
Values in raw YAML to configure the Helm chart. These values are usually loaded from files using HCL functions such as file or templating with templatefile. Multiple values will be merged using the same logic as the -f flag with Helm.
versionOptionalstring
The version of the chart to install.

Outputs

1 Result

releasestring