Create Helm chart for Keeptrack (#50)

* Update cow-demo

* Add keeptrack chart

* Validate chart

* Update todoblazor app

* Use secrets for firebase config

* Add missing element in values

* Fix typo

Author: devpro

.gitignore

@@ -1,4 +1,4 @@
-# local downloaded chart compressed files
+# local downloaded chart compressed files
 /**/charts/*.tgz
 
 # local temporary files
@@ -8,6 +8,10 @@ temp.sh
 values_*.y*ml
 values.mine.y*ml
 
+# secret files
+kubeconfig
+firebase-service-account.json
+
 # NPM packages
 node_modules/
 

charts/cow-demo/Chart.yaml

@@ -1,8 +1,8 @@
-apiVersion: v2
+apiVersion: v2
 name: cow-demo
 description: Helm chart for Cow Demo Application
 type: application
-version: 0.2.2
+version: 0.2.3
 appVersion: "2.0.0"
 maintainers:
   - name: devpro

charts/cow-demo/values.yaml

@@ -1,6 +1,7 @@
-name: cow-demo
+name: cow-demo
 image: devprofr/cow-demo
-tag: 1.0.8830193847
+# images are hosted on DockerHub: https://hub.docker.com/r/devprofr/cow-demo/tags
+tag: 1.0.23271988100
 replicaCount: 2
 port: 80
 ingress:

charts/keeptrack/.helmignore

@@ -0,0 +1,23 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*.orig
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/

charts/keeptrack/CONTRIBUTING.md

@@ -0,0 +1,115 @@
+# Contribution guide
+
+## Update chart dependencies
+
+1. Add Bitnami chart repository:
+
+    ```bash
+    helm repo add bitnami https://charts.bitnami.com/bitnami
+    helm repo update
+    ```
+
+2. Search for the latest version:
+
+    ```bash
+    helm search repo -l bitnami/mongodb --versions
+    ```
+
+3. Edit manually `Chart.yaml` with the new version
+
+4. Update `Chart.lock`:
+
+    ```bash
+    helm dependency update
+    ```
+
+## Validate on a test cluster
+
+Create the namespace and secrets:
+
+```bash
+kubectl create ns demo
+kubectl create secret generic keeptrack-mongodb \
+  --from-literal=mongodb-root-password='admin' \
+  --namespace demo
+kubectl create secret generic keeptrack-app \
+  --from-literal=connectionstring='mongodb://root:admin@keeptrack-mongodb:27017/keeptrack?authSource=admin' \
+  --from-literal=firebaseapikey='***' \
+  --from-literal=firebaseauthdomain='***' \
+  --from-literal=firebaseprojectid='***' \
+  --from-literal=firebaseauthority='***' \
+  --from-file=firebaseserviceaccount=./firebase-service-account.json \
+  --namespace demo
+```
+
+Create a `values.mine.yaml` file:
+
+```yaml
+blazorapp:
+  host: keeptrack.console.$SANDBOX_ID.instruqt.io
+
+webapi:
+  db:
+    connectionStringSecretKeyRef:
+      name: keeptrack-app
+      key: connectionstring
+
+firebase:
+  auth:
+    authoritySecretKeyRef:
+      name: keeptrack-app
+      key: firebaseauthority
+  webApp:
+    apiKeySecretKeyRef:
+      name: keeptrack-app
+      key: firebaseapikey
+    authDomainSecretKeyRef:
+      name: keeptrack-app
+      key: firebaseauthdomain
+    projectIdSecretKeyRef:
+      name: keeptrack-app
+      key: firebaseprojectid
+  serviceAccountSecretKeyRef:
+    name: keeptrack-app
+    key: firebaseserviceaccount
+
+ingress:
+  enabled: true
+  className: traefik
+  annotations:
+    cert-manager.io/cluster-issuer: letsencrypt-prod
+
+mongodb:
+  enabled: true
+  auth:
+    existingSecret: keeptrack-mongodb
+```
+
+Review the manifest:
+
+```bash
+helm template keeptrack . -f values.yaml -f values.mine.yaml --namespace demo --debug > temp.yaml
+```
+
+Install or update the application:
+
+```bash
+helm upgrade --install keeptrack . -f values.yaml -f values.mine.yaml --namespace demo --create-namespace
+```
+
+Check everything is ok:
+
+```bash
+kubectl get all -n demo
+```
+
+Add `keeptrack.console.$SANDBOX_ID.instruqt.io` in the authorized domains in Firebase > (myproject) > Authentication > Settings.
+
+Open the web application in a browser.
+
+At the end, clean everything:
+
+```bash
+helm delete keeptrack -n demo
+kubectl delete ns demo
+```

charts/keeptrack/Chart.lock

@@ -0,0 +1,6 @@
+dependencies:
+- name: mongodb
+  repository: https://charts.bitnami.com/bitnami
+  version: 18.6.16
+digest: sha256:889cbf07e49e630d28dc8a1c72fdd0465f3f0f0c1601b3be559940108bb50ab2
+generated: "2026-03-19T17:02:27.786367209+01:00"

charts/keeptrack/Chart.yaml

@@ -0,0 +1,15 @@
+apiVersion: v2
+name: keeptrack
+description: Helm chart for Keeptrack
+type: application
+version: 0.1.0
+appVersion: "1.1.18203306613"
+dependencies:
+  - name: mongodb
+    version: 18.6.16   # MongoDB 8.2.6
+    repository: https://charts.bitnami.com/bitnami
+    alias: mongodb
+    condition: mongodb.enabled
+maintainers:
+  - name: devpro
+    email: bertrand@devpro.fr

charts/keeptrack/README.md

@@ -0,0 +1,35 @@
+# Helm chart for Devpro Keeptrack
+
+This is the official Helm chart to install [Keeptrack](https://github.com/devpro/keeptrack) on a Kubernetes cluster.
+
+## Getting started
+
+Start with the [documentation](https://kwt.devpro.fr/custom-charts/keeptrack.html).
+
+## Usage
+
+Add [Helm](https://helm.sh) repository:
+
+```bash
+helm repo add devpro https://devpro.github.io/helm-charts
+helm repo update
+```
+
+Create the `values.yaml` file to override [default values](values.yaml).
+
+Install the application:
+
+```bash
+helm upgrade --install keeptrack devpro/keeptrack -f values.yaml --create-namespace --namespace keeptrack
+```
+
+Uninstall the chart and clean-up the cluster:
+
+```bash
+helm delete keeptrack
+kubectl delete ns keeptrack
+```
+
+## Development
+
+Look at the [Contributing guide](CONTRIBUTING.md).