🌐 Ingress

El Ingress es la "recepción" del clúster: recibe las visitas por el puerto 80/443 y encamina cada dominio o ruta al Service correcto. Así usted publica varios sitios con una única IP.

El clúster SaveinCloud ya viene con dos Ingress Controllers instalados: Traefik y NGINX.

info

El Ingress se crea con kubectl. El Panel Nuvion se usa para consultar la IP que recibirá el tráfico (paso 4).

---

🚀 Antes de comenzar

• Tener el acceso al clúster configurado (vea Acceso al Clúster).
• Tener una aplicación con Service. Cree una siguiendo la página Services (pasos 1 y 2).
• Tener un dominio, si desea acceder por nombre (opcional para pruebas).

🚀 1. Ver los controllers disponibles

kubectl get ingressclass

Anote el nombre de la clase que desea usar (por ejemplo, nginx o traefik).

🚀 2. Crear el archivo del Ingress

Cree el archivo web-ingress.yaml:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: web-ingress
spec:
  ingressClassName: nginx   # cambie por traefik, si prefiere
  rules:
    - host: app.ejemplo.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: web-svc
                port:
                  number: 80

🚀 3. Aplicar y verificar

kubectl apply -f web-ingress.yaml
kubectl get ingress web-ingress

🚀 4. Descubrir la IP del Ingress

🖥️ Panel Nuvion

Acceda a Computar > IPs flotantes (o Computar > Balanceadores de carga) y localice la IP asociada al clúster.

⌨️ kubectl (CLI)

kubectl get svc -A | grep -i -E "ingress|traefik"

Vea la columna EXTERNAL-IP del Service del controller.

🚀 5. Apuntar el dominio

En el panel de su proveedor de DNS, cree un registro A de app.ejemplo.com apuntando a la IP del paso 4.

🚀 6. Probar

Con el DNS configurado, abra http://app.ejemplo.com en el navegador.

Para probar sin DNS:

curl -H "Host: app.ejemplo.com" http://IP-DEL-INGRESS

✅ Cómo saber si funcionó

Aparece la página Welcome to nginx!.

❗ Problemas comunes

Síntoma	Causa	Solución
404 Not Found	Host o ruta distintos del Ingress	Verifique host y path
502 o 503	Service sin pods	Ejecute kubectl get endpoints web-svc
No abre	El DNS no se propagó o el puerto 80 está bloqueado	Revise el DNS y los Grupos de seguridad
ADDRESS vacío en el Ingress	Clase incorrecta	Verifique el ingressClassName

🧹 Limpieza

kubectl delete ingress web-ingress

➡️ Próximo paso: Configuración (ConfigMap)

🧠 ¿Dudas?

¡Hable con nuestro equipo de soporte técnico de SaveinCloud!