tfgrid/myceliumcloud-examples
11
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Add IPv6 dual-stack documentation and debug script for nginx-nodeport

Browse Source
This commit is contained in:
mik-tf
2025-11-06 21:00:04 -05:00
parent b195cd0171
commit 2ffcfbbff7
4 changed files with 419 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
examples/nginx-nodeport/nginx-nodeport.md
View File

@@ -2,6 +2,22 @@
A complete, production-ready example for deploying a secure, globally accessible website on Mycelium Cloud using Kubernetes **NodePort** services with enhanced network isolation. This demonstrates **security-first IPv6 web hosting** with standard Kubernetes patterns.
## 🚨 CRITICAL: IPv6 Configuration Required
**IMPORTANT:** This example requires **dual-stack service configuration** to work with Mycelium IPv6 addresses. Without it, you'll be able to ping IPv6 addresses but not access the service.
**The Fix:** The `nginx-nodeport-service.yaml` includes:
```yaml
ipFamilies:
- IPv4
- IPv6
ipFamilyPolicy: RequireDualStack
```
**Why:** Kubernetes services default to IPv4-only. Mycelium uses IPv6, so we must explicitly enable dual-stack.
**Status:** ✅ Included in provided YAML files. See [IPV6_FIX.md](IPV6_FIX.md) for details.
## 🔑 Key Concept: NodePort Access Pattern
**Important:** With NodePort, you access the service via: