4.19.01 Notas de la versión de Edge para la nube privada

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

En esta sección, se describe la versión 4.19.01 de Edge para el lanzamiento de la función de 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 la disponibilidad general (DG) de la IU perimetral
○ Lanzamiento de la disponibilidad general (DG) de la monetización en la IU perimetral
apigee-monit agrega servicios de reparación automática y supervisión
○ La IU de Edge tiene nuevas propiedades de configuración de TLS
○ Ahora puedes crear, editar y borrar hosts virtuales en la IU perimetral
○ Se agregó compatibilidad con OpenAPI v3
○Ya se admite Linux
7.

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

Versiones incluidas

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

○ Edge:
   18.06.08
   18.06.06
   18.05.21
   18.05.10
   18.05.09
   18.04.2.04
○ Portal:
   18.11.28.00
   18.10.17.00
   18.10.09.00
   18.07.16.00
Jubilación Ninguna
Bajas Ya no se admite Apigee Edge para la nube privada 4.17.09 (obsoleto).

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

Correcciones de errores

Esta versión incluye las siguientes correcciones de errores:

○ No se detuvo la copia de seguridad de la secuencia de comandos









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:

1) 8









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 4.18.05 Actualización directa desde 4.18.05 → 4.19.01
Desde el 18 de abril de 2011 Actualización directa de 4.18.01 → 4.19.01
Desde el 17 de abril de 2009 Actualización directa desde 4.17.09 → 4.19.01
Desde el 17 de abril Actualiza de 4.17.05 → 4.18.01 y, luego, actualiza de 4.18.01 → 4.19.01
Desde el 1 de julio de 2011 Actualiza de 4.17.01 → 4.18.01 y, luego, actualiza de 4.18.01 → 4.19.01
Desde el 16 de abril Actualiza de 4.16.09 → 4.18.01 y, luego, actualiza de 4.18.01 → 4.19.01
Desde 4.16.05 Actualiza de 4.16.05 → 4.18.01 y, luego, actualiza de 4.18.01 → 4.19.01
Desde el 16 de abril 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 → 4.16.01 y, luego, actualiza de 4.16.01 → 4.18.01 y, luego, actualiza desde 4.18.01 → 4.19.01

Funciones nuevas

En esta sección, se enumeran las funciones nuevas de esta versión. Además, 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, también contiene varias mejoras de usabilidad, rendimiento, seguridad y estabilidad.

Lanzamiento 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 la nube privada v4.19.01, la IU de Edge forma parte de la versión general.

Para usar la IU perimetral, debes habilitar SAML y, luego, instalarla en su propio nodo.

Si deseas obtener más información, consulta La IU perimetral de la nube privada.

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

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

Ahora puedes administrar todas las tareas de monetización de Apigee Edge for Private Cloud en la IU de la experiencia de New Edge, incluidas las siguientes:

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

apigee-monit agrega servicios de autorreparación y supervisión

Apigee Edge para la nube privada ahora incluye apigee-monit, una herramienta basada en la utilidad de código abierto de código abierto. apigee-monit sondea periódicamente los servicios de Edge. Si un servicio no está disponible, 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 de TLS compatibles

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

Crea, edita y borra hosts virtuales en la IU de Edge

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

Para obtener más información, consulta Cómo crear un host virtual con 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 IU perimetral).

Software compatible

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

Se agregó compatibilidad Ya no es compatible

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, la Administración de Edge y las versiones de Portal que se muestran en las Versiones incluidas.

ID del problema Descripción
122694069

Secuencia de comandos de copia de seguridad que no detuvo a Zookeeper

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

Se agregó la página de destino "No hay organizaciones"

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

Cómo borrar informes personalizados

No se pudieron borrar los informes personalizados en la experiencia de New Edge.
120681592

Pestaña Geomap en la nueva experiencia de Edge

Cuando los usuarios navegaban a la pestaña Geomap en la experiencia de New Edge, se mostraba un error.
120624977

Opciones de JVM de Zookeeper

La configuración de opciones de JVM con Code con la configuración de Zookeeper no funcionaba.
80187407

Se produjo un error no definido en la información sobre la herramienta

Cuando un gráfico tenía solo una serie temporal, la información sobre la herramienta arrojaba errores indefinidos.
79949124

Crea proxies inversos a través de OpenAPI

El botón Usar OpenAPI cuando se creaban proxies no funcionaba.
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 restablecer vínculos de contraseña

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

Usa WSDL para crear proxies de API

La generación del proxy de API fallaba cuando se usaban 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

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

Solución alternativa:

Para solucionar este problema, realiza una de las siguientes acciones:

  • Agregue una 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:

Ninguno
121095148

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

Solución alternativa:

Ejecuta la copia de seguridad por segunda vez. Debería crear una copia de seguridad del conjunto de archivos correcto.

115278838

Tokens de sesión no validados

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 experiencia de New Edge con SAML.

113342838

Las operaciones de Cassandra no funcionan cuando la autenticación JMX está habilitada

Solución alternativa:

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

79993247

Las solicitudes HEAD a destinos de Node.js se interrumpen

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

Solución alternativa:

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

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 en 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

En varias configuraciones del centro 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

Es posible que el servidor de administración no se inicie porque intenta conectarse a nodos de Cassandra en dc-1 y dc-2. DataAccessExceptions ocurre si un nodo de Cassandra no funciona. Esto también puede provocar una interrupción del tráfico de la API, en la que el procesador de mensajes informa DataAccessExceptions mientras intenta recuperar 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 entre regiones.

Solución alternativa

La solución alternativa es cancelar el registro de los siguientes tipos de nodos de Cassandra en el centro de datos no disponible y, luego, volver a registrarlos una vez que los nodos de Cassandra vuelvan a estar disponibles:

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

Para cancelar el registro y volver a registrar estos tipos de nodos de Cassandra:

  1. Obtén los UUID de los nodos de Cassandra con 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 la “puerta de enlace” de forma predeterminada. Sin embargo, es posible que la hayas cambiado a otro nombre, por lo que debes verificar 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 cancelar 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. Cancela 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
    .

    Donde UUID es el UUID que se muestra en la respuesta del comando anterior.

  4. Repita el paso 3 para cada UUID que haya recopilado 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 el registro de nodos en Zookeeper, y no tienen ningún impacto en el clúster de Cassandra. Para obtener más información sobre estos comandos, consulta Cómo actualizar los registros del almacén de datos.

68722102

Política de MessageLogging que incluye 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 seguirá incluyendo la siguiente información:

  • La puntuación de prioridad
  • La marca de tiempo

Solución alternativa:

Ninguno
65737520

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

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

Solución alternativa:

Define la contraseña en un archivo de datos que pasas 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

A fin de comenzar a usar Edge para Cloud 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