4.19.01 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

En esta sección, se describe la versión 4.19.01 de Edge para la actualización de funciones de la nube privada.

Resumen de la versión

En la siguiente tabla, se resumen los cambios de esta versión:

Nuevas funciones

Esta versión incluye las siguientes funciones nuevas:

○ Lanzamiento de disponibilidad general (GA) de la IU de Edge
○ Versión de disponibilidad general (GA) de monetización en la IU de Edge
apigee-monit agrega servicios de supervisión y reparación automática
○ La IU de Edge tiene nuevas propiedades de configuración de TLS
○ Ahora puedes crear, editar y borrar hosts virtuales en la IU de Edge
○ Se agregó compatibilidad con OpenAPI v3 para Oracle
Oracle Cent Enterprise Linux (RHEL)

Para obtener más información sobre cada una de estas funciones nuevas, consulta Funciones nuevas.

Lanzamientos incluidos

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

○ Edge:
   18.06.08
   18.06.06
   18.05.21
   18.05.10
   18.05.09
{/ 18.04.23.00
○ Portal:
   18.11.28.00
   18.10.17.00
   18.10.09.00
   18.07.16.00
Jubilaciones Ninguna
Bajas La versión 4.17.09 de Apigee Edge para nube privada ya no es compatible (está obsoleto).

Para obtener más información, consulta Bajas, retiros y cambios de CPS de Apigee.

Correcciones de errores

Esta versión incluye las siguientes correcciones de errores:

5









Para obtener más información sobre cada una de estas correcciones, consulta Correcciones de errores.

Errores conocidos

Esta versión incluye los siguientes problemas conocidos:

○ 30









apigee-monitHEAD

Para obtener más información sobre cada uno de estos problemas conocidos, incluidas las soluciones alternativas, consulta Problemas conocidos.

Actualiza las rutas

En la siguiente tabla, se muestran las rutas de actualización para esta versión:

Desde el 18/4/05 Actualiza directamente de 4.18.05 → 4.19.01.
Desde el 18/4/01 Actualiza directamente de 4.18.01 → 4.19.01.
Desde el 17/04/09 Actualiza directamente de 4.17.09 → 4.19.01.
Desde el 17/4/05 Actualiza de 4.17.05 → 4.18.01 y, luego, actualiza de 4.18.01 → 4.19.01.
Desde el 17/4/01 Actualiza de 4.17.01 → 4.18.01 y, luego, actualiza de 4.18.01 → 4.19.01.
Desde el 16/04/09 Actualiza de 4.16.09 → 4.18.01 y, luego, actualiza de 4.18.01 → 4.19.01.
Desde el 16/4/05 Actualiza de 4.16.05 → 4.18.01 y, luego, actualiza de 4.18.01 → 4.19.01.
Desde el 16/4/01 Actualiza de 4.16.01 → 4.18.01 y, luego, actualiza de 4.18.01 → 4.19.01.
Desde 4.15.0x Actualiza de 4.15.0x a 4.16.01 y, luego, de Actualización de 4.16.01 a 4.18.01. Luego, actualiza de 4.18.01 → 4.19.01.

Funciones nuevas

En esta sección, se enumeran las nuevas funciones de esta versión. Además, esta versión incluye todas las funciones de la IU de Edge, la administración de Edge y las versiones del portal que se enumeran en las versiones incluidas.

Además de las siguientes mejoras, esta versión también contiene varias mejoras de usabilidad, rendimiento, seguridad y estabilidad.

Versión de disponibilidad general (DG) de la IU de Edge

La IU de Apigee Edge es nuestro servicio de IU de administración más reciente. Anteriormente, estaba en versión beta. Con Apigee Edge para nube privada v4.19.01, la IU de Edge forma parte de la actualización general.

Para usar la IU de Edge, debes habilitar SAML y, luego, instalar la IU de Edge en su propio nodo.

Para obtener más información, consulta La IU perimetral para la nube privada.

Lanzamiento de disponibilidad general (DG) de la monetización en la IU de Edge

Ya está disponible la versión de DG de la monetización en la nueva IU de la experiencia perimetral.

Ahora puedes administrar todas las tareas de monetización de Apigee Edge para la nube privada en la IU de la nueva experiencia de Edge, incluidas las siguientes:

Con este anuncio, los informes de variación de monetización dejaron de estar disponibles oficialmente. Consulta las bajas de Apigee.

apigee-monit agrega servicios de supervisión y reparación automática

Apigee Edge para nube privada ahora incluye apigee-monit, una herramienta basada en la utilidad monit de código abierto. apigee-monit sondea de forma periódica los servicios perimetrales. Si un servicio no está disponible, entonces apigee-monit intenta reiniciarlo.

Para obtener información sobre la instalación, configuración y uso de apigee-monit, consulta Corrección automática con apigee-monit.

Nuevas propiedades de configuración de TLS

La IU de Edge admite nuevas propiedades de configuración de TLS que puedes usar para establecer lo siguiente:

  • Protocolo TLS predeterminado
  • Lista de protocolos TLS compatibles
  • Algoritmos TLS compatibles
  • Algoritmos de cifrado TLS admitidos

Para obtener más información, consulta Configura propiedades de TLS opcionales.

Crear, editar y borrar hosts virtuales en la IU de Edge

Se amplió la funcionalidad de autoservicio para que ahora puedas crear, editar y borrar hosts virtuales en un navegador (solo con la IU de Edge).

Para obtener más información, consulta Crea un host virtual mediante un navegador.

Se agregó compatibilidad con OpenAPI v3

En esta versión, se agregó compatibilidad para crear un proxy a través de la versión 3 de OpenAPI (solo la IU de Edge).

Software compatible

Esta versión incluye los siguientes cambios en el software compatible:

Se agregó compatibilidad Ya no se admite

Esta versión agrega compatibilidad con las siguientes plataformas:

  • Red Hat Enterprise Linux (RHEL) 7.6
  • CentOS 7.6
  • Oracle Linux 7.6

Las siguientes plataformas ya no son compatibles con esta versión:

  • RHEL/CentOS/Oracle versión 7.3
  • RHEL/CentOS versión 6.8
  • Oracle Linux 6.7

Para obtener una lista completa de las plataformas compatibles, consulta Software y versiones compatibles.

Correcciones de errores

En esta sección, se enumeran los errores de la nube privada que se corrigieron en esta versión. Además, esta versión incluye todas las correcciones de errores de la IU de Edge, Edge Management y las versiones del portal que se muestran en las Versiones incluidas.

ID del problema Descripción
122694069

La secuencia de comandos de copia de seguridad no detuvo Zookeeper

La secuencia de comandos de copia de seguridad no detuvo el proceso de Zookeeper antes de esta corrección.
120993451

No se agregó la página de destino “No se agregó ninguna organización”

Ya no se envía a los desarrolladores que acceden con un usuario que no tiene organizaciones asociadas a una página que no existe. Se agregó una nueva página de destino para estos usuarios.
120682369

Cómo borrar informes personalizados

Los usuarios no pudieron borrar los informes personalizados en la nueva experiencia de Edge.
120681592

Pestaña Mapa geográfico en la nueva experiencia de Edge

Cuando los usuarios navegaron a la pestaña Mapa geográfico en la nueva experiencia de Edge, la nueva experiencia de Edge mostró un error.
120624977

Opciones de JVM de Zookeeper

La configuración de opciones de JVM mediante código con configuración para Zookeeper no funcionaba.
80187407

Se produjeron errores no definidos en el cuadro de información

Cuando un gráfico tenía una sola serie temporal, la información sobre la herramienta generaba errores no definidos.
79949124

Crea proxies inversos a través de OpenAPI.

El botón Usar OpenAPI no funcionaba cuando se creaban proxies.
77515655

Cómo restablecer contraseñas sin enviar vínculos

Los usuarios no recibían correos electrónicos cuando solicitaban un vínculo para restablecer sus contraseñas.
72799769

Encabezados incorrectos para los vínculos para restablecer la contraseña

Incluso después de que un usuario estableció la propiedad trustxforwarded en true, los encabezados de la solicitud resultantes no usaban HTTPS.
69550284

Usa WSDL para crear proxies de API

La generación del proxy de API fallaba cuando se usaban los WSDL.

Errores conocidos

En la siguiente tabla, se enumeran los problemas conocidos de esta versión:

ID del problema Descripción
135616498

Formato de archivo de metadatos para la instalación de Apigee-sso

Cuando instalas apigee-sso y usas un archivo metadata.xml en lugar de una URL, si el archivo metadata.xml no incluye una línea nueva (CRLF) al final del archivo, no se lee por completo.

Solución alternativa:

Para solucionar este problema, puedes realizar una de las siguientes acciones:

  • Agregar un CRLF al final del archivo metadata.xml

    O

  • Usa una ubicación basada en URL para los metadatos
122370980

apigee-monit no es compatible con Amazon Linux 1

Solución alternativa:

Ningún contenido de este tipo
121095148

La copia de seguridad del procesador de mensajes no realiza una copia de seguridad del conjunto de archivos correcto

Solución alternativa:

Vuelve a ejecutar la copia de seguridad para que se cree una copia del conjunto de archivos correcto.

115278838

No se invalidaron los tokens de sesión

Los tokens de sesión no se invalidan en el servidor cuando el usuario hace clic en el botón Salir de Apigee Edge.

Solución alternativa:

Usa la nueva experiencia perimetral con SAML.

113342838

Las operaciones de Cassandra no funcionan cuando se habilita la autenticación de JMX

Solución alternativa:

Agrega tu nombre de usuario y contraseña cada vez que invoques el comando nodetool.

79993247

Las solicitudes HEAD a los destinos de Node.js se interrumpen

Las solicitudes HEAD a un destino de Node.js pueden bloquearse, lo que deja las conexiones pendientes.

Solución alternativa:

Para solucionar este problema, define un controlador para que las solicitudes HEAD muestren de manera explícita una respuesta vacía.

79757554

No se resuelven los nombres de host

Después de instalar o actualizar Edge para la nube privada, es posible que los nombres de host no se resuelvan a sus direcciones.

Solución alternativa:

Para resolver este problema, reinicia el componente de IU de Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
76087166

DataAccessException en varias configuraciones de centros de datos

Cuando hay varias configuraciones de centros de datos, si un almacén de datos deja de estar disponible, es posible que veas el siguiente error:

DataAccessException: Error while accessing datastore;
Please retry later

El resultado es que es posible que el servidor de administración no se inicie porque está intentando conectarse a los nodos de Cassandra en dc-1 y dc-2. DataAccessExceptions se produce si un nodo de Cassandra no funciona. Esto también puede provocar la interrupción del tráfico de la API, en la que Message Processor informa DataAccessExceptions mientras intenta recuperar los KVM.

Ten en cuenta que el estado esperado es que el servidor de administración no se conecte a los componentes del almacén de datos en las regiones.

Solución alternativa

La solución alternativa es anular el registro de los siguientes tipos de nodos de Cassandra en el centro de datos no disponible y volver a registrarlos después de que los nodos de Cassandra vuelvan a estar disponibles:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

Para anular el registro de estos tipos de nodos de Cassandra y volver a registrarlos, sigue estos pasos:

  1. Obtén los UUID de los nodos de Cassandra mediante el siguiente comando curl:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Aquí:

    • ADMIN_EMAIL y ADMIN_PW son las credenciales de tu cuenta de Apigee.
    • MS_IP y MS_PORT son la dirección IP y el número de puerto del servidor de administración.
    • REGION es el nombre del centro de datos en el que se encuentra el servidor de administración.
    • GATEWAY_POD es el nombre del Pod, que es "puerta de enlace" de forma predeterminada. Sin embargo, es posible que hayas cambiado el nombre por otro, así que verifica tu implementación.
    • CASSANDRA_NODE_TYPE es uno de kms-datastore, dc-datastore y keyvaluemap-datastore.

    Por ejemplo:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"
    .

    La respuesta usa el siguiente formato:

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    Por ejemplo:

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }
    .

    Anota los valores del campo uUID en la respuesta. Las usarás para anular el registro de los nodos.

  2. Repite el paso uno para cada tipo de nodo de Cassandra: kms-datastore, dc-datastore y keyvaluemap-datastore. Asegúrate de tomar nota de los UUID que se muestran.
  3. Anula el registro de los nodos con el siguiente comando:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    En el ejemplo anterior, UUID es el UUID que se muestra en la respuesta del comando anterior.

  4. Repite el paso 3 para cada UUID que recopilaste en los pasos 1 y 2.
  5. Vuelve a registrar los nodos con el siguiente comando:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

Ten en cuenta que estas operaciones registran y cancelan los nodos de Zookeeper y no tienen ningún impacto en el clúster de Cassandra. Para obtener más información sobre estos comandos, consulta Actualiza registros del almacén de datos.

68722102

Política de MessageLogging, incluida información adicional en el mensaje de registro

El elemento FormatMessage de la política MessageLogging controla el formato del mensaje registrado. Cuando es FormatMessage=false, el mensaje registrado no debe incluir información generada por Apigee. Sin embargo, incluso si configuras FormatMessage=false, el mensaje de registro incluirá la siguiente información:

  • Puntuación prioritaria
  • La marca de tiempo

Solución alternativa:

Ningún contenido de este tipo
65737520

No se puede restablecer la contraseña de administrador del sistema

Fallará el restablecimiento de la contraseña de administrador del sistema para el servidor de administración que contiene caracteres especiales.

Solución alternativa:

Define la contraseña en un archivo de datos que luego pasarás al extremo /users en la API de Management. Para obtener más información, consulta Cómo restablecer la contraseña de administrador del sistema.

Próximo paso

Si deseas comenzar a usar Edge para la nube privada 4.19.01, usa los siguientes vínculos:

Nuevas instalaciones:
Nueva descripción general de la instalación
Instalaciones existentes:
Rutas de actualización