Registro de las IP de NLB en un subdominio de DNS

Exponga la app a la Internet pública creando un subdominio para la dirección IP del equilibrador de carga de red (NLB).

Antes de empezar:

• Revise las siguientes limitaciones.
  • No se pueden crear subdominios para los NLB privados.
  • Puede registrar hasta 128 subdominios. Este límite se puede aumentar a petición abriendo un caso de soporte.
• Cree un NLB para la app en un clúster de una sola zona o cree NLB en cada zona de un clúster multizona.

Para crear un subdominio para una o varias direcciones IP de NLB:

1. Obtenga la dirección EXTERNAL-IP para su NLB. Si tiene NLB en cada zona de un clúster multizona que expone una app, obtenga los IP para cada NLB.

   oc get svc
   

   En la siguiente salida de ejemplo, las EXTERNAL-IPs de NLB son 168.2.4.5 y 88.2.4.5.

   NAME             TYPE           CLUSTER-IP       EXTERNAL-IP       PORT(S)                AGE
   lb-myapp-dal10   LoadBalancer   172.21.xxx.xxx   168.2.4.5         1883:30303/TCP         6d
   lb-myapp-dal12   LoadBalancer   172.21.xxx.xxx   88.2.4.5          1883:31303/TCP         6d
   

2. Registre la IP creando un subdominio de DNS. Para especificar varias direcciones IP, utilice varias --ip opciones.

   ibmcloud oc nlb-dns create classic --cluster <cluster_name_or_id> --ip <NLB_IP> --ip <NLB2_IP>
   

3. Verifique que se ha creado el subdominio.

   ibmcloud oc nlb-dns ls --cluster <cluster_name_or_id>
   

   Salida de ejemplo

   Hostname                                                                                IP(s)              Health Monitor   SSL Cert Status           SSL Cert Secret Name
   mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud     ["168.2.4.5"]      None             created                   <certificate>
   

4. Opcional: configure un dominio personalizado que apunte al subdominio proporcionado por IBM que ha creado en el paso anterior.

   • Registra un dominio personalizado poniéndote en contacto con tu proveedor de servicios de nombres de dominio (DNS).
   • Registre un dominio personalizado utilizando IBM Cloud DNS.

   También puede registrar un dominio personalizado utilizando la anotación service.kubernetes.io/ibm-load-balancer-cloud-provider-dns-name en la configuración del balanceador de carga.

5. Defina un alias para el dominio personalizado especificando el subdominio proporcionado por IBM como CNAME (Registro de nombre canónico).

6. En un navegador web, escriba el URL para acceder a la app a través del subdominio que ha creado.

A continuación, puede habilitar comprobaciones de estado en el subdominio mediante la creación de un supervisor de estado.

Formato del subdominio

Los subdominios para los NLB siguen el formato <cluster_name>-<globally_unique_account_HASH>-0001.<region>.containers.appdomain.cloud.

Por ejemplo un subdominio que haya creado para un NLB podría ser así: mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud. En la tabla siguiente se describe cada componente del subdominio.

Habilitación de comprobaciones de estado en un subdominio mediante la creación de un supervisor de estado

Habilite las comprobaciones de estado en las direcciones IP de NLB detrás de un solo subdominio para determinar si están disponibles o no.

Si utiliza políticas de red pre-DNAT de Calico, grupos de seguridad de VPC, listas de control de acceso(ACL)de VPC u otra solución de cortafuegos personalizada para bloquear el tráfico entrante a los servicios Ingress o de enrutador, debe permitir el tráfico entrante desde los puntos finales de supervisión de estado. Para obtener más información, consulte la documentación sobre cómo permitir el tráfico de red entrante para la supervisión de subdominios de entrada.

Antes de empezar, registre las IP de NLB en un subdominio de DNS.

1. Obtenga el nombre del subdominio. En la salida, observe que el host tiene el Estado de supervisor Unconfigured.

   ibmcloud oc nlb-dns monitor ls --cluster <cluster_name_or_id>
   

   Salida de ejemplo

   Hostname                                                                                   Status         Type    Port   Path
   mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud        Unconfigured   N/A     0      N/A
   

2. Cree un supervisor de comprobación de estado para el subdominio. Si no incluye un parámetro de configuración, se utiliza el valor predeterminado.

   ibmcloud oc nlb-dns monitor configure --cluster <cluster_name_or_id> --nlb-host <host_name> --enable --type <type> --path <path> --timeout <timeout> --interval <interval> --port <port> --header <header>
   

   -c, --cluster <cluster_name_or_ID>

   Obligatorio: el nombre o el ID del clúster en el que está registrado el subdominio.

   --nlb-host <host_name>

   Obligatorio: el subdominio para el que desea habilitar un supervisor de comprobación de estado.

   --enable

   Incluye esta opción para activar un nuevo monitor de comprobación de estado para un subdominio.

   --type <type>

   El protocolo que se utiliza para la comprobación de estado: HTTP, HTTPS o TCP. Valor predeterminado: HTTP.

   --path <path>

   Cuando type es HTTPS: la vía de acceso de punto final con la que se realiza la comprobación de estado. Valor predeterminado: /

   --timeout <timeout>

   El tiempo de espera, en segundos, antes de que se considere que no se puede establecer contacto con la IP. La comprobación de estado espera los segundos especificados en el parámetro interval antes de intentar acceder a la IP de nuevo. El valor debe ser un número entero comprendido entre 1 y 60. Valor predeterminado: 5

   --interval <interval>

   El intervalo, en segundos, entre cada comprobación de estado. Los intervalos cortos pueden mejorar el tiempo de migración tras error, pero aumentar la carga en los IP. El valor debe ser un número entero comprendido entre 60 y 300. Valor predeterminado: 60.

   --port <port>

   El número de puerto al que conectar para la comprobación de estado. Cuando type es TCP, este parámetro es obligatorio. Cuando type es HTTP o HTTPS, sólo es necesario definir el puerto si se utiliza un puerto distinto de 80 para HTTP o de 443 para HTTPS. Valor predeterminado para TCP: 0. Valor predeterminado para HTTP: 80. Valor predeterminado para HTTPS: 443.

   --header <header>

   Requerido cuando type es o HTTP HTTPS: HTTP. Los encabezados de solicitud para la comprobación de estado se limitan al encabezado Host. Esta bandera solo es válida para el tipo HTTP o HTTPS. Este indicador admite valores en el siguiente formato: --header Header-Name=value. Cuando se actualiza un supervisor, las cabeceras existentes se sustituyen por las que especifique. Para eliminar todos los encabezados existentes, especifica el indicador con un valor vacío --header "".

   Mandato de ejemplo

   ibmcloud oc nlb-dns monitor configure --cluster mycluster --nlb-host mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud --enable --type HTTPS --path /alive --timeout 5 --interval 60 --header Host=example.com
   

3. Verifique que el monitor de comprobación de estado esté configurado con los valores correctos.

   ibmcloud oc nlb-dns monitor get --cluster <cluster_name_or_id> --nlb-host <host_name>
   

   Salida de ejemplo

   Status:           enabled
   Type:             https
   Method:           GET
   Path:             /alive
   Expected Codes:   2xx
   Port:             443
   Timeout:          5
   Interval:         60
   Headers:
   Host:      example.com
   

4. Visualice el estado de comprobación de estado del subdominio.

   ibmcloud oc nlb-dns monitor ls --cluster <cluster_name_or_id>
   

   Salida de ejemplo

   Hostname                                                                                Status      Type    Port   Path
   mycluster-a1b2cdef345678g9hi012j3kl4567890-0001.us-south.containers.appdomain.cloud     enabled     https   443    /alive
   

ibmcloud oc nlb-dns add --cluster <cluster_name_or_id> --ip <NLB_IP> --ip <NLB2_IP> ... --nlb-host <host_name>

ibmcloud oc nlb-dns rm classic --cluster <cluster_name_or_id> --ip <ip> --nlb-host <host_name>

ibmcloud oc nlb-dns monitor configure --cluster <cluster_name_or_id> --nlb-host <host_name> --type <type> --path <path> --timeout <timeout> --interval <interval> --port <port> --header <header>

ibmcloud oc nlb-dns monitor disable --cluster <cluster_name_or_id> --nlb-host <host_name>

ibmcloud oc nlb-dns monitor enable --cluster <cluster_name_or_id> --nlb-host <host_name>