4.16.01: 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 jueves 24 de marzo de 2016, lanzamos una nueva versión de Apigee Edge para la nube privada.

Desde el lanzamiento trimestral anterior de Edge for Private Cloud (4.15.07.00), los siguientes de versiones canary y se incluyen en esta Versión de función:

• Nube: 15.07.08 15.07.22, 15.08.05, Migración de Nginx, 15.09.02, 15.09.30, 16.01.20
• Nube privada: 4.15.07.01, 4.15.07.03

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.

Bajas

Nube privada 4.15.07.03

curl http:// <qpid_IP>:8083/v1/servers/self/queues

Analytics: Vista del panel de informes personalizados de varios informes (Cloud 15.09.30)

La campaña Personalizada Se implementará la función Panel de informes que proporciona una vista de hasta cuatro informes personalizados obsoleto y se quitará en una versión futura. (MGMT-2673). Todos los demás aspectos los informes seguirán disponibles.

No se puede anular la longitud del nombre de la organización en la nube privada

Ya no puedes anular la longitud del nombre de la organización de 20 caracteres configurando lo siguiente:

• APIGEE_ORG_NAME_LENGTH=25

• APIGEE_ENV_NAME_LENGTH=25

Nuevas funciones y mejoras

A continuación, se detallan las nuevas funciones y mejoras de esta versión. Además del artículo después de las mejoras, esta versión también incluye diversas funciones de usabilidad, rendimiento, seguridad y mejoras de estabilidad.

Nube privada

Se agregó compatibilidad con Red Hat, CentOS y Oracle 6.7 a 7.2.

Esta actualización agrega compatibilidad con las versiones 6.7 de Red Hat Enterprise Linux, CentOS y Oracle Linux hasta la versión 7.2.

Para obtener una lista completa de los requisitos del sistema, consulta Software y versiones compatibles.

Instalación basada en RPM

En esta versión de Edge, se usa un mecanismo de instalación basado en RPM que simplifica, en gran medida, la los procedimientos de instalación y migración.

Nuevo directorio base

Cambió la estructura de directorios para la versión Edge 4.16.01. En versiones anteriores de Edge, instalaste Edge en el directorio base:

/<install-dir>/apigee4

La ubicación de install-dir en cualquier lugar, con un valor predeterminado de /opt. Por ejemplo:

/opt/apigee4

Para la versión 4.16.01, debes instalar Edge en el siguiente directorio:

/opt/apigee

Además, ten en cuenta que apigee4 se cambió a apigee.

La ubicación de tu directorio de datos no se ve afectada. Puede estar en /opt/apigee o se puede ubicar en otro lugar.

Nuevo requisito de host virtual

La secuencia de comandos de migración de Edge controla la mayoría de las tareas necesarias para migrar un router Netty existente. a NGINX. Sin embargo, como parte de la actualización, también debes asegurarte de que todos tus hosts virtuales las definiciones incluyen un alias del host antes de migrar.

Consulte la guía de instalación de Edge, disponible en el protocolo de FTP ftp://ftp.apigee.com/, para obtener información agregar un alias de host a un host virtual existente para obtener más.

Programación con configuración

En la versión 4.16.01 de Edge, ya no se usan los archivos .properties en el directorio /<install-dir>/apigee4/conf. para configurar los componentes de Edge. A partir de la versión 4.16.01, puedes configurar los componentes de Edge con .properties, pero ahora se encuentran en el directorio:

/opt/apigee/customer/application

Para cada componente de Edge instalado en un nodo, habrá un archivo .properties en el . Si quieres configurar un componente, edita el archivo .properties correspondiente para cambiar el de una propiedad existente o agregar una propiedad y un valor nuevos. Si el archivo no existe puedes crearla.

A diferencia de las versiones anteriores de Edge, los archivos .properties para Edge 4.16.01 no contienen todos las propiedades de un componente. Uno de los cambios de esta versión es que los archivos .properties solo contienen anulaciones de valores de propiedad predeterminados.

El beneficio de esta arquitectura es que, en una migración a una versión posterior de Edge, Edge El instalador nunca reemplaza los archivos en /opt/apigee/customer/application. Que elimina la posibilidad de que Edge reemplace accidentalmente tu configuración.

Durante una migración, el instalador de Edge examina tus archivos .properties existentes y copia los cambios. los valores de propiedad predeterminados en el directorio /opt/apigee/token Por lo tanto, no debería tener que hacer ninguna edición después de la migración.

Para obtener más información, consulta la Guía de operaciones de Apigee Edge, disponible en el sitio de FTP de Apigee: ftp://ftp.apigee.com/.

Se reemplazaron las secuencias de comandos de configuración perimetrales

Se quitaron las secuencias de comandos de configuración que usabas en versiones anteriores de Edge se reemplazará por uno de los siguientes:

• Los comandos que ejecutas mediante las utilidades de Apigee, como Apigee-service, apigee-all, utilidades apigee-setup, apiee-provision o apigee-migrate.
  Por ejemplo, las secuencias de comandos all-start.sh y all-stop.sh se reemplazaron por lo siguiente: comandos:
  > /opt/apigee/apigee-service/bin/apigee-all start
  > /opt/apigee/apigee-service/bin/apigee-all stop
• Comandos que ejecutas en los componentes de Edge directamente Por ejemplo, en versiones anteriores usaste la secuencia de comandos chpasswd-openldap.sh que se usó para cambiar la contraseña de OpenLDAP. Esa secuencia de comandos tiene Se reemplazó por el siguiente comando que ejecutas en el componente de Apigee-openldap:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o Palabra clave anterior - ppalabra nueva

Consulta la Guía de operaciones de Apigee Edge, disponible en el protocolo de FTP sitio: ftp://ftp.apigee.com/, para obtener más información sobre cómo realizar la configuración con comandos.

Nuevo router perimetral

Esta versión de Edge para la nube privada incluye una nueva arquitectura de router basada en el Router Nginx. El router Nginx reemplaza al router Netty que se usó en las versiones de Edge anteriores a 4.16.01.

Los routers Nginx tienen los mismos requisitos de hardware y puerto que el router Netty, por lo que se requieren cambios en los nodos existentes.

Para obtener más información, consulta el Apéndice A: Acerca del router Nginx en la Instalación de Edge disponible en el sitio de FTP de Apigee: ftp://ftp.apigee.com/,

Se quitó el balanceador de cargas BaaS

Se quitó el balanceador de cargas interno del portal de BaaS de la API. Ahora, debes usar tu entre el portal de BaaS de la API y los tres nodos de la pila de BaaS.

Como alternativa a un balanceador de cargas, podrías usar DNS round robin. En este caso, crear una entrada de DNS con varios registros A correspondientes a las direcciones IP de la pila BaaS. Durante un DNS , el servidor DNS devuelve los valores de registro A automáticamente con un método round robin.

Nueva documentación que describe cómo agregar nodos de Cassandra y ZooKeeper, y cómo agregar datos a un centro de datos existente

El archivo ZIP de documentación en el sitio de FTP de Apigee ahora contiene “Scaling Edge for Private Nube" describir cómo agregar nodos Cassandra y ZooKeeper, y cómo agregar un centro de datos a en un centro de datos existente.

Se quitó Orgtool

orgtool podría consultar un Instalación perimetral para obtener información sobre una organización. Esa herramienta ya se quitó. Tú Ahora usen la IU de Edge o las llamadas a la API para obtener información sobre la organización.

Cómo realizar tareas en la versión 4.16.01

En la siguiente tabla, se muestra cómo realizaste las tareas de la sección 4.15.07.03 y cómo las realizas ahora en la versión 4.16.01. Para obtener más información, consulta la Guía de operaciones de Edge, disponible en el sitio de FTP de Apigee: ftp://ftp.apigee.com/.

Versión alfa de la Herramienta de supervisión y el panel

En esta versión se incluye una versión alfa de la nueva herramienta de supervisión y del panel para Edge. Esta herramienta te permite comprender el estado de varios componentes (Routers, Mensajes, procesadores, ZooKeeper, Cassandra), así como códigos de error HTTP para varias organizaciones y entornos en tu implementación. También puedes tomar una instantánea de los datos del panel y compartirlos con Apigee para ayudar a resolver incidentes de asistencia

La documentación, incluidas las instrucciones de instalación, se encuentra en el archivo ZIP de Edge Documento 4.16.01 disponible en el sitio de FTP de Apigee: ftp://ftp.apigee.com/.

Sin embargo, antes de instalar y usar el panel, debes completar el curso Acuerdo incluido en el archivo ZIP del documento, y devolverlo a Apigee por correo electrónico a orders@apigee.com

Plataforma Edge

Rediseño de la IU de administración (Cloud 15.09.30)

Se actualizó el diseño de varias páginas de la IU de administración. (MGMT-2627)

Servicios de APIs

Asistente de proxy de API rediseñado (Cloud 16.01.20)

Se rediseñó el asistente del proxy de API. Al hacer clic en "+ API Proxy" en la página Proxies de API En la IU de administración, el nuevo asistente lo guiará por el proceso de creación del proxy de API. Todas las misma configuración que el asistente de proxy de API anterior. (MGMT-1376)

Crea proxies de API con documentos de OpenAPI (Swagger) (Cloud 16.01.20)

Como parte del nuevo diseño del asistente de proxy de API, ahora puedes crear un proxy de API a partir de un OpenAPI (Swagger). En la primera página del asistente de API proxy, haga clic en Use OpenAPI cuando se selecciona Reverse Proxy, Node.js App o No Target. En el campo que aparece, ingresa la URL para tu documento de OpenAPI. Para obtener más información, consulta Compila un proxy de API simple. (MGMT-1376)

Compatibilidad con WSDL 1.2 para proxies de SOAP (Cloud 16.01.20)

Apigee Edge admite WSDL 1.2 en la creación de proxies de API para llamar a servicios de SOAP. (MGMT-2835)

Variables SSLInfo en las configuraciones de TargetEndpoint (Cloud 16.01.20)

En un TargetEndpoint del proxy de API, puedes configurar dinámicamente los detalles de SSL/TLS para que admitan los requisitos del entorno de ejecución. En el siguiente ejemplo de cómo se configuraría SSLInfo en un TargetEndpoint se puede proporcionar en el tiempo de ejecución un texto destacado de Java, una política de JavaScript o una política de asignación de mensajes. Usa las variables de mensaje que contengan los valores que deseas establecer.

<TargetEndpoint>
...
  <SSLInfo>
    <Enabled>{myvars.ssl.enabled}</Enabled>
    <ClientAuthEnabled>{myvars.ssl.client.auth.enabled}</ClientAuthEnabled>
    <KeyStore>{myvars.ssl.keystore}</KeyStore>
    <KeyAlias>{myvars.ssl.keyAlias}</KeyAlias>
    <TrustStore>{myvars.ssl.trustStore}</TrustStore>
  </SSLInfo>
...
</TargetEndpoint>

Esta función se trata en los siguientes documentos:

• Proxy de API referencia de configuración
• https://community.apigee.com/articles/21424/dynamic-sslinfo-for-targetendpoint-using-variable.html

(APIRT-1475)

Compatibilidad del algoritmo RSA_SHA256 para políticas de aserción de SAML (Cloud 16.01.20)

Las políticas de aserción de SAML ahora admiten el algoritmo RSA_SHA256 además de RSA_SHA1. (APIRT-1779)

Validación en cargas de certificados (Cloud 16/01/2020)

Para evitar la carga de certificados caducados o no válidos a almacenes de claves y almacenes de confianza, la API de Management valida los certificados en el momento de la carga. Los certificados se validan para garantizar que el tamaño del archivo no supere los 50 KB y el formato sea PEM o DER. El vencimiento del certificado también se valida. Para anular la validación de vencimiento predeterminada (no validar para el vencimiento del certificado en la carga), usa el siguiente parámetro de consulta: ?ignoreExpiryValidation=true

Para obtener más información, consulta Sube un archivo JAR a un almacén de claves y Subir un certificado a un almacén de confianza (SECENG-516) y (APIRT-2213)

Sondeo automático en la página Registros de Node.js (Cloud 16.01.20)

Cuando visualizas los registros de Node.js desde el editor de proxy, la página de registros de Node.js se se actualiza periódicamente para enumerar los nuevos registros disponibles. Haz clic en "Detener actualización automática". Para desactivar actualización automática. (MGMT-1692)

Encabezado X-Forwarded-For HTTP (Cloud 15.09.30)

Para mayor seguridad, Edge elimina la solicitud HTTP X-Forwarded-For de forma predeterminada. que puede contener una o más direcciones IP. El nuevo comportamiento predeterminado significa que la IP de cliente IP que recibió Edge será la dirección IP que recibió del último TCP de enlace, no una dirección que pudiera falsificarse para evadir la configuración política.

Para cambiar este comportamiento predeterminado y permitir que las direcciones de X-Forwarded-For se comuniquen con tu con proxies de API, debes establecer la propiedad feature.enableMultipleXForwardCheckForACL=true en tu organización.

Acceso de JavaScript a las propiedades de políticas (Cloud 15.07.08)

Cuando usas JavaScript en flujos del proxy de API, puedes acceder a las propiedades definidas en JavaScript. . Esto es particularmente útil si quieres usar variables conocidas en tu código. Por ejemplo, supongamos que tu política de JavaScript contiene la siguiente definición de propiedad:

<Properties>
    <Property name='source'>response.content</Property>
</Properties>

En tu código JavaScript, puedes acceder a la respuesta del mensaje con una referencia a la fuente propiedad de la siguiente manera:
var source = properties.get('source'); // returns: response.content
o
var source = properties.source
o
var source = properties['source']

Para obtener más información, consulta la política de JavaScript. (APIRT-1460)

Auditorías a nivel de la organización (Cloud 15.07.08)

Los administradores de la organización pueden auditar el historial de acciones realizadas a nivel de la organización. En la IU de administración, selecciona Administrador > Historial de la organización. Para ver más consulta Auditorías: API, Producto y historial de la organización. (MGMT-2232)

Eliminación automática del rol del administrador de la organización (Cloud 15.07.08)

Los administradores de la organización pueden quitarse a sí mismos del rol de administrador de la organización en la IU de administración en Administrador > Usuarios de la organización y haz clic en Quitar junto al nombre. (MGMT-934)

Indicador de progreso de la importación de paquetes del proxy de API (Cloud 15.07.08)

Cuando se sube un paquete grande de proxy de API a la IU de administración, el estado la animación está para indicar que la importación aún está en curso, lo que te impide interactuar con el de administración de configuraciones hasta que se complete la importación. (MGMT-1285)

Comportamiento y configuración de la caché (Cloud 15.07.22)

Para una mejor administración y uso de la caché en la memoria, la columna "Cantidad máxima de elementos en la memoria" de los recursos de caché del entorno dejó de estar disponible a partir de la versión 15.06.10 de Edge Cloud. En versión 15.07.22 de Edge Cloud, este parámetro de configuración se quitó de la IU de Crear caché en Configuración del entorno (Environment Configuration) de la IU de administración de Apigee Edge.

El total de elementos presentes en todos los recursos de caché (incluida la caché predeterminada) depende de la memoria total asignada a la caché. De forma predeterminada, la memoria total asignada a los servidores en un procesador de mensajes determinado es el 40% de la memoria total disponible. Los elementos serán se expulsa de la caché de la memoria solo cuando no hay suficiente memoria caché o cuando los elementos caducan. (MGMT-2413, APIRT-1140)

Configuración del servidor de destino en la IU de administración (Cloud 15.07.22)

Las APIs > La página Configuración del entorno en la IU de administración ahora te permite agregar, editar y borrar los servidores de destino.

Además, la página se rediseñó para que también se puedan crear, agregar y borrar en línea en lugar de ir a una página nueva. Varias propiedades de la caché, incluida la configuración Elements in Memory", ya no están disponibles en la IU, debido a que la configuración de estas propiedades ya no está cualquier efecto en el comportamiento de la caché del entorno de ejecución. (MGMT-280)

SSL con registro de mensajes en syslog (Cloud 15.07.22)

La política de registro de mensajes admite el envío de syslog a proveedores externos de administración de registros a través de SSL/TLS. Usa lo siguiente en la configuración de la política como un elemento secundario directo del elemento superior elemento:

<SSLInfo>
    <Enabled>true</Enabled>
</SSLInfo>

Para obtener más información, consulta la política de Registro de mensajes. (APIRT-942)

IU de administración (Cloud 15.07.22)

La ingeniería de Apigee realizó varias correcciones de errores pequeñas y mejoras de usabilidad en la administración. de la IU de Google.

cURL en Trace (Cloud 15.09.02)

Cuando realizas el seguimiento de una llamada de proxy de API que realiza una solicitud a un servidor de destino, puedes ver la al servidor de destino como un comando cURL. Selecciona la opción “Solicitud enviada al servidor de destino”. de este proceso, en el diagrama de Transaction Map, luego haz clic en el botón "Show Curl" en el botón "Request sent to target" servidor” en el panel Detalles de la fase. (MGMT-2589)

Enmascaramiento de datos de caracteres especiales (Cloud 15.09.02)

Cuando se usan el enmascaramiento de datos para enmascarar datos sensibles en cargas útiles JSON, los caracteres especiales como $, * y { ahora pueden enmascararse. (APIRT-1727)

Mapas de par clave-valor en la IU de administración (Cloud 15.09.30)

Ahora puedes crear y administrar mapas de par clave-valor (KVM) con alcance de entorno en la administración de Edge de la IU de Google. Los KVM con alcance de entorno contienen pares clave-valor a los que puede acceder cualquier proxy de API en un como un entorno de prueba o producción. En el menú de la IU de administración, ve a APIs > Configuración del entorno > selecciona el entorno que deseas > Mapas de par clave-valor Pestaña. Para obtener más información, consulta la sección sobre cómo crear y editar mapas de clave-valor de entorno. (MGMT-1393)

Vencimiento predeterminado de la política de CompleteCache en la IU de administración (Cloud 15.09.30)

Cuando se agrega una política CompleteCache con el editor de proxy de API, el campo <TimeoutInSec> elemento para el vencimiento de la caché se prepropaga con un valor de 3,600 segundos (1 hora). La configuración predeterminada anterior fue de 300 segundos (5 minutos). (MGMT-2622)

Servicios para desarrolladores

Rendimiento de la página del producto de la API, no se muestran apps de desarrollador (Cloud 16.01.20)

Al ver un producto de API en la IU de administración, las apps de desarrollador asociadas con ese los productos en la ficha. Para mejorar el rendimiento de la IU, la lista de apps de desarrollador no se muestra cuando editar el producto de API. (MGMT-2869)

Columna de clave en la página Apps para desarrolladores (Cloud 15.08.05)

En organizaciones con una gran cantidad de apps de desarrollador (miles), mostrar la columna Key la página Apps para desarrolladores (muestra la cantidad de claves por app) puede afectar el rendimiento de la pantalla. Para mejorar el rendimiento de visualización en esta situación, comunícate con la asistencia de Apigee para configurar lo siguiente propiedad a nivel de la organización: features.appsNoCredentialsEnabled = true. Esta quita la columna Key. Sin embargo, ten en cuenta que quitar la columna Key también quita las capacidad de búsqueda por clave y secreto del consumidor. (MGMT-2486)

Ícono giratorio de progreso de la página de detalles del desarrollador (Cloud 15.09.30)

Cuando la página Detalles del desarrollador se carga en la IU de administración, la sección Apps de la página y muestra un ícono giratorio de progreso si las apps todavía se están cargando. Esto mejora el comportamiento anterior donde la sección Apps parecía vacía mientras se cargaban las apps. (MGMT-2667)

Monetización

Editar nombres de paquetes de API (Cloud 16.01.20)

Puedes actualizar el nombre de un paquete de API en cualquier momento del ciclo de vida de la monetización, incluso cuando el paquete de la API contiene un plan de tarifas publicado. (DEVRT-2177)

Los decimales permitidos en los atributos personalizados (Cloud 16.01.20)

Cuando use una “Hoja de tarifas con atributo personalizado” plan, el atributo personalizado del mensaje El encabezado que se usa como multiplicador para la transacción ahora puede ser un valor decimal de hasta cuatro decimales. Para obtener más información sobre este tipo de plan, consulta Especificar detalles del atributo personalizado de la hoja de tarifas (DEVRT-2191).

ID y nombre del plan de tarifas en los informes de resumen (Cloud 15.09.02)

Cuando generes un informe de ingresos de resumen con la API de Management, puedes agregar “Plan de tarifas”. nombre y califica "ID del plan" al informe. Para hacerlo, agrega “RATEPLAN” como un atributo groupBy la llamada a la API, como se describe en informes. Ten en cuenta que esta función aún no está disponible en la IU del informe de monetización. En los informes de detalles, las columnas con el nombre del plan de tarifas y los ID existentes ahora se encuentran cerca de la parte delantera de la junto con las demás columnas de agrupación. (DEVRT-1740)

Servicios de estadísticas

Función sum( ) en las métricas de tiempo de respuesta (Cloud 16.01.20)

En los informes personalizados de Analytics y las llamadas a la API, la “suma” la función de agregación ahora está disponible para Tiempo de respuesta objetivo, Tiempo de respuesta total y end_point_response_time. Por ejemplo, en la API de /stats (http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0), puedes usar el siguiente comando parámetro de consulta: ?select=sum(total_response_time). (AXAPP-2006)

Informe de análisis de latencia: nombres de proxy de API ordenados (Cloud 16.01.20)

En la IU del informe Análisis de latencia (solo para planes empresariales de Apigee Edge), los proxies de API se en orden alfabético en la lista desplegable Proxy. (MGMT-2858)

Apps de desarrolladores en el panel que se muestran por nombre visible (Cloud 16/01/2020)

En el panel de IU de administración, el gráfico de barras de Apps para desarrolladores muestra las apps de los desarrolladores por pantalla en lugar de un nombre interno. (MGMT-2853)

Nuevo widget de fecha/hora en los informes personalizados (Cloud, 16/01/2020)

Se mejoró el widget del selector de fecha y hora en una página de informes personalizados en la IU de administración. (MGMT-2881)

Desglose de ciudades en GeoMap (Cloud 15.07.22)

El GeoMap de estadísticas incluye una "Ciudad" para Estados Unidos y Canadá. Cuando si haces clic en un estado o una provincia en el mapa, aparece una lista de las ciudades donde se originaron las llamadas. (MGMT-2282)

| (barra vertical) y caracteres = en los informes personalizados de Analytics (Cloud 15.09.02)

Las definiciones de informes personalizados de Analytics admiten el uso de | (barra vertical) y =. Antes de esto, Se debían usar las codificaciones %7C y %3D para esos símbolos. (MGMT-2504)

Dimensión del sufijo de la ruta de acceso del proxy (Cloud 15.09.30)

Hay una nueva dimensión Sufijo de ruta de proxy (proxy_pathsuffix) disponible en los informes personalizados de Analytics y llamadas a la API. El sufijo de la ruta de acceso del proxy es la parte de una URL del proxy de API que aparece después de la ruta base. como la ruta creada para flujos condicionales. (AXAPP-1902)

Los informes muestran IDs de desarrolladores que no son nombres visibles (Cloud 15.09.30)

Cuando se hacen llamadas a la API de Edge Analytics con la API /stats que devuelve los desarrolladores, el el nombre visible del desarrollador se muestra junto con el ID del desarrollador. Anteriormente, solo el ID de desarrollador era que se devuelven. (AXAPP-1759)

Fallas corregidas

En esta versión, se corrigieron los siguientes errores.

Nube privada 4.16.01

En la siguiente tabla, se enumeran los errores corregidos desde la versión 4.16.01 de Edge para la nube privada. Para obtener estas correcciones, sigue las instrucciones para actualizar la instalación 4.16.01 a la versión más reciente RPM y archivos de asistencia como se describe en Actualiza Apigee Edge Versión 4.16.01.x a la versión 4.16.01 más reciente

Cloud 16/01/20

Cloud 15.07.08

Cloud 15.07.22

Cloud 15.08.05

Cloud 15.09.02

Cloud 15.09.30

Nube privada 4.15.07.03

Nube privada 4.15.07.01

Problemas conocidos

Esta versión tiene los siguientes problemas conocidos.

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