1.1.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 27 de enero de 2020, Google lanzó la versión 1.1.0 del entorno de ejecución híbrido de Apigee. En esta sección, se describen las funciones nuevas y los cambios de la versión 1.1.0.

Actualizándose

No puedes actualizar de 1.0.0 a 1.1.0, ya que la versión nueva no es compatible con la versión 1.0.0. La versión 1.1.0 requiere una instalación nueva.

Nuevas funciones y mejoras

Apigee Connect (versión Alfa)

Apigee Connect versión Alfa permite que el servicio de MART híbrido de Apigee se conecte al plano de administración sin necesidad de exponer el extremo de MART. Si usas Apigee Connect, no necesitas configurar la puerta de enlace de entrada de MART con un alias de host y un certificado DNS autorizado. Para obtener más detalles, comunícate con tu representante de Apigee.

Enrutamiento de la ruta base

El enrutamiento de la ruta base te permite configurar y administrar la forma en que Apigee Hybrid enruta las llamadas del proxy de API a los entornos específicos. Para obtener detalles, consulta Configura el enrutamiento de la ruta base.

Cambios

Se realizaron los siguientes cambios para la versión 1.1.0 del entorno de ejecución híbrido. Algunos de estos cambios, como se señala, no son incompatibles con la versión 1.0.0.

  • La CLI apigeectl ahora instala Istio en el espacio de nombres istio-system. Este es el espacio de nombres predeterminado para Istio. Este cambio no es compatible con la versión híbrida 1.0.0.
  • La CLI apigeectl ahora instala CertManager en el espacio de nombres cert-manager. Este cambio no es compatible con la versión híbrida 1.0.0.
  • La versión compatible de Istio implementada con el entorno de ejecución de Apigee Hybrid se migró a la 1.4.2 porque la versión 1.2.x ya no es compatible.

Fallas corregidas

Se corrigieron los siguientes problemas enumerados en las notas de la versión de Apigee Hybrid 1.0.0:

Problema Descripción
144886537 El enrutamiento de la ruta base no funciona con Apigee Hybrid v1.0.0. Cuando las anulaciones están configuradas para enrutarse a entornos diferentes con el mismo hostAlias, la entrada no se enruta al entorno en función de la ruta.
143774187 La IU híbrida muestra la etiqueta “Empresa” en la vista de apps.

Errores conocidos

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

Problema Descripción
No disponible No puedes usar un “*” para la propiedad hostAlias de las configuraciones mart y envs. La práctica recomendada es usar un nombre de host específico para la configuración mart.
No disponible La configuración de las variables HTTP_PROXY, HTTPS_PROXY y NO_PROXY no es compatible con la versión Alfa de Apigee Connect.
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.
144436206 En la vista Rendimiento de la caché, el cálculo de la tasa de aciertos de caché es incorrecto.
144321491 Los registros de Apigee Hybrid incluyen notificaciones de “Creación de la caché faltante” que indican una posible degradación del rendimiento. Se esperan estos mensajes y se pueden ignorar.
144321144 No se pueden volver a cargar los proxies con hosts virtuales seguros.
144286363

La máscara de depuración en env.json no enmascara los datos de respuesta.

La siguiente API para actualizar la máscara de depuración env.json con un campo responseJSONPaths no funciona:

PATCH /v1/organizations/org/environments/env/debugmask?replaceRepeatedFields=true
{
  "responseJSONPaths": ["$.maskedDataEnv"]
}

Para solucionar este problema con el seguimiento, puedes borrar una sesión de seguimiento completa en la IU o puedes usar las API de Trace para borrar transacciones individuales dentro de una sesió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).