Paso 1: Crear un servicio de ClusterIP

Para cada despliegue de app que desee exponer, cree un servicio ClusterIP de Kubernetes. El servicio de Kubernetes debe exponer la app para que se incluya en el equilibrio de carga de Ingress.

kubectl expose deploy <app_deployment_name> --name my-app-svc --port <app_port> -n <namespace>

Paso 2: Configurar la terminación TLS con los certificados TLS y los secretos Kubernetes

Su certificado TLS debe almacenarse como secreto Kubernetes en cada espacio de nombres donde existan sus aplicaciones.

• Para utilizar el subdominio Ingress proporcionado por IBM, consulte Configuración de los secretos de TLS para el subdominio Ingress proporcionado por IBM.

• Para utilizar un dominio personalizado, consulte Configuración de secretos TLS para subdominios personalizados.

Paso 3: Crear el recurso de Ingress

Crea el recurso Ingress para definir las reglas de enrutamiento que el controlador Ingress utiliza para dirigir el tráfico hacia tu servicio de aplicación.

1. Cree el recurso de Ingress en un archivo YAML.

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: my-ingress-resource
   spec:
     ingressClassName: public-iks-k8s-nginx
     tls:
     - hosts:
       - <domain_name>
       secretName: <tls_secret_name>
     rules:
     - host: HOSTNAME
       http:
         paths:
         - path: <app_path_1>
           pathType: Prefix
           backend:
             service:
               name: <app_service_1>
               port:
                 number: 80
         - path: <app_path_2>
           pathType: Prefix
           backend:
             service:
               name: <app_service_2>
               port:
                 number: 80
   

Campos de recursos

ingressClassName

El nombre de clase de Ingress. Las clases de Ingress proporcionadas por IBMson public-iks-k8s-nginx para ALB públicos y private-iks-k8s-nginx para ALB privados.

tls.hosts

Para utilizar TLS, sustituya <domain> por el subdominio de Ingress proporcionado por IBM o por el dominio personalizado.

tls.secretName

Sustituya <tls_secret_name> por el nombre del secreto Kubernetes donde está almacenado su certificado TLS.

host

Sustituya <domain> por el subdominio de Ingress proporcionado por IBM o por el dominio personalizado.

path

Sustituya <app_path> por una barra inclinada o por la vía de acceso en la que escucha la aplicación. La ruta se añade al dominio de Ingress especificado para crear una ruta única hacia tu aplicación. Cuando especifica esta ruta en un navegador web, el tráfico de la red se direcciona al ALB. El ALB consulta el servicio asociado y envía el tráfico de red al servicio. A continuación, el servicio reenvía el tráfico a los pods en los que se ejecuta la app.

pathType

El método de comparación de vías de acceso de URL. Los valores admitidos son ImplementationSpecific, Exact o Prefix. Para obtener más información y ver ejemplos de cada tipo de ruta, consulta la documentación de la comunidad sobre Kubernetes.

service.name

Sustituya app1_service y app2_service, y así sucesivamente, por el nombre de los servicios que ha creado para exponer las aplicaciones. Asegúrese de que las apps que especifique estén en el mismo espacio de nombres.

service.name

Sustituya <app1_service> y <app2_service>, y así sucesivamente, por el nombre de los servicios que ha creado para exponer las aplicaciones. Asegúrese de que las apps que especifique estén en el mismo espacio de nombres.

service.port.number

El puerto en el que el servicio está a la escucha. Utilice el mismo puerto que ha definido al crear el servicio de Kubernetes para la app.

2. Aplica el recurso Ingress a tu clúster. Asegúrese de que el recurso se despliega en el mismo espacio de nombres que los servicios de apps que ha especificado en el recurso.

   kubectl apply -f community-ingress-resource.yaml -n <namespace>
   

Paso 4: Verificar la configuración de Ingress

1. Enumera tus ALB y copia la dirección IP (clásica) o el nombre de host (VPC) de un ALB que ejecute la imagen de Ingress Kubernetes. En la salida, elija un ALB que tenga Build en el formato <community_version>_<ibm_build>_iks.

   ibmcloud ks ingress alb ls -c CLUSTER
   

2. Utiliza la dirección IP del ALB (clásico) o el nombre de host (VPC), la ruta de la aplicación y tu dominio para comprobar que puedes enviar tráfico correctamente a tu aplicación a través de este ALB.

   curl http://<ALB_IP>/<app_path> -H "Host: <ingress_subdomain>"
   

   Por ejemplo, para enviar una solicitud a una aplicación llamada myapp utilizando un subdominio Ingress predeterminado, ejecuta el siguiente comando.

   curl http://169.X.X.X/myapp -H "Host: mycluster-a1b2cdef345678g9hi012j3kl4567890-0000.us-south.containers.appdomain.cloud"
   

¿Tiene problemas para conectarse a su app a través de Ingress? Intente resolverlos consultando Resolución de problemas de Ingress. Para comprobar el estado de los componentes de Ingress, ejecute ibmcloud ks ingress status-report get -c CLUSTER_NAME_OR_ID.

Creación de dominios personalizados para ALB públicos

Siga los pasos para crear un dominio personalizado para los ALB públicos.

1. Cree un dominio personalizado. Para registrar un dominio personalizado, póngase en contacto con su proveedor de DNS (Domain Name Service) o con IBM Cloud DNS. Si las apps que desea que Ingress exponga se encuentran en diferentes espacios de nombres en un clúster, registre el dominio personalizado como un dominio comodín como, por ejemplo, *.custom_domain.net. Tenga en cuenta que los dominios están limitados a 130 caracteres o menos en Kubernetes versión 1.20 o posterior.

2. Defina un alias para el dominio personalizado especificando el subdominio proporcionado por IBM como CNAME (Registro de nombre canónico). Para buscar el dominio de Ingress proporcionado por IBM, ejecute ibmcloud ks cluster get --cluster CLUSTER_NAME y busque el campo Subdominio de Ingress.

   Es necesario especificar el subdominio proporcionado por IBM como un CNAME para que las comprobaciones de estado automáticas eliminen cualquier IP defectuosa de la respuesta DNS y para garantizar que su dominio personalizado se actualice cuando añada o elimine ALB.

Creación de dominios personalizados para ALB privados

Siga los pasos para crear un dominio personalizado para ALB privados. Tenga en cuenta que los dominios personalizados son necesarios para utilizar Ingress con ALB privados.

Si tiene un clúster clásico con solo una VLAN privada, primero debe configurar su propio servicio DNS que está disponible en la red privada.

1. Cree un dominio personalizado a través del proveedor de servicios de DNS. Tenga en cuenta que los URL de Ingress deben tener 130 caracteres o menos.

2. Correlacione el dominio personalizado con los ALB privados añadiendo sus direcciones IP como registros A (clústeres clásicos) o su nombre de host de VPC como CNAME (clústeres de VPC). Para buscar el nombre de host (VPC) o las direcciones IP (clásica), ejecute ibmcloud ks ingress alb ls -c CLUSTER_NAME_OR_ID.