distribute READMEs

kubernetes/graduated/gitea/README.md

@@ -0,0 +1,69 @@
+# Gitea
+
+Gitea provides a helm chart [here](https://gitea.com/gitea/helm-chart/). We're not
+going to modify much, but we are going to solidify some of the default values in case
+they decide to change things. This is the first chart (besides ingress-nginx) where
+we need to pay attention to the MetalLB annotation. This has been set in the values.yaml
+file.
+
+## Staging
+
+There is a `gitea-staging.yaml` file with staging values. This should be installed in
+the `gitea-staging` namespace. Follow the instructions below, but replace the `gitea`
+namespace with `gitea-staging`. Staging is useful for testing major release upgrades,
+especially since Gitea tends to change how `values.yaml` is structured.
+
+## Install
+
+First we need to create the gitea admin secret
+
+```bash
+kubectl create namespace gitea
+kubectl create secret generic gitea-admin-secret \
+    -n gitea \
+    --from-literal=username='gitea-admin' \
+    --from-literal=password="$(pwgen -c -s 64 | head -n 1)" \
+    --from-literal=email=''
+```
+
+```bash
+helm repo add gitea-charts https://dl.gitea.io/charts/
+helm repo update
+helm upgrade --install \
+    gitea \
+    gitea-charts/gitea \
+    --values kubernetes/graduated/gitea/gitea-values.yaml \
+    --namespace gitea \
+    --create-namespace
+```
+
+## Backup and Restore
+
+If you need to backup your database you can run:
+
+```bash
+# Backup
+kubectl exec -it -n gitea gitea-postgresql-0 -- \
+    pg_dump \
+    --no-owner \
+    --dbname=postgresql://gitea:gitea@localhost:5432 > gitea_backup.db
+
+# Take gitea down to zero pods
+kubectl scale statefulset gitea --replicas 0
+
+# Drop the existing database
+kubectl exec -it -n gitea gitea-postgresql-0 -- psql -U gitea
+
+\c postgres;
+drop database gitea;
+CREATE DATABASE gitea WITH OWNER gitea TEMPLATE template0 ENCODING UTF8 LC_COLLATE 'en_US.UTF-8' LC_CTYPE 'en_US.UTF-8';
+exit
+
+# restore from backup
+kubectl exec -it -n gitea gitea-postgresql-0 -- \
+    psql \
+    postgresql://gitea:gitea@localhost:5432 gitea < gitea_backup.db
+
+# Restore gitea to 1 pod
+kubectl scale statefulset gitea --replicas 1
+```

kubernetes/graduated/iperf3/README.md

@@ -0,0 +1,13 @@
+# Iperf3
+
+This creates a basic iperf3 server.
+
+## Install
+
+```bash
+helm upgrade --install \
+    iperf3 \
+    ./kubernetes/graduated/iperf3 \
+    --namespace iperf3 \
+    --create-namespace
+```

kubernetes/graduated/jellyfin/README.md

@@ -0,0 +1,11 @@
+# Jellyfin
+
+## Install
+
+```bash
+helm upgrade --install \
+    jellyfin \
+    ./kubernetes/graduated/jellyfin \
+    --namespace jellyfin \
+    --create-namespace
+```

kubernetes/graduated/minecraft/README.md

@@ -0,0 +1,36 @@
+# Minecraft
+
+Minecraft is available through the custom helm chart (including a server downloader). The example
+below installs nimcraft. For each installation you'll want to create your own values.yaml
+with a new port. The server-downloader is called "minecraft_get_server" and is available on
+[Github](https://github.com/ducoterra/minecraft_get_server).
+
+## Testing
+
+```bash
+helm upgrade --install \
+    testcraft \
+    ./kubernetes/graduated/minecraft \
+    --namespace minecraft \
+    --create-namespace
+```
+
+## Nimcraft
+
+```bash
+helm upgrade --install \
+    nimcraft \
+    ./kubernetes/graduated/minecraft \
+    --namespace minecraft \
+    --create-namespace
+```
+
+## Courtnie
+
+```bash
+helm upgrade --install \
+    courtniecraft \
+    ./kubernetes/graduated/minecraft \
+    --namespace minecraft \
+    --create-namespace
+```

kubernetes/graduated/snapdrop/README.md

@@ -0,0 +1,13 @@
+# Snapdrop
+
+Snapdrop is a file sharing app that allows airdrop-like functionality over the web
+
+## Install
+
+```bash
+helm upgrade --install \
+    snapdrop \
+    ./kubernetes/graduated/snapdrop \
+    --namespace snapdrop \
+    --create-namespace
+```

kubernetes/incubating/grafana/README.md

@@ -8,7 +8,7 @@ helm repo update
 helm upgrade --install my-grafana grafana/grafana \
     --namespace monitoring \
     --create-namespace \
-    --values grafana/values.yaml
+    --values kubernetes/incubating/grafana/values.yaml
 
 kubectl get secret --namespace monitoring my-grafana -o jsonpath="{.data.admin-password}" | base64 --decode ; echo
 ```
@@ -25,5 +25,5 @@ helm upgrade --install \
     kube-prometheus-stack \
     prometheus-community/kube-prometheus-stack \
     --namespace kube-system \
-    --values grafana/helm-prom-stack-values.yaml
+    --values kubernetes/incubating/grafana/helm-prom-stack-values.yaml
 ```

kubernetes/incubating/wordpress/README.md

@@ -0,0 +1,18 @@
+# Wordpress
+
+The bitnami wordpress chart allows enough customization to
+work on a custom K3S server. With some tweaks it's quite
+good. Use the values in `bitnami/wordpress.yaml` as a starting
+point.
+
+## Install
+
+```bash
+helm upgrade --install \
+    wordpress \
+    -f kubernetes/incubating/bitnami/wordpress.yaml \
+    --set wordpressUsername=admin \
+    --set wordpressPassword=password \
+    --set mariadb.auth.rootPassword=secretpassword \
+    oci://registry-1.docker.io/bitnamicharts/wordpress
+```