From 869ff82875c2ab9d030767e480896b29b1056f02 Mon Sep 17 00:00:00 2001 From: Alex Lebens Date: Sat, 11 Apr 2026 12:11:56 -0500 Subject: [PATCH] feat: add notes --- .../applications/democratic-csi-synology-iscsi.mdx | 8 ++++++++ src/content/docs/applications/descheduler.mdx | 8 ++++++++ src/content/docs/applications/directus.mdx | 8 ++++++++ src/content/docs/applications/elastic-operator.mdx | 8 ++++++++ src/content/docs/applications/element-web.mdx | 8 ++++++++ src/content/docs/applications/eraser.mdx | 8 ++++++++ src/content/docs/applications/excalidraw.mdx | 8 ++++++++ src/content/docs/applications/external-dns.mdx | 8 ++++++++ src/content/docs/applications/external-secrets.mdx | 8 ++++++++ src/content/docs/applications/foldergram.mdx | 8 ++++++++ src/content/docs/applications/freshrss.mdx | 8 ++++++++ src/content/docs/applications/garage.mdx | 14 ++++++++++++++ src/content/docs/applications/gatus.mdx | 8 ++++++++ .../docs/applications/generic-device-plugin.mdx | 8 ++++++++ src/content/docs/applications/gitea.mdx | 8 ++++++++ src/content/docs/applications/grafana-operator.mdx | 8 ++++++++ src/content/docs/applications/grimmory.mdx | 10 ++++++++++ src/content/docs/applications/harbor.mdx | 10 ++++++++++ src/content/docs/applications/headlamp.mdx | 8 ++++++++ src/content/docs/applications/home-assistant.mdx | 8 ++++++++ src/content/docs/applications/homepage.mdx | 8 ++++++++ src/content/docs/applications/houndarr.mdx | 8 ++++++++ src/content/docs/applications/immich.mdx | 8 ++++++++ .../docs/applications/intel-device-plugin.mdx | 8 ++++++++ src/content/docs/applications/jellyfin.mdx | 10 ++++++++++ 25 files changed, 212 insertions(+) diff --git a/src/content/docs/applications/democratic-csi-synology-iscsi.mdx b/src/content/docs/applications/democratic-csi-synology-iscsi.mdx index eef0e40..643f61e 100644 --- a/src/content/docs/applications/democratic-csi-synology-iscsi.mdx +++ b/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. diff --git a/src/content/docs/applications/descheduler.mdx b/src/content/docs/applications/descheduler.mdx index 55ce5ee..588dba7 100644 --- a/src/content/docs/applications/descheduler.mdx +++ b/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. diff --git a/src/content/docs/applications/directus.mdx b/src/content/docs/applications/directus.mdx index db3457a..cf61817 100644 --- a/src/content/docs/applications/directus.mdx +++ b/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. diff --git a/src/content/docs/applications/elastic-operator.mdx b/src/content/docs/applications/elastic-operator.mdx index 565a9e8..0264c41 100644 --- a/src/content/docs/applications/elastic-operator.mdx +++ b/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/). diff --git a/src/content/docs/applications/element-web.mdx b/src/content/docs/applications/element-web.mdx index aa4d664..993b43f 100644 --- a/src/content/docs/applications/element-web.mdx +++ b/src/content/docs/applications/element-web.mdx @@ -17,3 +17,11 @@ hero: import { Aside } from '@astrojs/starlight/components'; + +# Purpose + +Front end web client for Matrix servers. + +# Notes + +Provides front end for [Matrix-Synapse](https://docs.alexlebens.dev/applications/matrix-synapse/) diff --git a/src/content/docs/applications/eraser.mdx b/src/content/docs/applications/eraser.mdx index c6496fd..bdcc35c 100644 --- a/src/content/docs/applications/eraser.mdx +++ b/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. diff --git a/src/content/docs/applications/excalidraw.mdx b/src/content/docs/applications/excalidraw.mdx index f563a89..4ee88aa 100644 --- a/src/content/docs/applications/excalidraw.mdx +++ b/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. diff --git a/src/content/docs/applications/external-dns.mdx b/src/content/docs/applications/external-dns.mdx index 3194c71..f0e8cf2 100644 --- a/src/content/docs/applications/external-dns.mdx +++ b/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. diff --git a/src/content/docs/applications/external-secrets.mdx b/src/content/docs/applications/external-secrets.mdx index 2c27845..0a421e9 100644 --- a/src/content/docs/applications/external-secrets.mdx +++ b/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/). diff --git a/src/content/docs/applications/foldergram.mdx b/src/content/docs/applications/foldergram.mdx index 6475539..b864eae 100644 --- a/src/content/docs/applications/foldergram.mdx +++ b/src/content/docs/applications/foldergram.mdx @@ -17,3 +17,11 @@ hero: import { Aside } from '@astrojs/starlight/components'; + +# 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. diff --git a/src/content/docs/applications/freshrss.mdx b/src/content/docs/applications/freshrss.mdx index d1d80d2..92b4040 100644 --- a/src/content/docs/applications/freshrss.mdx +++ b/src/content/docs/applications/freshrss.mdx @@ -17,3 +17,11 @@ hero: import { Aside } from '@astrojs/starlight/components'; + +# 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. diff --git a/src/content/docs/applications/garage.mdx b/src/content/docs/applications/garage.mdx index a6a01e6..684ffd5 100644 --- a/src/content/docs/applications/garage.mdx +++ b/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. diff --git a/src/content/docs/applications/gatus.mdx b/src/content/docs/applications/gatus.mdx index 960dd74..dc2b2d8 100644 --- a/src/content/docs/applications/gatus.mdx +++ b/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/). diff --git a/src/content/docs/applications/generic-device-plugin.mdx b/src/content/docs/applications/generic-device-plugin.mdx index e36774b..eea4f29 100644 --- a/src/content/docs/applications/generic-device-plugin.mdx +++ b/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). diff --git a/src/content/docs/applications/gitea.mdx b/src/content/docs/applications/gitea.mdx index ddb171f..5ba240d 100644 --- a/src/content/docs/applications/gitea.mdx +++ b/src/content/docs/applications/gitea.mdx @@ -17,3 +17,11 @@ hero: import { Aside } from '@astrojs/starlight/components'; + +# 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. diff --git a/src/content/docs/applications/grafana-operator.mdx b/src/content/docs/applications/grafana-operator.mdx index a430086..a5f06a2 100644 --- a/src/content/docs/applications/grafana-operator.mdx +++ b/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]. diff --git a/src/content/docs/applications/grimmory.mdx b/src/content/docs/applications/grimmory.mdx index ad30e5f..61e88d5 100644 --- a/src/content/docs/applications/grimmory.mdx +++ b/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/). diff --git a/src/content/docs/applications/harbor.mdx b/src/content/docs/applications/harbor.mdx index 4ab521b..09b3cc6 100644 --- a/src/content/docs/applications/harbor.mdx +++ b/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. diff --git a/src/content/docs/applications/headlamp.mdx b/src/content/docs/applications/headlamp.mdx index baf8c27..c507fa7 100644 --- a/src/content/docs/applications/headlamp.mdx +++ b/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. diff --git a/src/content/docs/applications/home-assistant.mdx b/src/content/docs/applications/home-assistant.mdx index 86bf661..cdc3500 100644 --- a/src/content/docs/applications/home-assistant.mdx +++ b/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. diff --git a/src/content/docs/applications/homepage.mdx b/src/content/docs/applications/homepage.mdx index 36ad514..97c0fb3 100644 --- a/src/content/docs/applications/homepage.mdx +++ b/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. diff --git a/src/content/docs/applications/houndarr.mdx b/src/content/docs/applications/houndarr.mdx index 73e04f8..9d44a9a 100644 --- a/src/content/docs/applications/houndarr.mdx +++ b/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. diff --git a/src/content/docs/applications/immich.mdx b/src/content/docs/applications/immich.mdx index 334155b..ab43426 100644 --- a/src/content/docs/applications/immich.mdx +++ b/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. diff --git a/src/content/docs/applications/intel-device-plugin.mdx b/src/content/docs/applications/intel-device-plugin.mdx index ccab0c9..bf3c684 100644 --- a/src/content/docs/applications/intel-device-plugin.mdx +++ b/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. diff --git a/src/content/docs/applications/jellyfin.mdx b/src/content/docs/applications/jellyfin.mdx index 2779447..afb27ad 100644 --- a/src/content/docs/applications/jellyfin.mdx +++ b/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.