From 24bdc15a78ec31a75bfa19a907aaa9f36beb25fb Mon Sep 17 00:00:00 2001 From: Prathamesh Musale Date: Fri, 21 Nov 2025 11:55:29 +0530 Subject: [PATCH] Document options for handling network requirements --- docs/helm-chart-generation.md | 37 +++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/docs/helm-chart-generation.md b/docs/helm-chart-generation.md index b1d083bd..903ae2da 100644 --- a/docs/helm-chart-generation.md +++ b/docs/helm-chart-generation.md @@ -74,3 +74,40 @@ laconic-so --stack stage1-zenithd deploy create \ # Deploy helm install stage1-zenithd stage1-deployment/chart ``` + +## Production Deployment (TODO) + +### Local Development + +```bash +# Access services using port-forward +kubectl port-forward service/zenithd 26657:26657 +kubectl port-forward service/nginx-api-proxy 1317:80 +kubectl port-forward service/cosmos-explorer 4173:4173 +``` + +### Production Access Options + +- Option 1: Ingress + cert-manager (Recommended) + - Install ingress-nginx + cert-manager + - Point DNS to cluster LoadBalancer IP + - Auto-provisions Let's Encrypt TLS certs + - Access: `https://api.zenith.example.com` +- Option 2: Cloud LoadBalancer + - Use cloud provider's LoadBalancer service type + - Point DNS to assigned external IP + - Manual TLS cert management +- Option 3: Bare Metal (MetalLB + Ingress) + - MetalLB provides LoadBalancer IPs from local network + - Same Ingress setup as cloud +- Option 4: NodePort + External Proxy + - Expose services on 30000-32767 range + - External nginx/Caddy proxies 80/443 → NodePort + - Manual cert management + +### Changes Needed + +- Add Ingress template to charts +- Add TLS configuration to values.yaml +- Document cert-manager setup +- Add production deployment guide