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 utilidadupdate.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 esbootstrap_4.16.05.sh
en 4.16.05.- Ya no es necesario especificar
uname:pword
para descargarbootstrap_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
yupdate.sh
pueden escribir el archivo de registro en/tmp
. De forma predeterminada, las utilidades desetup.sh
yupdate.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:
|
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
yvariableSuffix
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