4.53.00.05: 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 21 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.53.00-0.0.60310.noarch.rpm
  • edge-management-server-4.53.00-0.0.60310.noarch.rpm
  • edge-message-processor-4.53.00-0.0.60310.noarch.rpm
  • edge-postgres-server-4.53.00-0.0.60310.noarch.rpm
  • edge-qpid-server-4.53.00-0.0.60310.noarch.rpm
  • edge-router-4.53.00-0.0.60310.noarch.rpm
  • apigee-qpidd-8.0.6-0.0.2540.noarch.rpm
  • apigee-setup-4.53.00-0.0.1151.noarch.rpm
  • apigee-sso-4.53.00-0.0.21590.noarch.rpm
  • apigee-tomcat-9.0.106-0.0.957.noarch.rpm
  • edge-uapim-4.53.00-0.0.60313.noarch.rpm
  • edge-uapim-connector-4.53.00-0.0.60313.noarch.rpm
  • edge-mint-gateway-4.53.00-0.0.40542.noarch.rpm
  • edge-mint-management-server-4.53.00-0.0.40542.noarch.rpm
  • edge-mint-message-processor-4.53.00-0.0.40542.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.53.00.sh más reciente de Edge 4.53.00 en /tmp/bootstrap_4.53.00.sh:
      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
    3. Instala la utilidad apigee-service y las dependencias de Edge 4.53.00:
      sudo bash /tmp/bootstrap_4.53.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 la 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 Edge, ejecuta la secuencia de comandos update.sh para el proceso edge (incluida la monetización):
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. En todos los nodos de Qpid, ejecuta la secuencia de comandos update.sh:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Si usas SSO, ejecuta el siguiente comando:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -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 wait_for_ready de qpid.
391852306 Se corrigieron las fallas de calificación de transacciones de monetización después de los cambios de zona horaria.

Mejoras

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

ID del problema Descripción
430665793 Se agregó un registro adicional para las operaciones de claves y certificados durante el inicio del procesador de mensajes.
366144787 Se agregó la API de monetización para facilitar la sincronización de datos a pedido para entidades individuales.

Problemas de seguridad corregidos

ID del problema Descripción
391546513 Se corrigieron varios problemas de seguridad para la monetización.

Integración del conector del Centro de APIs 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 procesador de mensajes, que exporta datos del entorno de ejecución a un sistema de archivos de red (NFS). El conector del Centro de APIs para la nube privada consume estos datos y los publica en el Centro de APIs. 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 Centro de APIs de Edge para la nube privada, consulta Descripción general y flujo de la integración del conector del Centro de APIs.

Aspectos destacados importantes:

  • Nuevo conector binario del Centro de APIs 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 la API y datos del entorno de ejecución en el Centro de APIs
  • 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 la API de la nube privada
  • Nueva integración de la 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 Centro de APIs.

  • 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 (p.ej., 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 estableces 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 (relleno)

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

  • Proceso: La conciliación se logra si se inhabilita temporalmente una organización de la configuración del conector (se borran los valores de las propiedades runtimeDataPubsub y metadataPubsub) y, luego, se vuelve a habilitar de inmediato (se restablecen 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 inconsistencias de datos.

Cambios en el software compatible

Se admite Tomcat v9.0.106. 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.

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