1.2.0: Notas de la versión del entorno de ejecución híbrido de Apigee

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

El 3 de abril de 2020, lanzamos la versión 1.2.0 del entorno de ejecución de Apigee Hybrid.

Actualizándose

Nuevas funciones y actualizaciones

A continuación, presentamos las nuevas funciones y actualizaciones de esta versión.

Se agregó una nueva configuración de host virtual para especificar reglas de enrutamiento

La nueva característica de configuración de virtualhosts aborda un problema en el que el orden en que las rutas base se enrutaban a varios entornos no eran seguros. Para obtener más información, consulta Configura hosts virtuales. (150336519)

Versión beta de la política OASValidation

La política OASValidation (Validación de especificaciones de OpenAPI), en fase beta, te permite validar un mensaje de solicitud o respuesta entrante con una especificación de OpenAPI 3.0 (JSON o YAML). Para obtener más información, consulta la política OASValidation (beta). (144949685)

Versión beta de la compatibilidad con WebSocket

Apigee Hybrid admite conexiones de WebSocket. Los clientes del proxy de API ahora pueden solicitar una actualización del protocolo de HTTP a WebSockets. Para obtener más información, consulta Usa WebSockets (beta).

Accede a los valores secretos de las políticas desde los Secrets de Kubernetes

Una nueva función te permite acceder a los valores almacenados en un secret de Kubernetes en variables de flujo del proxy. Para obtener más detalles, consulta Almacena datos en un secret de Kubernetes. (133377603)

El elemento de Operadores de Apigee (AO) reemplaza a ADAC y ADAH

Los operadores de Apigee (AO) crean y actualizan los recursos de Istio y Kubernetes de bajo nivel necesarios para implementar y mantener la AD. Por ejemplo, el controlador lleva a cabo la actualización de procesadores de mensajes. Además, valida la configuración de ApigeeDeployment antes de conservarla en el clúster de Kubernetes. AO reemplaza Apigee Deployment Admissionhook (ADAH) y Apigee Deployment Controller (ADC). Consulta AO en la referencia de la propiedad de configuración. (151250559)

Reemplaza y da de baja ciertas propiedades de configuración de clústeres y proyectos

Se agregaron dos propiedades de configuración nuevas: k8sCluster y gcp. Estas propiedades reemplazan las siguientes propiedades obsoletas: k8sClusterName, gcpRegion y gcpProjectID. Para obtener detalles, consulta Referencia de propiedad de configuración. (146299599)

Expansión del volumen persistente para Cassandra en Kubernetes

Se agregó un proceso para expandir el volumen persistente que usa Apigee-cassandra para satisfacer las necesidades de almacenamiento, sin necesidad de agregar más nodos solo para aumentar el almacenamiento. Consulta Expande los volúmenes persistentes de Cassandra. (138167919)

Brinda compatibilidad con fuentes adicionales para certificados, claves de encriptación y SA.

Se agregaron propiedades de configuración nuevas que proporcionan mayor flexibilidad en la forma en que especificas certificados TLS, claves de encriptación y claves de cuenta de servicio. A continuación, se indican las propiedades nuevas:

  • kmsEncryptionPath
  • kmsEncryptionSecret.key
  • kmsEncryptionSecret.name
  • cassandra.backup.serviceAccountSecretRef
  • cassandra.restore.serviceAccountSecretRef
  • envs[].cacheEncryptionPath
  • envs[].cacheEncryptionSecret.key
  • envs[].cacheEncryptionSecret.name
  • envs[].kmsEncryptionPath
  • envs[].kmsEncryptionSecret.key
  • envs[].kmsEncryptionSecret.name
  • envs[].serviceAccountSecretRefs.synchronizer
  • envs[].serviceAccountSecretRefs.udca
  • envs[].sslSecret
  • logger.serviceAccountSecretRef
  • mart.serviceAccountSecretRef
  • mart.sslSecret
  • metrics.serviceAccountSecretRef
  • synchronizer.serviceAccountSecretRef
  • udca.serviceAccountSecretRef

Para obtener más información, consulta la referencia de la propiedad de configuración. (145303466)

Permite que los clientes ofusquen datos antes de enviarlos a las estadísticas

Se agregó una función que te permite ofuscar algunos datos de estadísticas antes de enviarlos al plano de administración. Para obtener detalles, consulta Cómo ofuscar datos del usuario para estadísticas. (142578910)

Expande volúmenes persistentes para statefulsets

Se agregó una función que te permite expandir el volumen persistente que usa Apigee-cassandra para satisfacer las necesidades de almacenamiento, sin aumentar la potencia de procesamiento. A fin de obtener más información, consulta Expande volúmenes persistentes para conjuntos con estado. (138167919)

Se actualizaron las versiones mínimas admitidas de GKE, Anthos y AKS

Apigee Hybrid ahora es compatible con GKE 1.14.x, Anthos 1.2 y AKS 1.14.x. (149578101)

Compatibilidad con TLS 1.3 para las conexiones de extremos ascendentes

Dos propiedades de configuración nuevas te permiten establecer la versión mínima y máxima de TLS para las entradas: ingress.minTLSProtocolVersion y maxTLSProtocolVersion. Los valores posibles son 1.0, 1.1, 1.2 y 1.3. Para obtener más información, consulta la referencia de la propiedad de configuración. (117580780)

Compatibilidad con la configuración del proxy de reenvío para el entorno de ejecución híbrido

El proxy de redireccionamiento de HTTP ahora es compatible con los proxies de API implementados en un entorno. Para obtener detalles, consulta Configura los proxies de reenvío. (148970527)

Compatibilidad con varios hostAliases por entorno

Se agregó una nueva propiedad de configuración, envs[].hostAliases. Esta propiedad te permite agregar varios alias de host a un entorno. Usa este elemento en lugar de hostAlias, que dejó de estar disponible. Para obtener más detalles, consulta Agrega varios alias de host a un entorno. (150738495)

Permite plantillas para conjuntos de propiedades

Se agregó un nuevo elemento <PropertySetRef> al elemento <AssignVariable> de la política <AssignMessage>. <PropertySetRef> te permite crear un par de clave/nombre de conjunto de propiedades de forma dinámica. Esta característica solo está disponible para proxies de API implementados en Apigee Hybrid. Consulta AssignVariable. (148612340)

Fallas corregidas

En esta versión, se corrigieron los siguientes errores. Esta lista está dirigida principalmente a usuarios que verifican si sus tickets de asistencia se corrigieron. No está diseñada para proporcionar información detallada a todos los usuarios.

ID del problema Nombre del componente Descripción
147958049 Entorno de ejecución Se solucionó un problema de sincronización en la secuencia de inicio en tiempo de ejecución que, a veces, impedía que el sincronizador se iniciara correctamente.
149867244 Plataforma K8S El pod de apigee-cps-setup falla en la configuración multirregional.
150187652 / 149117839 Tiempo de ejecución No se pudieron usar guiones en los nombres de entorno.
149220463 Pod de MP Los proxies implementados con anterioridad debían implementarse de nuevo.
144321144 Tiempo de ejecución No se pudieron volver a cargar los proxies con hosts virtuales seguros.
147685310 Tiempo de ejecución Falló la inicialización del sincronizador debido a una falla en la recuperación del token de GCP durante la inicialización.
151115900 Tiempo de ejecución El sondeo interno periódico no ocurrió para HybridMART, lo que da como resultado resultados falsos positivos.

Errores conocidos

En la siguiente tabla, se describen los problemas conocidos de esta versión:

Problema Descripción
No disponible

Error de encabezado HTTP no válido: la entrada de Istio cambia todas las respuestas de destino entrantes al protocolo HTTP2. Debido a que el procesador de mensajes híbrido solo admite HTTP1, es posible que veas el siguiente error cuando se llama a un proxy de API:

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

Si ves este error, puedes realizar alguna de las siguientes acciones para corregir el problema:

  • Modifica el servicio de destino para omitir el encabezado de host en la respuesta.
  • Si es necesario, quita el encabezado de host con la política AssignMessage en el proxy de API.
144584813 Si creas una sesión de depuración, pero la sesión aún no tiene transacciones, la API de la lista de sesiones de depuración no incluye la sesión de esta lista. La API solo incluye sesiones en la respuesta si la sesión contiene al menos una transacción.
143659917

El parámetro de configuración de caducidad de la política PopulateCache debe configurarse como un valor explícito entre 1 y 30. Por ejemplo:

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

Resumen: Hay una latencia muy alta cuando se usa la API o la IU para obtener el estado de implementación de la organización. Esta latencia puede generar una respuesta HTTP 204 (No Content) o HTTP 400 (Bad Request).

Solución alternativa: Actualiza el navegador (o vuelve a enviar la solicitud).