4.51.00.12: 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 30 de marzo de 2023, lanzamos una nueva versión de Apigee Edge para la nube privada.

Nota: Esta versión será compatible hasta el 30 de marzo de 2024.

Procedimiento de actualización

En esta sección, se describe cómo instalar esta versión si realizas la actualización desde la versión de parche anterior, 4.51.00.11. Si necesitas actualizar desde una versión anterior, consulta Cómo aplicar varias versiones de parche.

Si instalas esta versión, se actualizarán los componentes de la siguiente lista de RPMs:

  • edge-gateway-4.51.00-0.0.60186.noarch.rpm
  • edge-management-server-4.51.00-0.0.60186.noarch.rpm
  • edge-postgres-server-4.51.00-0.0.60186.noarch.rpm
  • edge-qpid-server-4.51.00-0.0.60186.noarch.rpm
  • edge-router-4.51.00-0.0.60186.noarch.rpm
  • apigee-postgresql-10.17-0.0.2535.noarch.rpm
  • edge-mint-gateway-4.51.00-0.0.40322.noarch.rpm
  • edge-mint-management-server-4.51.00-0.0.40322.noarch.rpm
  • edge-mint-message-processor-4.51.00-0.0.40322.noarch.rpm
  • apigee-sso-4.51.00-0.0.21244.noarch.rpm
  • apigee-attribution-4.51.00-0.0.723.noarch.rpm
  • apigee-sosreport-5.0-0.0.2508.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 de Edge, haz lo siguiente:

    1. Limpia los repositorios de Yum:
      sudo yum clean all
    2. Descarga el archivo más reciente de Edge 4.51.00 bootstrap_4.51.00.sh en /tmp/bootstrap_4.51.00.sh:
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
    3. Instala la utilidad apigee-service y las dependencias de Edge 4.51.00:
      sudo bash /tmp/bootstrap_4.51.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. Usa el comando source para ejecutar la secuencia de comandos apigee-service.sh:
      source /etc/profile.d/apigee-service.sh
  2. Actualiza los nodos de Postgres (principal y en espera):
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. 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
  4. Ejecuta la secuencia de comandos update.sh para SSO en todos los nodos:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

Nuevas funciones

En esta versión, se incluye la siguiente función nueva:

TLS 1.3 para el tráfico de extremo descendente

Esta versión agrega compatibilidad con TLS 1.3 para el tráfico de extremo descendente (tráfico entre un procesador de mensajes y el servidor de backend). Consulta Cómo configurar TLS 1.3 para el tráfico de extremo descendente para obtener más información.

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.

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
197529839

La falta de espacios finales después de los operadores de condición provocaba fallas en la implementación.

Esto se corrigió con un mejor manejo de las líneas nuevas en las instrucciones de condición de los proxies.
269545512

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

193007714

Faltaban algunas propiedades cuando se recuperaban los detalles de destino de un proxy como JSON.

Esto se corrigió.
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 CWC conf_keymanagement_app.auditlog.mask.secret como falso 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.
260013493

Se agregaron correcciones para optimizar la carga de recursos de la especificación de OpenAPI como parte de la política OASValidation.

Esto debería acelerar el tiempo de arranque del procesador de mensajes si el MP tiene que cargar muchos recursos de OAS. Esto también debería evitar que se generen registros de advertencia y error innecesarios mientras se cargan los proxies que contienen recursos de OAS.
274587823

No se permite que las entidades externas se carguen de forma predeterminada en la política XSLTransform.

Para habilitar esta opción, configura la marca conf_feature-flags_xsl.allow.external.entities=true en el procesador de mensajes.
260714664

Algunas tablas de Cassandra aún usaban SizeTieredCompactionStrategy de forma predeterminada.

Esto se cambió a LeveledCompactionStrategy. Ten en cuenta que este cambio se aplica solo a las instalaciones nuevas de Apigee Edge para la nube privada.
261631942

Se corrigió una regresión menor en una secuencia de comandos previa a la instalación de apigee-postgresql en la que la copia de seguridad de los archivos de configuración fallaba en algunas condiciones.

258898812

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

272136041

Los siguientes campos de la API, que se agregaron recientemente a Apigee, son visibles en Edge para la nube privada. Sin embargo, no tienen ningún efecto en Edge para la nube privada, por lo que puedes ignorarlos de forma segura si los encuentras.

  • proxy_deployment_type
  • sense_action_id
  • sense_flag_headers
  • x_apigee_grpc_status
  • x_apigee_grpc_service_name
  • x_apigee_grpc_rpc_name

Problemas conocidos

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 realices la actualización 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 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 quieres 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.