Package Information
Available Nodes
Documentation
n8n-nodes-helm-chart
This is an n8n community node that provides functionality to interact with Helm charts from both HTTP and OCI repositories. It allows you to retrieve chart metadata and default values, making it easy to integrate Helm chart information into your n8n workflows.
Created with Replit: This package was developed using Replit, a collaborative browser-based development environment.
Disclaimer
USE AT YOUR OWN RISK: This package is provided as-is without any warranties or guarantees. The author(s) are not responsible for any consequences, damages, or losses that may result from using this software in production environments. Always thoroughly test in a controlled environment before deploying to production systems.
Features
- Retrieve Helm chart metadata (Chart.yaml) from HTTP or OCI repositories
- Retrieve Helm chart default values (values.yaml) from HTTP or OCI repositories
- Support for both HTTP and OCI repository types
- Authentication for private repositories
- Automatic version detection with fallback to latest
Prerequisites
- n8n version 0.125.0 or later
- Kubernetes knowledge (for understanding Helm charts)
Installation
Local Installation (Self-hosted n8n)
- Go to your n8n installation directory
- Install the package:
npm install n8n-nodes-helm-chart
- Restart n8n
Using n8n-nodes-base.config.js (Self-hosted n8n)
- In your n8n installation directory, create a file named
n8n-nodes-base.config.js
:
module.exports = {
nodes: [
'n8n-nodes-helm-chart'
],
};
- Install the package:
npm install n8n-nodes-helm-chart
- Restart n8n
Docker Installation
If you're using Docker, create a custom Dockerfile:
FROM n8nio/n8n
# Install your custom node
RUN npm install n8n-nodes-helm-chart
Then build and run your custom Docker image:
docker build -t custom-n8n .
docker run -it --rm -p 5678:5678 custom-n8n
n8n.io (Cloud Hosted)
For n8n.io cloud-hosted instances, you can install this community node from the Community Nodes menu in the settings.
Usage
After installing the node, you can use it in your n8n workflows:
- Add a new node and search for "Helm Chart"
- Select either "Get Chart Metadata" or "Get Default Values" operation
- Configure the repository URL, chart name, and optional version
- For private repositories, enable authentication and provide credentials
Repository URL Format
HTTP repositories: Must start with
http://
orhttps://
- Example:
https://charts.helm.sh/stable
- Example:
OCI repositories: Must start with
oci://
or have no scheme- Example:
oci://registry.example.com/charts
orregistry.example.com/charts
- Example:
Authentication
For private repositories, you can set up authentication credentials:
- Go to the Credentials section in n8n
- Create a new "Helm Repository Credentials" entry
- For HTTP repositories, fill in the username and password
- For OCI repositories, fill in the registry username and registry password
Example Workflows
Get Default Values for a Chart
- Add the Helm Chart node
- Select "Get Default Values" operation
- Specify repository URL:
https://charts.helm.sh/stable
- Specify chart name:
mysql
- Leave version blank to get the latest version
Get Chart Metadata
- Add the Helm Chart node
- Select "Get Chart Metadata" operation
- Specify repository URL:
oci://registry.example.com/charts
- Specify chart name:
my-chart
- Optional: Specify version if you want a specific version
License
This project is licensed under the MIT License.
Dependencies and their Licenses
- n8n-core: MIT License
- n8n-workflow: MIT License
- axios: MIT License
- js-yaml: MIT License
- oci-registry-js: MIT License
- tar: ISC License
Support
If you have any questions or issues, please open an issue on the GitHub repository.
Contributing
Contributions are welcome! Feel free to submit a pull request with new features, improvements, or bug fixes.
Acknowledgements
- This node was created to simplify the integration of Helm chart information into n8n workflows
- Inspired by the need to automate tasks related to Kubernetes and Helm in DevOps pipelines
Legal
This package is not officially associated with or endorsed by n8n, Helm, or any of the repositories it may connect to. All product names, logos, and brands are property of their respective owners.
The author(s) of this package assume no liability for any issues that may arise from its use. By using this package, you agree to the terms of the MIT License and acknowledge that you are using it at your own risk.