feat: add notes

src/content/docs/applications/democratic-csi-synology-iscsi.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/democratic-csi-synology-iscsi
       icon: right-arrow
 ---
+
+# Purpose
+
+Storage provider for iSCSI block devices from the NAS.
+
+# Notes
+
+Used for applications that need to store a lot of data, but not over the NFS connection. Examples include metrics and logging storage.

src/content/docs/applications/descheduler.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/descheduler
       icon: right-arrow
 ---
+
+# Purpose
+
+Automated service that balances pods across the nodes according to configuration.
+
+# Notes
+
+Mostly used to balance number of pods. Current limit is set to 200 which is nearly twice the defaults, but this can sometimes be met during reboots during upgrades as pods are evicted. Then this will balance out one all nodes are healthy again.

src/content/docs/applications/directus.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/directus
       icon: right-arrow
 ---
+
+# Purpose
+
+Content Management System tightly coupled to [my personal site](https://docs.alexlebens.dev/applications/site-profile/).
+
+# Notes
+
+Most information is stored here and accessed at build time. Webhook setup so when I publish a blog post here it will initiate a new build of the image.

src/content/docs/applications/elastic-operator.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/elastic-operator
       icon: right-arrow
 ---
+
+# Purpose
+
+Operator to deploy and manage Elasticsearch instances.
+
+# Notes
+
+Easier to manage then just deploying Helm Charts. Mostly used for [TubeArchivist](https://docs.alexlebens.dev/applications/tubearchivist/).

src/content/docs/applications/element-web.mdx

@@ -17,3 +17,11 @@ hero:
 import { Aside } from '@astrojs/starlight/components';
 
 <Aside>This app has public facing endpoint, at [chat.alexlebens.dev](https://chat.alexlebens.dev)</Aside>
+
+# Purpose
+
+Front end web client for Matrix servers.
+
+# Notes
+
+Provides front end for [Matrix-Synapse](https://docs.alexlebens.dev/applications/matrix-synapse/)

src/content/docs/applications/eraser.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/eraser
       icon: right-arrow
 ---
+
+# Purpose
+
+Automatic service that cleans up local caches of images.
+
+# Notes
+
+Removes all non running images. This does cause a startup delay, but [Harbor](https://docs.alexlebens.dev/applications/harbor/) is configured as a generic pull through cache, so pulls for new images should be quick.

src/content/docs/applications/excalidraw.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/excalidraw
       icon: right-arrow
 ---
+
+# Purpose
+
+Used to make diagrams and other sketches.
+
+# Notes
+
+Mostly used in blog posts and documentation.

src/content/docs/applications/external-dns.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/external-dns
       icon: right-arrow
 ---
+
+# Purpose
+
+Makes DNS entries of Kubernetes resources into an external DNS provider.
+
+# Notes
+
+Blocky can't be configured this way, so I am exploring other options to use this automation. But it is currently setup to configure the Ubiquity devices.

src/content/docs/applications/external-secrets.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/external-secrets
       icon: right-arrow
 ---
+
+# Purpose
+
+Very useful, decalarative way to make Kubernetes Secrets from an external provider.
+
+# Notes
+
+Secrets come from [Vault](https://docs.alexlebens.dev/applications/vault/).

src/content/docs/applications/foldergram.mdx

@@ -17,3 +17,11 @@ hero:
 import { Aside } from '@astrojs/starlight/components';
 
 <Aside>This app has public facing endpoint, at [art.alexlebens.dev](https://art.alexlebens.dev)</Aside>
+
+# Purpose
+
+View pictures I have collected that are not photos I have taken myself.
+
+# Notes
+
+Setup to provide all the collections of public domain images I have. Mostly from various art museums.

src/content/docs/applications/freshrss.mdx

@@ -17,3 +17,11 @@ hero:
 import { Aside } from '@astrojs/starlight/components';
 
 <Aside>This app has public facing endpoint, at [rss.alexlebens.dev](https://rss.alexlebens.dev)</Aside>
+
+# Purpose
+
+RSS reader for various news sites as well as software releases.
+
+# Notes
+
+A little finicky to setup, predates popular use of containers, but still functions quite well. I mostly use it with an Android app.

src/content/docs/applications/garage.mdx

@@ -13,3 +13,17 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/garage
       icon: right-arrow
 ---
+
+# Purpose
+
+Clustered S3 storage provider.
+
+# Notes
+
+Considering moving to the [operator](https://github.com/rajsinghtech/garage-operator), but currently deploys as chart.
+
+Backing storage comes from [iSCSI](https://docs.alexlebens.dev/applications/democratic-csi-synology-iscsi/).
+
+Primary endpoint for most S3 targets, alongside PiBox and Digital Ocean.
+
+[Rclone](https://docs.alexlebens.dev/applications/rclone/) handles any kind of syncing to the other endpoints as needed.

src/content/docs/applications/gatus.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/gatus
       icon: right-arrow
 ---
+
+# Purpose
+
+Uptime and down notifications for all endpoints, both local and public.
+
+# Notes
+
+All declarative configuration, will end notifications using [ntfy](https://docs.alexlebens.dev/applications/ntfy/).

src/content/docs/applications/generic-device-plugin.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/generic-device-plugin
       icon: right-arrow
 ---
+
+# Purpose
+
+Plugin used to give devices to pods, specifically tun devices for networking.
+
+# Notes
+
+Used by recomendation in [Tailscale Docs](https://docs.siderolabs.com/kubernetes-guides/advanced-guides/device-plugins).

src/content/docs/applications/gitea.mdx

@@ -17,3 +17,11 @@ hero:
 import { Aside } from '@astrojs/starlight/components';
 
 <Aside>This app has public facing endpoint, at [gitea.alexlebens.dev](https://gitea.alexlebens.dev)</Aside>
+
+# Purpose
+
+Git repoistory for storing all my code. 
+
+# Notes
+
+Primary code repo, repositories set to replicate to a PiBox as well as Github for a layer of backup.

src/content/docs/applications/grafana-operator.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/grafana-operator
       icon: right-arrow
 ---
+
+# Purpose
+
+Operator to declaratively make Grafana dashboards.
+
+# Notes
+
+Uses the dashboard json in [grafana-dashboards](https://gitea.alexlebens.dev/alexlebens/grafana-dashboards].

src/content/docs/applications/grimmory.mdx

@@ -13,3 +13,13 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/grimmory
       icon: right-arrow
 ---
+
+# Purpose
+
+Store and provide books.
+
+# Notes
+
+Used to be called 'Booklore'.
+
+Only app that uses [MariaDB](https://docs.alexlebens.dev/applications/mariadb-operator/).

src/content/docs/applications/harbor.mdx

@@ -13,3 +13,13 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/harbor
       icon: right-arrow
 ---
+
+# Purpose
+
+Pull through cache and registry for personal images built in Gitea.
+
+# Notes
+
+Talos is configured to direct pulls to Docker, Github, and others to Harbor first. Stores these images as a cache to avoid rate limiting, primarily by Docker hub.
+
+Any of my own images also get stored here to deploy.

src/content/docs/applications/headlamp.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/headlamp
       icon: right-arrow
 ---
+
+# Purpose
+
+Dashboard for Kubernetes.
+
+# Notes
+
+I also use the desktop app which is identical.

src/content/docs/applications/home-assistant.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/home-assistant
       icon: right-arrow
 ---
+
+# Purpose
+
+Home automation, connecting to various IoT devices through Zigbee, Matter, etc.
+
+# Notes
+
+Currently unused.

src/content/docs/applications/homepage.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/homepage
       icon: right-arrow
 ---
+
+# Purpose
+
+Provides links and status dots for all deployed apps.
+
+# Notes
+
+Do not set to RollingUpdate or use multiple replicas. Has some kind of loading issue when doing so.

src/content/docs/applications/houndarr.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/houndarr
       icon: right-arrow
 ---
+
+# Purpose
+
+Manages automatic upgrades for content in the Servarr apps.
+
+# Notes
+
+Set and forget, runs as a service in the background.

src/content/docs/applications/immich.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/immich
       icon: right-arrow
 ---
+
+# Purpose
+
+Alternative to Google Photos, stores all my photos.
+
+# Notes
+
+Photos are stored internally, though a full copy is also kept on the NAS.

src/content/docs/applications/intel-device-plugin.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/intel-device-plugin
       icon: right-arrow
 ---
+
+# Purpose
+
+Used to give pods access to host GPUs. Primarily for video and the QuickSync feature.
+
+# Notes
+
+Just works in the background.

src/content/docs/applications/jellyfin.mdx

@@ -13,3 +13,13 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/jellyfin
       icon: right-arrow
 ---
+
+# Purpose
+
+Provides video, such as movies and shows.
+
+# Notes
+
+A little finicky and not as polished as Plex, but open source and supports plugins.
+
+Planned migration to PostgreSQL when feature is supported.