Migrar a la pasarela de entrada de Apigee

Sigue este procedimiento para migrar las instalaciones de Apigee hybrid v1.8 que usen Anthos Service Mesh para el tráfico de entrada a Apigee Ingress Gateway.

Pasarela de entrada de Apigee en Apigee Hybrid versión 1.8

A partir de la versión 1.8, Apigee Hybrid ofrece una nueva función para gestionar la pasarela de entrada de tu instalación híbrida: pasarela de entrada de Apigee. Anthos Service Mesh ya no es un requisito previo para la instalación híbrida y Apigee dejará de proporcionar configuración de enrutamiento a Anthos Service Mesh. Después de la actualización, debe migrar el tráfico a la nueva pasarela de entrada de Apigee.

Hay dos situaciones en las que se puede migrar:

• Migración entre varios clústeres o varias regiones (recomendado):

  Antes de cambiar a un nuevo Ingress para Apigee, desvía todo el tráfico a otro clúster u otra región desde el clúster que estés migrando. De este modo, tendrá tiempo para comprobar si la nueva pasarela de entrada de Apigee funciona correctamente. A continuación, vuelve a dirigir el tráfico al clúster actualizado.

• Actualización in situ (no recomendada en entornos de producción):

  Durante la actualización, Apigee activará la nueva pasarela de entrada con una nueva dirección IP. A continuación, puedes probar si la nueva pasarela de entrada de Apigee funciona correctamente y, después, desviar el tráfico a la nueva entrada. Puede que haya un periodo de inactividad durante esta actualización.

Instalar la pasarela de entrada de Apigee

1. Para instalar la pasarela de entrada de Apigee, debe añadir la propiedad ingressGateways a su archivo de anulaciones.

   Sintaxis

   ingressGateways:
   - name: INGRESS_NAME
     replicaCountMin: REPLICAS_MIN
     replicaCountMax: REPLICAS_MAX
     resources:
       requests:
         cpu: CPU_COUNT_REQ
         memory: MEMORY_REQ
       limits:
         cpu: CPU_COUNT_LIMIT
         memory: MEMORY_LIMIT
     svcAnnotations:  # optional.
       SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
     svcLoadBalancerIP: SVC_LOAD_BALANCER_IP # optional

   Ejemplo

   ingressGateways:
   - name: prod1
     replicaCountMin: 2
     replicaCountMax: 100
     resources:
       requests:
         cpu: 1
         memory: 1Gi
       limits:
         cpu: 2
         memory: 2Gi
     svcAnnotations:  # optional. See Known issue 243599452.
       networking.gke.io/load-balancer-type: "Internal"
     svcLoadBalancerIP: 198.252.0.123 

   • INGRESS_NAME es el nombre del despliegue de entrada. Puede ser cualquier nombre que cumpla los siguientes requisitos:
     • Tener una longitud máxima de 17 caracteres
     • Contener solo caracteres alfanuméricos en minúscula, guiones ("-") o puntos (".").
     • Empezar con un carácter alfanumérico
     • Terminar con un carácter alfanumérico
     Consulta ingressGateways[].name en la referencia de la propiedad de configuración.
   • REPLICAS_MIN y REPLICAS_MAX son el número mínimo y máximo de réplicas de la puerta de enlace de entrada de Apigee en tu instalación. Para obtener más información y conocer los ajustes predeterminados, consulta ingressGateways[].replicaCountMin y ingressGateways[].replicaCountMax en la referencia de la propiedad Configuration.
   • CPU_COUNT_REQ y MEMORY_REQ son la solicitud de CPU y memoria de cada réplica de la puerta de enlace de entrada de Apigee en tu instalación.

     Para obtener más información y conocer los ajustes predeterminados, consulta ingressGateways[].resources.requests.cpu y ingressGateways[].resources.requests.memory en la referencia de la propiedad Configuration.

   • CPU_COUNT_LIMIT y MEMORY_LIMIT son los límites máximos de CPU y memoria de cada réplica de la puerta de enlace de entrada de Apigee en tu instalación.

     Para obtener más información y conocer los ajustes predeterminados, consulta ingressGateways[].resources.limits.cpu y ingressGateways[].resources.limits.memory en la referencia de la propiedad Configuration.

   • SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (opcional): .

     Se trata de un par clave-valor que proporciona anotaciones para tu servicio de entrada predeterminado. Tu plataforma en la nube usa las anotaciones para ayudarte a configurar tu instalación híbrida. Por ejemplo, puedes definir el tipo de balanceador de carga como interno o externo. Por ejemplo:

     ingressGateways:
       svcAnnotations:
         networking.gke.io/load-balancer-type: "Internal"

     Las anotaciones varían de una plataforma a otra. Consulta la documentación de tu plataforma para ver las anotaciones obligatorias y sugeridas.

     Consulta ingressGateways[].svcAnnotations en la referencia de la propiedad de configuración.
   • SVC_LOAD_BALANCER_IP (opcional) Te permite asignar una dirección IP estática a tu balanceador de carga. En las plataformas que admiten la especificación de la dirección IP del balanceador de carga, este se creará con esa dirección IP. En las plataformas que no permiten especificar la dirección IP del balanceador de carga, esta propiedad se ignora.

     Si no tienes una dirección IP estática asignada a tu balanceador de carga, no incluyas esta propiedad en tu archivo de anulaciones.

     Consulta ingressGateways[].svcLoadBalancerIP en la referencia de la propiedad de configuración.
2. Aplica los cambios para instalar la puerta de enlace de entrada de Apigee con los siguientes comandos:

   $APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml

Cambiar el tráfico a la pasarela de entrada de Apigee

Para migrar el tráfico de Anthos Service Mesh a Apigee Ingress Gateway, sigue los pasos que se indican en el artículo Cambiar el tráfico de Anthos Service Mesh a Apigee Ingress Gateway del tema sobre cómo actualizar a Apigee Hybrid 1.8.