Migra a la puerta de enlace de entrada de Apigee

Usa este procedimiento para migrar las instalaciones existentes de Apigee Hybrid v1.8 desde el uso de Anthos Service Mesh para la entrada al uso de la puerta de enlace de entrada de Apigee.

Apigee Ingress Gateway en Apigee Hybrid versión 1.8

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

Hay dos situaciones de migración:

Migración multiclúster o multirregión (recomendada):
Antes de cambiar a una nueva entrada para Apigee, desvía todo el tráfico a otro clúster o región del clúster que migras. Esto te dará tiempo para probar si la nueva puerta de enlace de entrada de Apigee funciona como se espera. Luego, vuelve a mover el tráfico al clúster actualizado.
Actualización local (no se recomienda en entornos de producción):
Durante la actualización, Apigee mostrará la puerta de enlace de entrada nueva con una nueva dirección IP. A continuación, puedes probar si la nueva puerta de enlace de entrada de Apigee funciona como se espera y, luego, desviar el tráfico a la nueva entrada. Es posible que haya tiempo de inactividad durante esta actualización.

Instala la puerta de enlace de entrada de Apigee

Para instalar la puerta de enlace de entrada de Apigee, debes agregar la propiedad ingressGateways a tu 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. See Known issue 243599452.
    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 de la implementación de entrada. Puede ser cualquier nombre que cumpla con los siguientes requisitos:
  - Tener una longitud máxima de 17 caracteres
  - Contener solo caracteres alfanuméricos en minúscula “.” o “-”.
  - Comenzar 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 los recuentos de réplicas mínimas y máximas para la puerta de enlace de entrada de Apigee en tu instalación. Para obtener más información y la configuración predeterminada, consulta ingressGateways[].replicaCountMin y ingressGateways[].replicaCountMax en la referencia de la propiedad de configuración.
- CPU_COUNT_REQ y MEMORY_REQ son la solicitud de CPU y memoria para cada réplica de la puerta de enlace de entrada de Apigee en tu instalación.
  Configura estas propiedades si las configuraste antes para la puerta de enlace de entrada de Anthos Service Mesh, por ejemplo, en el archivo overlay.yaml.
  
  Para obtener más información y la configuración predeterminada, consulta ingressGateways[].resources.requests.cpu y ingressGateways[].resources.requests.memory en la referencia de la propiedad de configuración.
- CPU_COUNT_LIMIT y MEMORY_LIMIT son los límites máximos de CPU y memoria para cada réplica de la puerta de enlace de entrada de Apigee en tu instalación.
  Configura estas propiedades si las configuraste antes para la puerta de enlace de entrada de Anthos Service Mesh, por ejemplo, en el archivo overlay.yaml.
  
  Para obtener más información y la configuración predeterminada, consulta ingressGateways[].resources.limits.cpu y ingressGateways[].resources.limits.memory en la referencia de la propiedad de configuración.
- SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (opcional):
  Nota: El campo ingressGateways[].svcAnnotations en overrides.yaml no funciona como se espera. Consulta Problema conocido 243599452
  
  Este es un par clave-valor que proporciona anotaciones para tu servicio de entrada predeterminado. La plataforma en la nube usa las anotaciones para configurar tu instalación híbrida, por ejemplo, si estableces el tipo de balanceador de cargas 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.
  
  Nota: No es necesario que configures Annotations si creas tu propio servicio de Kubernetes para la implementación de entrada como se documenta en Expón la entrada de Apigee.
  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 para el balanceador de cargas. En las plataformas que admiten la especificación de la dirección IP del balanceador de cargas, el balanceador de cargas se creará con esta dirección IP. En plataformas que no te permiten especificar la dirección IP del balanceador de cargas, se ignora esta propiedad.
  Si no tienes una dirección IP estática asignada a tu balanceador de cargas, deja esta propiedad fuera de tu archivo de anulaciones.
  
  Precaución: Asegúrate de no especificar la misma dirección IP que la istio-ingressgateway actual. Esto podría causar problemas mientras ese servicio aún está en el clúster.
  
  Nota: No es necesario que configures LoadBalancerIP si creas tu propio servicio de Kubernetes para la implementación de entrada, como se documenta en Expón la puerta de enlace de entrada de Apigee.
  Consulta ingressGateways[].svcLoadBalancerIP en la referencia de la propiedad de configuración.
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
```

Cambia el tráfico a la puerta de enlace de entrada de Apigee

Para migrar el tráfico de Anthos Service Mesh a la puerta de enlace de entrada de Apigee, sigue los pasos en Cambia el tráfico de Anthos Service Mesh a la puerta de enlace de entrada de Apigee en el tema Actualiza a Apigee Hybrid v1.8.