4.52.02.04: 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 25 de julio de 2025, lanzamos una nueva versión de Apigee Edge para la nube privada.

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 anterior de Edge para la nube privada. Si necesitas actualizar desde una versión anterior, consulta Cómo aplicar varias versiones de parche.

Si actualizas esta versión, se actualizarán los componentes que se indican a continuación:

  • edge-gateway-4.52.02-0.0.60308.noarch.rpm
  • edge-management-server-4.52.02-0.0.60308.noarch.rpm
  • edge-message-processor-4.52.02-0.0.60308.noarch.rpm
  • edge-postgres-server-4.52.02-0.0.60308.noarch.rpm
  • edge-qpid-server-4.52.02-0.0.60308.noarch.rpm
  • edge-router-4.52.02-0.0.60308.noarch.rpm
  • apigee-cassandra-3.11.16-0.0.2596.noarch.rpm
  • apigee-cassandra-client-3.11.16-0.0.2544.noarch.rpm
  • apigee-lib-4.52.02-0.0.1028.noarch.rpm
  • apigee-setup-4.52.02-0.0.1150.noarch.rpm
  • apigee-qpidd-8.0.6-0.0.2537.noarch.rpm

Para verificar las versiones de RPM 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.02.sh más reciente de Edge 4.52.02 en /tmp/bootstrap_4.52.02.sh:
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    3. Instala la utilidad apigee-service de Edge 4.52.02 y las dependencias:
      sudo bash /tmp/bootstrap_4.52.02.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
    5. Actualiza la utilidad apigee-setup:
      apigee-service apigee-setup update
  2. En todos los nodos de Cassandra, ejecuta la secuencia de comandos update.sh:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -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. En todos los nodos de Qpid, ejecuta la secuencia de comandos update.sh:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

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
429056579 Se corrigió la secuencia de comandos qpid's wait_for_ready.

Problemas de seguridad corregidos

No se agregaron problemas de seguridad nuevos en esta versión.

Cambios en el software compatible

Se agregó compatibilidad con Amazon-Linux-2023.7(AL2023.7).

Consulta Software compatible con Edge para la nube privada para obtener una lista completa del software compatible.

Bajas y retiros

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

Nuevas funciones

En esta sección, se enumeran las nuevas funciones de esta versión.

ID del problema Descripción
390047431

Se agregó compatibilidad con Amazon-Linux-2023(AL2023).

Integración del conector del concentrador de API de Edge para la nube privada

Esta versión incluye compatibilidad con el conector del Centro de APIs de Apigee para la integración de la nube privada, lo que permite a las organizaciones sincronizar los metadatos de la API y los análisis del entorno de ejecución con el Centro de APIs de Google Cloud. La integración incluye un nuevo conector binario del Centro de APIs de Apigee y mejoras en el Message Processor, que exporta datos del entorno de ejecución a un sistema de archivos de red (NFS). El conector del concentrador de API para la nube privada consume estos datos y los publica en el concentrador de API. No hay correcciones de errores ni cambios en el comportamiento existente de Apigee Edge para la nube privada. Para obtener más información sobre la integración del conector del concentrador de API de Edge para la nube privada, consulta Descripción general y flujo de la integración del conector del concentrador de API.

Aspectos destacados importantes:

  • Nuevo conector binario del concentrador de API de Apigee
  • Mejoras en el procesador de mensajes para exportar datos del entorno de ejecución a NFS
  • Compatibilidad total para la publicación de metadatos de API y datos del entorno de ejecución en el concentrador de API
  • Activación basada en la opción de participación con el conector estándar del Centro de APIs de Apigee para el flujo de API de la nube privada
  • Nueva integración de API con el conector para admitir la carga de entornos y paquetes de proxy
  • Ahora se requiere un nuevo permiso de IAM (roles/apihub.admin) para la cuenta de servicio del conector para habilitar la nueva funcionalidad de la API

Enmascaramiento de información de identificación personal (PII)

Esta función garantiza la privacidad de los datos y el cumplimiento, ya que te permite enmascarar datos sensibles dentro de los paquetes de proxy de API y de flujo compartido antes de que se sincronicen con el concentrador de API.

  • Máscaras predeterminadas: El conector aplica automáticamente una lista integrada de expresiones XPath (máscaras predeterminadas) para enmascarar fuentes de PII conocidas en las configuraciones de políticas (como contraseñas de autenticación básica codificadas, claves privadas en políticas de JWT/JWS).
  • Máscaras personalizadas: Puedes configurar máscaras personalizadas adicionales si configuras la propiedad conf_uapim_connector.uapim.mask.xpaths en el archivo /opt/apigee/customer/application/uapim-connector.properties, lo que te permite segmentar campos sensibles específicos del cliente.

Conciliación de la organización

El conector ahora proporciona un proceso definido para conciliar (o completar) el conjunto completo de metadatos de API de una organización de Apigee existente en el concentrador de API.

  • Proceso: La conciliación se logra inhabilitando temporalmente una organización de la configuración del conector (borrando los valores de las propiedades runtimeDataPubsub y metadataPubsub) y, luego, volviendo a habilitarla de inmediato (restaurando los valores).
  • Función: Esta acción obliga al conector a realizar una recuperación completa y una resincronización completa de todos los metadatos de la organización especificada, lo que resuelve posibles incoherencias de datos.

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 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 para todas las versiones posteriores a la versión actual y verifica la lista de RPM para 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.