Helm
Last updated
Was this helpful?
Last updated
Was this helpful?
There is no native support within Spacelift for Helm, but you can use the command in a before plan hook to generate the Kubernetes resource definitions to deploy.
Please note, the following caveats apply:
Using helm template means that you are not using the full Helm workflow, which may cause limitations or prevent certain Charts from working.
You need to use a custom that has Helm installed, or alternatively you can install Helm using a before init hook.
The rest of this page will go through an example of deploying the using the Kubernetes integration. See for an example repository.
The following prerequisites are required to follow the rest of this guide:
A Kubernetes cluster that you can authenticate to from a Spacelift stack.
A namespace called spacelift-worker that exists within that cluster.
Start by creating a new repository for your Helm stack. This repository only needs to contain a single item - a kustomization.yaml file:
The kustomization file is used to tell kubectl where to find the file containing the output of the helm template command, and prevents kubectl from attempting to apply every yaml file in your repository. This is important if you want to commit a values.yaml file to your repository.
Also, make sure to specify your custom Runner image that has Helm installed if you are not installing Helm using a before init hook.
Once you've completed both steps, you should see something like this:
Once you have successfully created your Stack, add values for the following environment variables to your Stack environment:
SPACELIFT_WORKER_REPLICAS - the number of worker pool replicas to create.
SPACELIFT_WORKER_POOL_TOKEN - the token downloaded when creating your worker pool.
SPACELIFT_WORKER_POOL_PRIVATE_KEY - your base64-encoded private key.
Your Stack environment should look something like this:
This example assumes that a Kubernetes namespace called spacelift-worker already exists. If it doesn't, create it using kubectl create namespace spacelift-worker before triggering a run.
Triggering runs works exactly the same as when not using Helm. Once the planning stage has completed, you should see a preview of your changes, showing the Chart resources that will be created:
After approving the run, you should see the changes applying, along with a successful rollout of your Chart resources:
Follow the same steps to create your stack as per the guide, but when you get to the Define Behavior step, add the following commands as before plan hooks:
Configure any required Cloud Provider integrations as per the guide.
You can use a to run the kubectl create namespace command.
