50d1f93e12
Co-authored-by: Troy Prelog <tprelog@users.noreply.github.com> Signed-off-by: Kjeld Schouten-Lebbing <kjeld@schouten-lebbing.nl> |
||
---|---|---|
.. | ||
templates | ||
.helmignore | ||
CHANGELOG.md | ||
Chart.yaml | ||
LICENSE | ||
README.md | ||
_ingress.tpl | ||
values.yaml |
README.md
Library chart for k8s@home media charts
WARNING: THIS CHART IS NOT MEANT TO BE INSTALLED DIRECTLY
This is a Helm Library Chart. It's purpose is for grouping common logic between the k8s@home charts.
Since a lot of charts follow the same pattern this library was built to reduce maintenance cost between the charts that use it and try achieve a goal of being DRY.
Introduction
This chart provides common template helpers which can be used to develop new charts using Helm package manager.
🌟 Changelog
Please refer to CHANGELOG.md for an overview of notable changes to the chart. This is especially important for major version updates!
TL;DR
When using one of the many charts that uses this library be sure to view this values.yaml for configuration options. Any setting here can be used to define what values your helm deployment will use.
For example using the helm CLI tool
helm install node-red \
--set image.repository="nodered/node-red" \
--set image.tag="1.2.5" \
--set env.TZ="America/New_York" \
k8s-at-home/node-red
or
# node-red-values.yaml
image:
repository: nodered/node-red
tag: 1.2.5
env:
TZ: America/New_York
helm install node-red \
--values=./node-red-values.yaml \
k8s-at-home/node-red
Creating a new chart
First be sure to checkout the many charts that already use this like qBittorrent, node-red or the many others in this repository.
Include this chart as a dependency in your Chart.yaml
e.g.
# Chart.yaml
dependencies:
- name: common
version: x.x.x
repository: https://k8s-at-home.com/charts/
Write a values.yaml
with some basic defaults you want to present to the user e.g.
# Default values for node-red.
image:
repository: nodered/node-red
pullPolicy: IfNotPresent
tag: 1.2.5
strategy:
type: Recreate
# See more environment varaibles in the node-red documentation
# https://nodered.org/docs/getting-started/docker
env: {}
# TZ:
# NODE_OPTIONS:
# NODE_RED_ENABLE_PROJECTS:
# NODE_RED_ENABLE_SAFE_MODE:
# FLOWS:
service:
port:
port: 1880
persistence:
data:
enabled: false
emptyDir: false
mountPath: /data
If testing locally make sure you update the dependencies with:
helm dependency update