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 Private Cloud. 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 RPM:

  • 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 tu instalación, realiza el siguiente procedimiento en los nodos de Edge:

  1. En todos los nodos perimetrales, haz lo siguiente:

    1. Limpia los repositorios de Yum:
      sudo yum clean all
    2. Descarga el archivo bootstrap_4.52.00.sh de Edge 4.52.00 más reciente 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 de Edge 4.52.00 y las dependencias:
      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 de 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 el SSO en todos los nodos:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

Se corrigieron problemas de seguridad

En esta versión, no se corrigieron problemas de seguridad.

Cambios en el software compatible

En esta versión, no se realizaron cambios en el software compatible.

Bajas y retiros

En esta versión, no hay nuevas bajas ni descontinuaciones.

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 solucionó 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 las apps para desarrolladores.

Ahora, el secreto del consumidor se registra de forma coherente y enmascarada. Puedes establecer 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 solucionó este problema.
267788856

Se mejoró rebuildindex para que las APIs de índice que no se basan en IDs funcionen correctamente 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 errores al descargar el archivo de registro en la IU.
274587823

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

Puedes anular esta opción configurando la marca conf_feature-flags_xsl.allow.external.entities=true en Message Processor.
245387101

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

Ahora, el secreto del consumidor se registra de forma coherente y enmascarada. Puedes cambiar la configuración de conf_keymanagement_app.auditlog.mask.secret a false en el servidor de administración para evitar que se enmascare el secreto en caso de que quieras 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 encabezados Accept y API.

260024953

Apigee no completaba algunas variables de destino, como URL y host, cuando se usaba un servidor de destino y se producía un error de destino.

Ya se resolvió este problema.
274399775

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

Ya se solucionó este problema.
269545512

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

270203185

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

197529839

Se mejoró el control de las líneas nuevas en las instrucciones condicionales de los proxies.

214664198

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

258898812

Se quitó el parámetro inesperado credentialsLoaded de la respuesta de la API para recuperar apps.

270967547

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

Ya se solucionó 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 al actualizar 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 parches

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

Cada versión de parche contiene actualizaciones para componentes específicos de Edge para nubes privadas, 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. Puedes encontrar estos componentes consultando las notas de la versión de Edge para Private Cloud de todas las versiones posteriores a la actual y verificando 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 ese componente. Si deseas actualizar a una versión de parche que no sea la más reciente, debes mantener tu propia copia tar.gz del repo de Apigee con el duplicado de Apigee y usar este duplicado 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.