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

Estás viendo la documentación de Apigee Edge.
Ve a 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 Edge para funciones de nube privada (4.16.01), las siguientes actualizaciones se hayan producido y están incluidos en esta Versión de función:

Consulta Acerca de la versión. numeración para entender cómo puedes saber si una versión específica de la nube incluida en tu versión de Edge para la nube privada.

Nuevas funciones y mejoras

A continuación, se detallan las nuevas funciones y mejoras de esta versión. Además de los siguientes mejoras, esta versión también contiene diversas funciones de usabilidad, rendimiento, seguridad y estabilidad. mejoras.

Para obtener más instrucciones y detalles, consulta la documentación sobre el perímetro de la nube privada.

Instalación y Las guías de operaciones se trasladan a Internet

Ahora puedes acceder a la guía de operaciones y instalación de Edge para la instalación y las operaciones en 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, es compatible con Java 1.8. Se requiere Oracle JDK 1.8 u OpenJDK 8 en tu entorno.
    Como parte de la actualización a Java 8, algunos cifrados 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 reversión

A continuación, se incluye una lista de los cambios realizados en la instalación, actualización y secuencias de comandos relacionadas. Información en uso, consulta la documentación de Edge for Private Cloud.

  • Nuevo proceso de actualización a partir de la versión 4.16.01: Esta versión reemplaza la apigee-migrate con la utilidad update.sh para actualizar tu instalación de 4.16.01 a 4.16.05. Consulta Actualiza Apigee Edge 4.16.01 a 4.16.05.
  • Arranque
    • bootstrap.sh (la versión 4.16.01) ahora es bootstrap_4.16.05.sh en la versión 4.16.05
    • Ya no necesitas especificar uname:pword para descargar bootstrap_4.16.05.sh
  • Revertir: 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. El anterior Se quitó la utilidad rollback.sh. Consulta 4.16.05 Proceso de reversión.
  • setup.sh y update.sh pueden escribir el archivo de registro en /tmp: De forma predeterminada, setup.sh y Las utilidades update.sh escriben información de registro a /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, fallará la utilidad.
  • Procedimiento de actualización de BaaS de la API: En la versión 4.16.01, debías seguir estos pasos: reinstalará BaaS de API para migrarlo. La nueva utilidad update.sh admite actualizar los BaaS de las APIs en su lugar. Consulta Actualiza Apigee Edge 4.16.01 a 4.16.05.

Administración

A continuación, se muestran funciones nuevas 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 tu nube privada perimetral instalación ahora se pueden ejecutar desde el servidor de administración. Anteriormente, la secuencia de comandos debía ejecutarse en el Message Processor. Consulta Prueba el instalar.
  • Nombre de la región: La región puede ser cualquier nombre. En las versiones anteriores, el nombre era en el formato “dc-#”, donde # era un valor entero.
  • Pods de puerta de enlace: Los Pods de puerta de enlace pueden tener cualquier nombre. En versiones anteriores, el Pod tenía que llamarse “gateway”.
  • Administración basada en secuencias de comandos: A la nueva utilidad de línea de comandos apigee-adminapi.sh te permite realizar el mismo Tareas de configuración perimetral que realizas con llamadas a la API de Edge Management. Consulta El uso de apigee-adminapi.sh.
  • Configuración silenciosa de SSL de host virtual: Cuando se crea una organización o puedes pasar propiedades para configurar SSL en un host virtual. Consulta Integra una organización.

Servicios de APIs

A continuación, se muestran funciones nuevas para los servicios de las APIs de Edge, que se entregaron en la nube anterior diferentes del producto.

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

La política de registro de mensajes tiene un nuevo elemento <FormatMessage> en la configuración de Syslog. De Configurando <FormatMessage>true</FormatMessage>, mensajes Syslog comienzan con una cantidad fija de caracteres, lo que te permite filtrar los datos insertados por Apigee. Para ver más información, consulta Message Política de registro. (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 el proxy de API rutas básicas. Por ejemplo, una ruta base de /team/*/members permite a los clientes llamar tu proxy con https://[host]/team/blue/members o https://[host]/team/green/members sin tener que crear un nuevo proxy para a los nuevos equipos. Ten en cuenta que no se permite usar /**/. (MGMT-3154)

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

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

Hay nuevos elementos LocalTargetConnection disponibles en un proxy de API TargetEndpoint, que permite especificar un nombre de proxy de API, el nombre de un ProxyEndpoint específico dentro de un proxy de API o, simplemente, en la ruta base a un recurso de proxy de API local (como /v1/mirecurso). 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 Texto destacado del servicio.

Para obtener más información, consulta Cómo encadenar proxies de API de aprendizaje automático. Los nuevos elementos LocalTargetConnection también se enumeran en el archivo XML. Esquema 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 para ver si se corrigieron sus tickets de asistencia. No está diseñado para proporcionar imágenes información para 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 grupo hax
PRC-758 El usuario con rol de usuario puede editar informes personalizados
PRC-883 La actualización en el servidor de Postgres con la configuración de espera de instancia principal es con errores

Cloud 16.03.30

ID del problema Descripción
SECENG-584 La verificación de validación de una línea nueva 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 “claves”
MGMT-3214 Se pueden producir conflictos de clases durante JavaTextos destacados que causan que el código Java de un cliente desaprobado
MGMT-3185 Se produjo un error cuando se agregaban administradores de la organización a una organización
EDGEUI-127 Se obtienen permisos insuficientes con el nuevo editor de proxy
EDGEUI-119 Problema de tiempo de espera de la sesión de la IU
CORESERV-671 Aparece el mensaje "No se configuraron anillos; No se puede inicializar el servicio cps" errores
AXAPP-2345 Problema al enumerar los informes personalizados de AX para clientes que no son de CPA
AXAPP-2302 El resumen diario de Analytics de Apigee muestra que cero en la sección de desarrolladores adopción
APIRT-2750 Fallas de tráfico altas en una organización específica
APIRT-2516 Los errores de tiempo de ejecución en los textos destacados de JavaScript especifican una línea incorrecta números
APIRT-2508 Error de salida cuando se llama a Express Listen 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 máscaras no funcionan para message.content

IU de Cloud 16.03.16

ID del problema Descripción
MGMT-3142 Los gráficos no se cargan 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 los proxies individuales se configura a través de la API
MGMT-3142 Los gráficos no se cargan en el panel de Análisis de errores
MGMT-3118 La IU muestra una configuración de host virtual SSL incorrecta para “clientAuthEnabled” parámetro
DEVRT-2344 Las definiciones de 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 es demasiado detallada y contiene mensajes de registro
DEVRT-2275 Los planes de tarifas de atributos personalizados muestran solo 5 atributos en lugar de 10 se permite
DEVRT-1275 No todos los desarrolladores aparecen en el menú desplegable Plan de tarifas.
DEVRT-1074 El desarrollador prepagado con saldo cero arroja una excepción NullpointerException cuando el crédito es aplicado

Cloud 16.02.17

ID del problema Descripción
MGMT-3083 La actualización automática de registros de Node.js es demasiado detallada y contiene 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
MGMT-1642 Al rol del usuario personalizado le falta el comando "get" permiso para las apps de desarrolladores

Problemas conocidos

Esta versión tiene los siguientes problemas conocidos.

ID del problema Descripción
APIRT-2978

El router no inicia Nginx o no se inicia

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

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

El procesador de mensajes realiza una búsqueda de DNS en IPv4 y en IPv6

Si instalaste y habilitaste NSCD (Name Service Cache Daemon), puedes Ten en cuenta que Message Processors realiza 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 del procesador de mensajes, edita /etc/nscd.conf.
  2. Configura la siguiente propiedad:

    hosts enable-cache no
PRC-1118

Error cuando se ejecuta “apigee-service apigee-postgresql pg-data-purge”

Si ejecutas el comando “apigee-service apigee-postgresql pg-data-purge” comando y verás un error en el siguiente formato:

ERROR: debe ser el propietario de la relación

Edita /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge y configure la siguiente propiedad como “apigee”:

POSTGRES_USER=apigee

DOC-1687 Debido a un conflicto de dependencias de paquetes conocido, el agente Katello que se usa en la El servidor 6 no se instalará correctamente en hosts de Apigee Edge que ejecuten Qpid daemon.

Cargas útiles de JSON en Asigna políticas de Mensajes, Textos destacados de Java y Elevaciones de Errores

Las políticas Asignar mensaje, Texto destacado de Java y Generar errores te permiten generar mensajes contenido con el elemento <Set><Payload>. Como parte de esos mensajes, Puede incluir variables cuyos valores se propagan automáticamente en el entorno de ejecución. Por ejemplo, si quieres muestra la fecha del encabezado HTTP, puedes inserta {message.header.date} en tu mensaje.

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

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

Sin embargo, puedes ver que el formato 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 valores variablePrefix y Atributos variableSuffix para indicar una variable en una carga útil de JSON Para ejemplo:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
    

En el próximo Edge para el lanzamiento de funciones de la nube privada, podrás usar llaves para variables en mensajes JSON sin problemas. (APIRT-1160)

El router no inicia Nginx o El router no se inicia

Si el router perimetral no inicia Nginx o no se inicia, como se muestra en el documento /opt/apigee/var/log/edge-router/logs/system.log luego borra todos los archivos en el directorio /opt/nginx/conf.d y reinicia la router:

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