4.52.00.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 19 de abril de 2023, lanzamos una versión nueva 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 estás realizando una actualización desde la versión anterior de Edge para la nube privada. Si necesitas realizar una actualización desde una versión anterior, consulta Aplica varias versiones de parche.

Si actualizas esta versión, se actualizarán 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

Puedes verificar las versiones de RPM que tienes instaladas actualmente para ver si deben actualizarse. Para ello, ingresa lo siguiente:

apigee-all version

Para actualizar la instalación, realiza el siguiente procedimiento en los nodos perimetrales:

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

      En el ejemplo anterior, 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 (instancia principal y en espera):
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. En todos los nodos perimetrales, ejecuta la secuencia de comandos update.sh para el proceso perimetral:
    /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

Problemas de seguridad solucionados

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

Cambios en el software compatible

No se realizaron cambios en el software compatible en esta versión.

Bajas y retiros

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

Funciones nuevas

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 de desarrolladores.

El secreto del consumidor ahora 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 enmascara el secreto,en caso de que desees registrar un secreto de texto simple en la auditoría.
267778362

Apigee-provision creaba líneas vacías mientras se agregaban entradas cron.

Ya se solucionó este problema.
267788856

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

273931118

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

Esto también causaba fallas al descargar el archivo de registro en la IU.
274587823

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

Para anular esto, configura 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 de desarrolladores.

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

Se corrigió un error ingresado en OPDK v4.52.00 que causaba que fallaran ciertas combinaciones de APIs y encabezados de Accept.

260024953

Apigee no propagaba algunas variables de destino, como URL y host, cuando se usó un servidor de destino y se produjo un error de objetivo.

Ya se resolvió.
274399775

Cassandra y Cassandra-client no se actualizaban a las versiones más recientes cuando se actualizaron de Edge para nube privada a la versión 4.51 a la 4.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 Monetización a la versión 42.5.4.

197529839

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

214664198

Se agregó una columna a las Tablas de datos 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 sobre la recuperación de apps.

270967547

Ocurrió un problema durante la actualización de Edge a la nube privada 4.50 a 4.52.

Ya se solucionó este problema.

Errores conocidos

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

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

Aplica varias versiones de parche

En esta sección, se describe cómo aplicar varias versiones de parche en caso de que estés actualizando desde una versión de Edge para la nube privada anterior a la versió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 incluido 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 nube privada de todas las versiones posteriores a la actual y revisa la lista de RPM de esas versiones. Consulta las Notas de la versión de Apigee para ver los 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 que se indican en las notas de la versión para actualizar el componente.

Nota: La actualización de un componente 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 es la más reciente, debes mantener tu propia copia de archivo comprimido del repositorio de Apigee con la duplicación de Apigee y usar esta duplicación para las instalaciones de Apigee. Para obtener más información, consulta Usa un repositorio de Edge local para mantener tu versión de Edge.