4.16.05: Notas de la versión de Edge para la nube privada

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

El martes 31 de mayo de 2016, lanzamos una nueva versión de Apigee Edge para la nube privada.

Desde la versión de funciones anterior de Edge para Private Cloud (4.16.01), se lanzaron las siguientes versiones, que se incluyen en esta versión de funciones:

Consulta Acerca de la numeración de versiones para comprender cómo puedes determinar si una versión específica de la nube se incluye en tu versión de Edge para Private Cloud.

Nuevas funciones y mejoras

A continuación, se indican las nuevas funciones y mejoras de esta versión. Además de las siguientes mejoras, esta versión también incluye varias mejoras de usabilidad, rendimiento, seguridad y estabilidad.

Para obtener más detalles e instrucciones, consulta la documentación de Edge para la nube privada.

Las guías de instalación y operaciones se trasladaron a Internet

Ahora puedes acceder a la guía de instalación y operaciones de Edge para la nube privada en la versión 4.18.01.

Actualizaciones de software

En esta versión, se incluyen las siguientes actualizaciones de software:

  • Java JDK 1.8: Para aprovechar las funciones más recientes de Java, esta versión es compatible con Java 1.8. Se requiere Oracle JDK 1.8 o OpenJDK 8 en tu entorno.
    Como parte de la actualización a Java 8, algunos algoritmos de cifrado TLS ya no están disponibles en Oracle JDK 1.8. Para obtener la lista completa, consulta la sección "Default Disabled Cipher Suites" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13: Se actualizó de Cassandra 2.0.15.

Instalación, actualización y reversión

A continuación, se incluye una lista de los cambios en la instalación, la actualización y las secuencias de comandos relacionadas. Para obtener información sobre el uso, consulta la documentación de Edge para la nube privada.

  • Nuevo proceso para actualizar desde la versión 4.16.01: En esta versión, se reemplaza la utilidad apigee-migrate por la utilidad update.sh para actualizar tu instalación de la versión 4.16.01 a la 4.16.05. Consulta Actualiza Apigee Edge 4.16.01 a 4.16.05.
  • Bootstrap
    • bootstrap.sh (la versión 4.16.01) ahora es bootstrap_4.16.05.sh en la versión 4.16.05.
    • Ya no es necesario que especifiques uname:pword para descargar bootstrap_4.16.05.sh.
  • Reversión: Para revertir una actualización a la versión 4.16.05, desinstala la versión 4.16.05 del componente y reinstala la versión anterior. Se quitó la utilidad rollback.sh anterior. Consulta 4.16.05 Proceso de reversión.
  • setup.sh y update.sh pueden escribir el archivo de registro en /tmp: De forma predeterminada, las utilidades setup.sh y update.sh escriben información de registro en /opt/apigee/var/log/apigee-setup. Si el usuario que ejecuta la utilidad no tiene acceso a ese directorio, se escribe el registro en el directorio /tmp. Si el usuario no tiene acceso a /tmp, la utilidad falla.
  • Procedimiento de actualización de API BaaS: En la versión 4.16.01, debías reinstalar API BaaS para migrarla. La nueva utilidad update.sh admite la actualización de la API de BaaS en su lugar. Consulta Cómo actualizar Apigee Edge 4.16.01 a 4.16.05.

Administración

A continuación, se indican las nuevas funciones para la administración y configuración de la nube privada.

  • Validación de la instalación - La utilidad apigee-validate que se usa para probar la instalación de Edge Private Cloud ahora se puede ejecutar desde el servidor de administración. Anteriormente, la secuencia de comandos debía ejecutarse en el procesador de mensajes. Consulta Prueba la instalación.
  • Nombre de la región: La región puede tener cualquier nombre. En versiones anteriores, el nombre tenía el formato "dc-#", en el que # era un valor entero.
  • Pods de puerta de enlace: Los pods de puerta de enlace pueden tener cualquier nombre. En versiones anteriores, el pod debía llamarse "gateway".
  • Administración basada en secuencias de comandos: Una nueva utilidad de línea de comandos de apigee-adminapi.sh te permite realizar las mismas tareas de configuración de Edge que realizas llamando a la API de administración de Edge. Consulta Cómo usar la utilidad apigee-adminapi.sh.
  • Configuración silenciosa de SSL de host virtual: Cuando creas una organización o un entorno, ahora puedes pasar propiedades para configurar SSL en un host virtual. Consulta Integra una organización.

Servicios de APIs

A continuación, se indican las nuevas funciones de los servicios de API de Edge, que se lanzaron en versiones anteriores del producto en la nube.

Prefijo de longitud fija para el registro de mensajes de syslog (Cloud 16.03.30)

La política de Message Logging tiene un nuevo elemento <FormatMessage> en la configuración de Syslog. Si configuras <FormatMessage>true</FormatMessage>, los mensajes de Syslog comienzan con una cantidad fija de caracteres, lo que te permite filtrar los datos insertados por Apigee. Para obtener más información, consulta la política de registro de mensajes. (APIRT-1398)

Comodín en la ruta base del proxy de API (IU de Cloud 16.03.09)

La IU de administración admite el uso de uno o más comodines /*/ en las rutas base del proxy de API. Por ejemplo, una ruta base de /team/*/members permite que los clientes llamen a tu proxy con https://[host]/team/blue/members o https://[host]/team/green/members sin que tengas que crear un proxy nuevo para admitir equipos nuevos. Ten en cuenta que no se permite /**/. (MGMT-3154)

Encadenamiento de proxies de API (IU de Cloud 16.03.02 y Cloud 16.03.09)

Edge admite el encadenamiento de proxies de API locales, lo que permite que un proxy de API llame a otro proxy de API implementado en tu organización de Edge sin sobrecarga de red adicional. Anteriormente, el encadenamiento de proxies de API requería una llamada http(s) a otro proxy de API, que reenvía la solicitud a través de un balanceador de cargas, un router y un procesador de mensajes.

Hay nuevos elementos LocalTargetConnection disponibles en el TargetEndpoint de un proxy de API, lo que te permite especificar el nombre de un proxy de API, el nombre de un ProxyEndpoint específico dentro de un proxy de API o simplemente la ruta base a un recurso de proxy de API local (como /v1/myresource). La IU del editor de proxy también proporciona estas opciones cuando agregas o actualizas un TargetEndpoint.

El encadenamiento de proxies también está disponible en las políticas de texto destacado del servicio.

Para obtener más información, consulta Encadena los proxies de API. Los nuevos elementos LocalTargetConnection también se enumeran en el esquema XML aquí: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

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.

Edge para la nube privada 4.16.05

ID del problema Description
PRC-770 El instalador de la versión 16.01 no puede registrar el servidor en espera de Postgres en axgroup
PRC-758 El usuario con el rol de usuario puede editar informes personalizados
PRC-883 La actualización del servidor de Postgres con configuración principal en espera falla

Cloud 16.03.30

ID del problema Description
SECENG-584 La verificación de validación para el salto de línea entre certificados en una cadena de certificados causa problemas con algunos certificados en producción
MGMT-3217 Las llamadas a la API de Management fallan si el nombre de KVMap termina en "keys"
MGMT-3214 Pueden producirse conflictos de clases durante las llamadas de Java, lo que provoca que falle el código Java de un cliente
MGMT-3185 Se produjo un error al agregar administradores a una organización
EDGEUI-127 No se obtienen permisos suficientes con el nuevo editor de proxy
EDGEUI-119 Problema de tiempo de espera de sesión de la IU
CORESERV-671 Aparecen errores que indican que no se configuraron tonos y que no se puede inicializar el servicio de CPS
AXAPP-2345 Problema en los informes personalizados de AX de la ficha para los clientes que no son de CPS
AXAPP-2302 El resumen diario de Apigee Analytics muestra cero en la adopción por parte de los desarrolladores
APIRT-2750 Fallas de tráfico altas en una organización específica
APIRT-2516 Los errores de tiempo de ejecución en las llamadas de JavaScript especifican números de línea incorrectos
APIRT-2508 Error de salida cuando se llama a express listen dentro de una devolución de llamada de Vault
APIRT-2336 Problema de Gzip con Node.js
APIRT-1975 Mask Configs no funciona para message.content

IU de Cloud 16.03.16

ID del problema Description
MGMT-3142 No se cargan los gráficos en el panel de Error Analysis (corrección actualizada)

IU de Cloud 16.03.09

ID del problema Description
MGMT-3158 Permisos insuficientes en la IU cuando el RBAC en proxies individuales se configura a través de la API
MGMT-3142 Los gráficos no se cargan en el panel de Error Analysis
MGMT-3118 La IU muestra una configuración incorrecta del host virtual SSL para el parámetro "clientAuthEnabled"
DEVRT-2344 Las definiciones de informes de un solo día no cargan transacciones en la IU

Cloud 16.03.02

ID del problema Description
MGMT-3083 La actualización automática de los registros de Node.js es demasiado detallada con los mensajes de registro
DEVRT-2275 Los planes de tarifas de atributos personalizados solo muestran 5 atributos en lugar de los 10 permitidos
DEVRT-1275 No todos los desarrolladores se muestran en el menú desplegable Plan de tarifas
DEVRT-1074 El desarrollador prepago con saldo cero arroja NullPointerException cuando se aplica el crédito

Cloud 16.02.17

ID del problema Description
MGMT-3083 La actualización automática de los registros de Node.js es demasiado detallada con los mensajes de registro
MGMT-3077 La IU genera un paquete de proxy no válido a partir de un WSDL que usa el espacio de nombres predeterminado
MGMT-1642 Al rol de usuario personalizado le falta el permiso "get" para las apps para desarrolladores

Problemas conocidos

Esta versión tiene los siguientes problemas conocidos.

ID del problema Description
APIRT-2978

No se pudo iniciar Nginx o el router

Si el enrutador perimetral no puede iniciar Nginx o no se inicia en absoluto, como se muestra en el archivo /opt/apigee/var/log/edge-router/logs/system.log, borra todos los archivos del directorio /opt/nginx/conf.d y reinicia el enrutador:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
APIRT-3364

Message Processor realiza búsquedas de DNS en IPv4 e IPv6

Si instalaste y habilitaste NSCD (daemon de caché del servicio de nombres), es posible que observes que los procesadores de mensajes realizan dos búsquedas de DNS: una para IPv4 y otra para IPv6.

Para inhabilitar la búsqueda de DNS en IPv6, haz lo siguiente:

  1. En cada nodo de Message Processor, edita /etc/nscd.conf.
  2. Establece la siguiente propiedad:

    enable-cache hosts no
PRC-1118

Error al ejecutar el comando "apigee-service apigee-postgresql pg-data-purge"

Si ejecutas el comando "apigee-service apigee-postgresql pg-data-purge" y ves un error con el siguiente formato:

ERROR: Debe ser propietario de la relación

Edita /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge y configura la siguiente propiedad como "apigee":

POSTGRES_USER=apigee
DOC-1687 Debido a un conflicto conocido de dependencia de paquetes, el agente de Katello que se usa en Satellite Server 6 no se instalará correctamente en los hosts de Apigee Edge que ejecutan el daemon de Qpid.

Cargas útiles de JSON en las políticas Assign Message, Java Callout y Raise Fault

Las políticas de Assign Message, Java Callout y Raise Fault te permiten generar contenido de mensajes con el elemento <Set><Payload>. Como parte de esos mensajes, puedes incluir variables cuyos valores se completan automáticamente en el tiempo de ejecución. Por ejemplo, si deseas mostrar la fecha del encabezado HTTP, puedes insertar {message.header.date} en tu mensaje.

Si el formato del mensaje es JSON, se verá de la siguiente manera:

{"The date is: " : "{message.header.date}"}

Sin embargo, puedes ver que es un JSON con formato incorrecto. Para solucionar este problema, tienes dos opciones:

  • Usa una barra invertida para escapar la llave de apertura: 
    \{"The date is: " : "{message.header.date}"}
  • En la configuración del elemento Payload, usa los atributos variablePrefix y variableSuffix para indicar una variable en una carga útil JSON. Por ejemplo:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

En la próxima versión de funciones de Edge para la nube privada, podrás usar llaves para las variables en los mensajes JSON sin problemas. (APIRT-1160)

El router no puede iniciar Nginx o el router no se inicia

Si el enrutador perimetral no puede iniciar Nginx o no se inicia en absoluto, como se muestra en el archivo /opt/apigee/var/log/edge-router/logs/system.log, borra todos los archivos del directorio /opt/nginx/conf.d y reinicia el enrutador:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Anterior
4.16.05.01
Siguiente
4/16/01.08