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

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X.
info

El 19 de abril de 2023, lanzamos una nueva versión de Apigee Edge para la nube privada.

Nota: Esta versión será compatible hasta el 31 de agosto de 2024.

Procedimiento de actualización

En esta sección, se describe cómo instalar esta versión si actualizas desde la versión anterior de Edge para la nube privada. Si necesitas actualizar desde una versión anterior, consulta Cómo aplicar varias versiones de parche.

La actualización de esta versión actualizará los componentes de la siguiente lista de RPMs:

  • edge-management-server-4.52.00-0.0.60190.noarch.rpm
  • edge-postgres-server-4.52.00-0.0.60190.noarch.rpm
  • edge-qpid-server-4.52.00-0.0.60190.noarch.rpm
  • edge-router-4.52.00-0.0.60190.noarch.rpm
  • apigee-cassandra-2.1.22-0.0.2539.noarch.rpm
  • apigee-cassandra-client-2.1.22-0.0.2519.noarch.rpm
  • apigee-provision-4.52.00-0.0.623.noarch.rpm
  • apigee-sso-4.52.00-0.0.21245.noarch.rpm
  • edge-analytics-4.52.00-0.0.40091.noarch.rpm
  • apigee-postgresql-14.5-0.0.2739.noarch.rpm
  • edge-mint-gateway-4.52.00-0.0.40323.noarch.rpm
  • edge-mint-management-server-4.52.00-0.0.40323.noarch.rpm
  • edge-mint-message-processor-4.52.00-0.0.40323.noarch.rpm
  • apigee-sosreport-5.0-0.0.2509.noarch.rpm

Para verificar las versiones de RPM que tienes instaladas actualmente y ver si necesitan actualizarse, ingresa lo siguiente:

apigee-all version

Para actualizar la instalación, sigue el siguiente procedimiento en los nodos de Edge:

  1. En todos los nodos de Edge, haz lo siguiente:

    1. Limpia los repositorios de Yum:
      sudo yum clean all
    2. Descarga el archivo bootstrap_4.52.00.sh más reciente de Edge 4.52.00 en /tmp/bootstrap_4.52.00.sh:
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
    3. Instala la utilidad apigee-service y las dependencias de Edge 4.52.00:
      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

      donde uName y pWord son el nombre de usuario y la contraseña que recibiste de Apigee. Si omites pWord, se te pedirá que lo ingreses.

    4. Actualiza la utilidad apigee-setup:
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. Usa el comando source para ejecutar la secuencia de comandos apigee-service.sh:
      source /etc/profile.d/apigee-service.sh
  2. Actualiza la utilidad apigee-provision en el servidor de administración:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  3. Actualiza los nodos de Postgres (principal y en espera):
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. En todos los nodos de Edge, ejecuta la secuencia de comandos update.sh para el proceso de Edge:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Ejecuta la secuencia de comandos update.sh para SSO en todos los nodos:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

Problemas de seguridad corregidos

No se corrigieron problemas de seguridad en esta versión.

Cambios en el software compatible

No hay cambios en el software compatible en esta versión.

Bajas y retiros

No hay bajas ni retiros nuevos en esta versión.

Nuevas funciones

No hay funciones nuevas en esta versión.

Correcciones de errores

En esta sección, se enumeran los errores de la nube privada que se corrigieron en esta versión.

ID del problema Descripción
271093461

La política OASValidation consumía demasiada asignación de memoria del montón

Ya se corrigió este problema.
248499777

Se agregaron más verificaciones para evitar el contrabando de una solicitud GET dentro de otra solicitud POST.

245387101

Se modificaron los datos de auditoría de las APIs relacionadas con la app para desarrolladores.

El secreto del consumidor ahora se registra de manera coherente de forma enmascarada. Puedes configurar la configuración conf_keymanagement_app.auditlog.mask.secret en false en el servidor de administración para evitar que se enmascare el secreto,en caso de que desees registrar el secreto de texto sin formato en la auditoría.
267778362

Apigee-provision creaba líneas vacías cuando agregaba entradas de cron.

Ya se corrigió este problema.
267788856

Se mejoró rebuildindex para que las APIs de índice no basadas en ID funcionen de manera adecuada cuando hay más de 10,000 apps por entidad.

273931118

Se corrigió una regresión en la API de MGMT que provocaba que se devolvieran tipos de contenido incorrectos cuando el encabezado Accept en las solicitudes tenía un comodín.

Esto también provocaba fallas durante la descarga del archivo de seguimiento en la IU.
274587823

Por motivos de seguridad, ahora no se permite que las entidades externas se carguen de forma predeterminada en la política XSLTransform.

Para anular este comportamiento, configura la marca conf_feature-flags_xsl.allow.external.entities=true en el procesador de mensajes.
245387101

Se modificaron los datos de auditoría de las APIs relacionadas con la app para desarrolladores.

El secreto del consumidor ahora se registra de manera coherente de forma enmascarada. Puedes configurar conf_keymanagement_app.auditlog.mask.secret en false en el servidor de administración para evitar que se enmascare el secreto,en caso de que desees registrar el secreto de texto sin formato en la auditoría.
276991965

Se corrigió un error introducido en OPDK v4.52.00 que provocaba que fallaran ciertas combinaciones de API y encabezado Accept.

260024953

Apigee no propagaba algunas variables de destino, como URL y Host, cuando se usaba un servidor de destino y se encontraba un error de destino.

Ya lo resolvimos.
274399775

Cassandra y cassandra-client no se actualizaban a las versiones más recientes cuando se actualizaba de Edge para la nube privada v4.51 a v4.52.

Ya se corrigió este problema.
269545512

Se actualizó la versión del controlador de Postgres en la puerta de enlace a 42.5.4.

270203185

Se actualizó la versión del controlador de Postgres en Monetization a 42.5.4.

197529839

Se mejoró el manejo de líneas nuevas en las instrucciones de condición de los proxies.

214664198

Se agregó una columna en las tablas de hechos de Analytics que captura las tres políticas principales que tardaron más en ejecutarse.

258898812

Se quitó el parámetro inesperado credentialsLoaded de la respuesta de la API de recuperación de apps.

270967547

Hubo un problema al actualizar de Edge para la nube privada 4.50 a 4.52.

Ya se corrigió este problema.

Problemas conocidos

Apigee-postgresql tiene problemas para actualizar de la versión 4.50 o 4.51 a la versión 4.52. Los problemas ocurren principalmente cuando la cantidad de tablas de hechos secundarias es superior a 500. Consulta Actualización de Postgresql cuando se actualiza a la versión 4.52 en Problemas conocidos con Edge para la nube privada para obtener una solución alternativa.

Consulta Problemas conocidos con Edge para la nube privada para obtener una lista completa de los problemas conocidos.

Cómo aplicar varias versiones de parche

En esta sección, se describe cómo aplicar varias versiones de parche, en caso de que actualices desde una versión de Edge para la nube privada anterior a la versión de actualización de parche anterior.

Cada versión de parche contiene actualizaciones de componentes específicos de Edge para la nube privada, como edge-management-server. Para aplicar varias versiones de parche, debes actualizar cada componente de Edge que se incluyó en una versión de parche posterior a la versión instalada actualmente. Para encontrar estos componentes, consulta las notas de la versión de Edge para la nube privada de todas las versiones posteriores a la versión actual y verifica la lista de RPMs de esas versiones. Consulta las Notas de la versión de Apigee para obtener vínculos a todas las notas de la versión de Edge para la nube privada.

Nota: Solo debes actualizar cada componente una vez. Para ello, instala el RPM de la versión más reciente del componente incluido en las versiones de parche. Sigue las instrucciones de las notas de la versión para actualizar el componente.

Nota: Cuando actualizas un componente, se instala automáticamente la versión de parche más reciente de un componente. Si deseas actualizar a una versión de parche que no sea la más reciente, debes mantener tu propia copia de tarball del repositorio de Apigee con el mirror de Apigee y usar este mirror para las instalaciones de Apigee. Para obtener más información, consulta Cómo usar un repositorio local de Edge para mantener tu versión de Edge.