nginx-to-higress-migration

Umożliwia bezpieczną migrację klastrów Kubernetes z ingress-nginx na Higress. Narzędzie analizuje istniejące konfiguracje, identyfikuje niekompatybilne adnotacje nginx, generuje wtyczki WASM dla zaawansowanych funkcji oraz wspiera pełny przepływ migracji z weryfikacją zgodności. Idealne dla zespołów DevOps zarządzających wdrożeniami Kubernetes na dużą skalę.

1. Przygotuj środowisko: upewnij się, że masz zainstalowany kubectl z dostępem do klastra, helm 3.x, Go 1.24+ oraz Docker. Te narzędzia są wymagane do pełnego przepływu migracji i kompilacji wtyczek WASM.

2. Wykonaj backup i analizę: utwórz kopię zapasową wszystkich zasobów Ingress poleceniem kubectl get ingress -A -o yaml, a następnie zidentyfikuj użycie adnotacji nginx-snippet, które Higress nie obsługuje. Uruchom polecenie grep na swoich zasobach, aby znaleźć nginx.ingress.kubernetes.io/server-snippet, nginx.ingress.kubernetes.io/configuration-snippet i nginx.ingress.kubernetes.io/http-snippet.

3. Zmapuj adnotacje: wylistuj wszystkie adnotacje nginx w użyciu w swoim klastrze i sprawdź ich kompatybilność z Higress za pomocą dokumentacji annotation-mapping.md. To krok krytyczny — niektóre adnotacje mogą być niezgodne i wymagać alternatywnych rozwiązań.

4. Zainstaluj Higress: wdróż Higress do klastra za pomocą helm, upewniając się, że prawidłowo skonfigurowany jest ingressClass. Higress stanie się nowym kontrolerem ingress dla Twojego klastra.

5. Wygeneruj wtyczki WASM: dla funkcji nginx, które nie mają bezpośredniego odpowiednika w Higress (szczególnie te oparte na snippet-ach), użyj narzędzia do generowania wtyczek WASM. Skompiluj wtyczki za pomocą Go i wypchnij obrazy do rejestru Docker.

6. Wdróż i weryfikuj: zainstaluj wygenerowane wtyczki w Higress, przetestuj migrację na małym podzbiorze zasobów, a następnie stopniowo przemigruj pozostałe ingress-y. Monitoruj logi i funkcjonalność, aby upewnić się, że wszystkie usługi działają poprawnie.