Helm charts ⚓

This repository hosts a set of personal Helm Charts and exposes a Helm Repository at https://this-is-tobi.github.io/helm-charts thanks to Github Pages and the Github Action chart releaser.

TIP

See charts details here.

Chart list

Chart	Application	Description
charts/dashy	dashy	A self-hostable personal dashboard.
charts/homarr	homarr	A self-hostable personal dashboard.

Usage

CLI

helm repo add tobi https://this-is-tobi.github.io/helm-charts
helm search repo tobi
helm install <release_name> tobi/<chart_name>

ArgoCD

[...]
sources:
- repoURL: https://this-is-tobi.github.io/helm-charts
  chart: <chart_name>
  targetRevision: <version> # 1.0.*
  helm:
    releaseName: <release_name>
    parameters: []
    values: ""

Template

A template folder is available for easy integration of new chart, to use it follow the steps bellow :

1. Copy the template directory :

   cp -R ./template ./charts/<chart_name>

2. Update ./charts/<chart_name>/Chart.yaml and ./charts/<chart_name>/values.yaml files.

3. Optionally add other services :

   cp -R ./charts/<chart_name>/templates/server ./charts/<chart_name>/templates/<service_name>
   find ./charts/<chart_name>/templates/<service_name> -type f -exec perl -pi -e 's/"server"/"<service_name>"/g' {} \;

   Next, add the appropriate block to the ./charts/<chart_name>/values.yaml file.

Contributions

• Each PR is associated with a pipeline that checks the lint + helm-docs.
• When a merge is performed on the main branch, the release pipeline publishes the new version of the chart(s) affected and updates the Helm Repo (gh-pages branch).

TIP

The version in the Chart.yaml file must be modified before the merge to main, otherwise the release pipeline will error on version duplication.

Sources

Take a look at the project sources.

If you'd like to improve or fix the code, check out the contribution guidelines.