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

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

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

Desde la versión anterior de la función de Edge para la nube privada (4.16.01), se produjeron las siguientes versiones que se incluyen en esta:

Consulta Información sobre la numeración de versiones para saber cómo averiguar si se incluye una versión específica de la nube en tu versión de Edge para nube privada.

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 contiene varias mejoras de usabilidad, rendimiento, seguridad y estabilidad.

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

Las Guías de instalación y operaciones están disponibles en línea

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

La versión incluye 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 OpenJDK 8 o Oracle JDK 1.8 en tu entorno.
    Como parte de la actualización a Java 8, algunos algoritmos de cifrado de TLS ya no están disponibles en Oracle JDK 1.8. Para obtener la lista completa, consulta la sección "Conjuntos de algoritmos de cifrado inhabilitados de forma predeterminada" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13: Se actualizó desde Cassandra 2.0.15.

Instalación, actualización y reversión

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

  • Proceso nuevo para actualizar desde la versión 4.16.01: Esta versión reemplaza la utilidad apigee-migrate por la utilidad update.sh para actualizar la instalación de la versión 4.16.01 a la 4.16.05. Consulta Actualiza Apigee Edge 4.16.01 a la versión 4.16.05.
  • Inicio
    • bootstrap.sh (la versión 4.16.01) ahora es bootstrap_4.16.05.sh en 4.16.05.
    • Ya no es necesario especificar uname:pword para descargar bootstrap_4.16.05.sh.
  • Rollback: Para revertir una actualización a 4.16.05, desinstala la versión 4.16.05 del componente y vuelve a instalar 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 de 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, escribe el registro en el directorio /tmp. Si el usuario no tiene acceso a /tmp, falla la utilidad.
  • Procedimiento de actualización de BaaS de API: En la versión 4.16.01, tuviste que reinstalar la BaaS de API para migrarla. La nueva utilidad update.sh admite la actualización de los BaaS de API. Consulta Actualiza Apigee Edge 4.16.01 a la versión 4.16.05.

Administration

Estas son nuevas funciones para la administración y configuración de nubes privadas.

  • Validación de la instalación: La utilidad apigee-validate que se usa para probar la instalación de la nube privada perimetral ahora se puede ejecutar desde el servidor de administración. Anteriormente, la secuencia de comandos debía ejecutarse en Message Processor. Consulta Cómo probar la instalación.
  • Nombre de la región: La región puede ser cualquier nombre. En versiones anteriores, el nombre tenía el formato "dc-#", en el que # era un valor de número entero.
  • Pods de puerta de enlace: Los pods de puerta de enlace pueden tener cualquier nombre. En las versiones anteriores, el Pod tenía que llamarse “puerta de enlace”.
  • 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 mediante llamadas a la API de Edge Management. Consulta Usa la utilidad apigee-adminapi.sh.
  • Configuración silenciosa de SSL del host virtual: Ahora, cuando creas una organización o un entorno, puedes pasar propiedades para configurar SSL en un host virtual. Consulta Cómo integrar una organización.

Servicios de APIs

A continuación, se presentan nuevas funciones para los servicios de la API de Edge, que se entregaron 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 Registro de mensajes tiene un nuevo elemento <FormatMessage> en la configuración Syslog. Cuando se configura <FormatMessage>true</FormatMessage>, los mensajes 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 la API. Por ejemplo, una ruta base de /team/*/members permite a los clientes llamar a tu proxy con https://[host]/team/blue/members o https://[host]/team/green/members sin que tengas que crear un proxy nuevo para brindar asistencia a los equipos nuevos. Ten en cuenta que no se permite usar /**/. (MGMT-3154)

Encadenamiento de proxy de API (Cloud 16.03.02, IU de Cloud 16.03.09)

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

Los nuevos elementos LocalTargetConnection están disponibles en TargetEndpoint de un proxy de API, lo que te permite especificar un nombre de 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 proxy también está disponible en las políticas de textos destacados de servicio.

Para obtener más información, consulta Cómo encadenar 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 es principalmente para los usuarios que comprueban si se corrigieron sus tickets de asistencia. No está diseñado para proporcionar información detallada a todos los usuarios.

Edge para la nube privada 4.16.05

ID del problema Descripción
PRC-770 El instalador 16.01 no registra el servidor en espera de Postgres en axgroup
PRC-758 Los usuarios con el rol Usuario pueden editar informes personalizados
PRC-883 La actualización en el servidor de Postgres con la configuración de instancia principal en espera falla.

Cloud: 16.03.30

ID del problema Descripción
SECENG-584 La verificación de validación para un salto de línea entre los certificados de una cadena de certificados genera problemas con algunos certificados en producción
MGMT-3217 Las llamadas a la API de Management fallan si el nombre de KVMap termina en "claves"
MGMT-3214 Pueden ocurrir conflictos de clases durante JavaHighlights que provocan que falle el código Java de un cliente.
MGMT-3185 Se produjo un error cuando se agregaban administradores de una organización a una organización
EDGEUI-127 No tienes permisos suficientes con el nuevo editor de proxy
EDGEUI-119 Problema de tiempo de espera de la sesión de la IU
CORESERV-671 Aparece el error “No hay anillos configurados; no se puede inicializar el servicio de cps”
AXAPP-2345 Problema en la ficha de informes personalizados de AX para clientes que no son CPM
AXAPP-2302 El resumen diario de estadísticas de Apigee no muestra ningún valor 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 solicitudes de oferta de JavaScript especifican números de línea incorrectos
APIRT-2508 Error de salida cuando se llama a la escucha exprés en una devolución de llamada de Vault
APIRT-2336 Problema de gzip con Node.js
APIRT-1975 Los parámetros de configuración de la máscara no funcionan para el contenido de message.content

IU de Cloud 16.03.16

ID del problema Descripción
MGMT-3142 No se cargan los gráficos en el panel de análisis de errores (corrección actualizada)

IU de Cloud 16.03.09

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

Cloud 16.03.02

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

Cloud 16.02.17

ID del problema Descripción
MGMT-3083 La actualización automática de registros de Node.js tiene mensajes de registro demasiado detallados
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 A la función del usuario personalizada le falta el permiso "obtener" para las apps de desarrollador

Errores conocidos

Esta versión tiene los siguientes problemas conocidos.

ID del problema Descripción
APIRT-2978

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

Si el router perimetral no inicia Nginx o no se inicia, 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 router:

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

Message Processor realiza la búsqueda de DNS en IPv4 e IPv6

Si instalaste y habilitaste NSCD (Daemon de caché de servicio de nombres), es posible que notes que Message Processor realiza dos búsquedas de DNS: una para IPv4 y otra para IPv6.

Para inhabilitar la búsqueda de DNS en IPv6, sigue estos pasos:

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

    hosts enable-cache no
PRC-1118

Error cuando se ejecuta 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 establece la siguiente propiedad en “apigee”:

POSTGRES_USER=apigee

DOC-1687 Debido a un conflicto de dependencia de paquetes conocido, el agente de Katello que se usa en el servidor satelital 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 de asignación de mensajes, texto destacado de Java y generación de errores

Las políticas de asignación de mensaje, texto destacado de Java y generación de errores te permiten generar contenido de mensajes mediante el elemento <Set><Payload>. Como parte de esos mensajes, puedes incluir variables cuyos valores se propaguen de forma automática en el entorno de ejecución. Por ejemplo, si deseas mostrar la fecha a partir del encabezado HTTP, puedes insertar {message.header.date} en tu mensaje.

Si el formato del mensaje es JSON, debería verse de la siguiente manera:

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

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

  • Reemplaza la llave de apertura con una barra inversa:
    \{"The date is: " : "{message.header.date}"}
    
  • En la configuración del elemento de carga útil, 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 el próximo lanzamiento de funciones de Edge para la nube privada, podrás usar llaves para las variables en mensajes JSON sin problemas. (APIRT-1160).

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

Si el router perimetral no inicia Nginx o no se inicia, 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 router:

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