Helm integration by landon-metzger · Pull Request #35 · TheGreenMachine/GreenScout-Backend

landon-metzger · 2026-03-19T13:17:22Z

i added documentation going over the infrastructure and also deploying your own helm chart

Charts/ - Helm charts
docks/SelfHosting.md -How To Self Host
.github/actions/helm-relese.yaml - create a public helm repo

add start of a helm char add helm chart for backend app

landon-metzger · 2026-03-19T13:32:38Z

fix the versioning of checkout action to v6

jarrpa · 2026-03-19T14:35:12Z

docs/SelfHosting.md

@@ -0,0 +1,11 @@
+# Kuberneties Basicks


Suggested change

# Kuberneties Basicks

# Kubernetes Basics

jarrpa · 2026-03-19T14:41:21Z

docs/SelfHosting.md

@@ -0,0 +1,11 @@
+# Kuberneties Basicks
+Kuberneties is a platform that is desinged to be scalable so it is a little difrent then your run of a mill docker stack. the main difrance is the way kuberneties handles work loads. In a kuberneties cluster you should have both A Controll Plane, and (a or many) Worker Nodes. The controll plane is what handles the dispatching of the work and the worker nodes dose all the work.


Suggested change

Kuberneties is a platform that is desinged to be scalable so it is a little difrent then your run of a mill docker stack. the main difrance is the way kuberneties handles work loads. In a kuberneties cluster you should have both A Controll Plane, and (a or many) Worker Nodes. The controll plane is what handles the dispatching of the work and the worker nodes dose all the work.

Kubernetes (k8s) is a platform that is designed to be scalable so it is a little diffrent than your run of the mill docker stack. The main difference is the way k8s handles workloads. A k8s cluster has a set of nodes that comprise the "control plane", which handles the placement or "scheduling" of a workload, and one or more "worker" nodes that actually run the workloads.

jarrpa · 2026-03-19T14:41:52Z

docs/SelfHosting.md

@@ -0,0 +1,11 @@
+# Kuberneties Basicks
+Kuberneties is a platform that is desinged to be scalable so it is a little difrent then your run of a mill docker stack. the main difrance is the way kuberneties handles work loads. In a kuberneties cluster you should have both A Controll Plane, and (a or many) Worker Nodes. The controll plane is what handles the dispatching of the work and the worker nodes dose all the work.
+# machine infraestructure


Suggested change

# machine infraestructure

# Example Infrastructure

jarrpa · 2026-03-19T14:47:25Z

docs/SelfHosting.md

+# Kuberneties Basicks
+Kuberneties is a platform that is desinged to be scalable so it is a little difrent then your run of a mill docker stack. the main difrance is the way kuberneties handles work loads. In a kuberneties cluster you should have both A Controll Plane, and (a or many) Worker Nodes. The controll plane is what handles the dispatching of the work and the worker nodes dose all the work.
+# machine infraestructure
+I (Landon) virtualise all of my kuberneties nodes, at the time i was deploying this app i had only two worker nodes and one controll plane do whatever you plese just keep in mind the more machines u have the better u can push out more replicas for smother sailing. Now when setting up our vm inferstructure i recomend using IAC(infrastructure as code) i have my homelabs infrastructure published down below to use as an example.


Suggested change

I (Landon) virtualise all of my kuberneties nodes, at the time i was deploying this app i had only two worker nodes and one controll plane do whatever you plese just keep in mind the more machines u have the better u can push out more replicas for smother sailing. Now when setting up our vm inferstructure i recomend using IAC(infrastructure as code) i have my homelabs infrastructure published down below to use as an example.

I (Landon) run all of my k8s nodes as VMs. At the time I was deploying this app I had only two worker nodes and one control plane node. Do whatever you please just keep in mind having more nodes increases the resiliency of your services. When setting up our VM infrastructure I recommend using [IAC (infrastructure as code)](https://en.wikipedia.org/wiki/Infrastructure_as_code) tools to manage them. I have my home lab's infrastructure published down below to use as an example.

jarrpa · 2026-03-19T14:47:48Z

docs/SelfHosting.md

+I (Landon) virtualise all of my kuberneties nodes, at the time i was deploying this app i had only two worker nodes and one controll plane do whatever you plese just keep in mind the more machines u have the better u can push out more replicas for smother sailing. Now when setting up our vm inferstructure i recomend using IAC(infrastructure as code) i have my homelabs infrastructure published down below to use as an example.
+[Skoxie-iac Repo](https://codeberg.org/Woxie/skoxie-iac)
+
+# Where do i get the Images?


Suggested change

# Where do i get the Images?

# Where do I get the images?

jarrpa · 2026-03-19T14:48:46Z

docs/SelfHosting.md

+[Skoxie-iac Repo](https://codeberg.org/Woxie/skoxie-iac)
+
+# Where do i get the Images?
+U(points at u) future me.. will have to push a docker image to docker hub or your own docker registry and then use that with a helm chart. I use Artifact hub to publish my completed charts so that i can pull them into my argo cd infrastructure


Suggested change

U(points at u) future me.. will have to push a docker image to docker hub or your own docker registry and then use that with a helm chart. I use Artifact hub to publish my completed charts so that i can pull them into my argo cd infrastructure

U (points at you), future me... will have to push a docker image to docker hub or your own docker registry, and then use that with a helm chart. I use Artifact hub to publish my completed charts so that i can pull them into my [ArgoCD](https://argo-cd.readthedocs.io/en/stable/) infrastructure

jarrpa · 2026-03-19T14:50:01Z

docs/SelfHosting.md

+# the helm repo
+the helm chart repo is hosted on a github page evrytime you want to update the charts plese update the vershion number and push to main thanks


Suggested change

# the helm repo

the helm chart repo is hosted on a github page evrytime you want to update the charts plese update the vershion number and push to main thanks

# The Helm repo

The Helm chart repo is published using GitHub Pages. Everytime you want to update the charts please update the version number and submit a PR to main, thanks.

jarrpa · 2026-03-19T14:54:51Z

README.md

+
+To install the greenscout chart:
+
+    helm install my-<chart-name> thegreenmachine/greenscout-backend


Suggested change

helm install my-<chart-name> thegreenmachine/greenscout-backend

```

# helm install my-gs-backend thegreenmachine/greenscout-backend

```

jarrpa · 2026-03-19T14:55:49Z

README.md

+
+To uninstall the chart:
+
+    helm uninstall my-<chart-name>


Suggested change

helm uninstall my-<chart-name>

```

# helm uninstall my-gs-backend

```

jarrpa · 2026-03-19T14:56:51Z

README.md

+the latest versions of the packages.  You can then run `helm search repo
+<alias>` to see the charts.
+
+To install the greenscout chart:


Suggested change

To install the greenscout chart:

In the following examples, `my-gs-backend` can be whatever name you want, just be consistent.

To install the greenscout chart:

landon-metzger requested a review from a team March 19, 2026 13:17

landon-metzger closed this Mar 19, 2026

landon-metzger force-pushed the compose branch from a3a455f to f461c27 Compare March 19, 2026 13:26

landon-metzger added 5 commits March 19, 2026 08:31

add the start of a helm chart

2d9b2db

add start of a helm char add helm chart for backend app

add index and package chart to make repo a viable helm chart repo

6e66b5b

add index and packaged chart to push to artifact hub

deda1fa

add start of helm repo docs

7405ecb

change helm-relese to run on pr

2befbc8

landon-metzger reopened this Mar 19, 2026

landon-metzger changed the title ~~Helm intagration~~ Helm integration Mar 19, 2026

landon-metzger added 13 commits March 19, 2026 08:39

change when helm-chart action runs

d87270a

add gh action readme guide to useing the helm repo

be2e7c1

change chart vershion

6123364

add skip existing to the deployment

18e4c8d

add skip existing to the deployment

1379fad

greenscout on updated chart

9a1abf7

publish the build chart to the gh-pages branch

4b220fd

add helpers for the service accout template

b2bf2f5

re add skip existing

959117c

add greenscout.backend name helper

cce6ca9

fix nil pointer evaluating interface {}.enabled

90a8fa3

fix nil pointer evaluating interface {}.enabled

4367488

hopfilly really fix it this time we will see

a90a6f8

jarrpa requested changes Mar 19, 2026

View reviewed changes

landon-metzger added 4 commits March 19, 2026 10:26

change charts dir

9aeb62b

change charts dir

3e8537e

config secrets to manage all in vault

5c1f008

configs uses one secret not threee oops

bcc084a

landon-metzger force-pushed the compose branch from 57d3f6d to bcc084a Compare March 19, 2026 17:29

landon-metzger added 19 commits March 19, 2026 12:31

we dont have the mount path in secret name anymore

3a6c4df

add missing keys

f3d4ee1

fix bad indentation

9f65bae

chage secret name to a valid default

0388051

add args for test mode

64e6058

add databaces volume claim

a0dee12

add databaces volume claim

5471198

add nfs mounted databaces FOR NOW quick fix

5f7491e

fix args lables

fab917d

test the test

a7ebe9c

app vershion

810ffd5

databaces mount path fix

4bb6e9a

databaces mount path fix

1b85592

vershion change

78cb6bd

fix volumes pvc's pv's and mounts

8c61548

fix moutPaths for run mount

69054f0

add debuging

adfc4f8

add proper volumes

1575873

fix values template

6331bac

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Helm integration#35

Helm integration#35
landon-metzger wants to merge 41 commits intomainfrom
compose

landon-metzger commented Mar 19, 2026

Uh oh!

landon-metzger commented Mar 19, 2026

Uh oh!

jarrpa Mar 19, 2026

Uh oh!

jarrpa Mar 19, 2026

Uh oh!

jarrpa Mar 19, 2026

Uh oh!

jarrpa Mar 19, 2026

Uh oh!

jarrpa Mar 19, 2026

Uh oh!

jarrpa Mar 19, 2026

Uh oh!

jarrpa Mar 19, 2026

Uh oh!

jarrpa Mar 19, 2026

Uh oh!

jarrpa Mar 19, 2026

Uh oh!

jarrpa Mar 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		@@ -0,0 +1,11 @@
		# Kuberneties Basicks
		Kuberneties is a platform that is desinged to be scalable so it is a little difrent then your run of a mill docker stack. the main difrance is the way kuberneties handles work loads. In a kuberneties cluster you should have both A Controll Plane, and (a or many) Worker Nodes. The controll plane is what handles the dispatching of the work and the worker nodes dose all the work.

	Kuberneties is a platform that is desinged to be scalable so it is a little difrent then your run of a mill docker stack. the main difrance is the way kuberneties handles work loads. In a kuberneties cluster you should have both A Controll Plane, and (a or many) Worker Nodes. The controll plane is what handles the dispatching of the work and the worker nodes dose all the work.
	Kubernetes (k8s) is a platform that is designed to be scalable so it is a little diffrent than your run of the mill docker stack. The main difference is the way k8s handles workloads. A k8s cluster has a set of nodes that comprise the "control plane", which handles the placement or "scheduling" of a workload, and one or more "worker" nodes that actually run the workloads.

	U(points at u) future me.. will have to push a docker image to docker hub or your own docker registry and then use that with a helm chart. I use Artifact hub to publish my completed charts so that i can pull them into my argo cd infrastructure
	U (points at you), future me... will have to push a docker image to docker hub or your own docker registry, and then use that with a helm chart. I use Artifact hub to publish my completed charts so that i can pull them into my [ArgoCD](https://argo-cd.readthedocs.io/en/stable/) infrastructure

		# the helm repo
		the helm chart repo is hosted on a github page evrytime you want to update the charts plese update the vershion number and push to main thanks No newline at end of file


		To install the greenscout chart:

		helm install my-<chart-name> thegreenmachine/greenscout-backend


		To uninstall the chart:

		helm uninstall my-<chart-name> No newline at end of file

Conversation

landon-metzger commented Mar 19, 2026

Uh oh!

landon-metzger commented Mar 19, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants