Skip to content

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

ChartApplicationDescription
charts/backup-utils-Easy backup tools deployment.
charts/cnpg-clusterCNPGEasy CNPG cluster deployment.
charts/dashyDashyA self-hostable personal dashboard.
charts/homarrHomarrA self-hostable personal dashboard.

Usage

CLI

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

ArgoCD

yaml
[...]
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 :

    sh
    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 :

    sh
    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.