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

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 nubes privadas. 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 siguientes componentes:

  • 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 si las versiones de RPM instaladas actualmente deben actualizarse, ingresa lo siguiente:

apigee-all version

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

  1. En todos los nodos de Edge:

    1. Limpia los repositorios de Yum:
      sudo yum clean all
    2. Descarga el archivo bootstrap_4.52.02.sh de Edge 4.52.02 más reciente 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

      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. 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 Private Cloud que se corrigieron en esta versión.

ID del problema Descripción
429056579 Se corrigió la secuencia de comandos qpid's wait_for_ready.

Se corrigieron problemas de seguridad

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 nubes privadas para obtener una lista completa del software compatible.

Bajas y retiros

En esta versión, no hay ninguna baja ni desuso nuevos.

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 centro de APIs de Edge para la nube privada

Esta versión incluye compatibilidad con el conector de Apigee API Hub para la integración de Private Cloud, lo que permite a las organizaciones sincronizar los metadatos de la API y las estadísticas del entorno de ejecución con Google Cloud API Hub. La integración incluye un nuevo conector binario de Apigee API Hub y mejoras en el procesador de mensajes, que exporta datos de tiempo de ejecución a un sistema de archivos de red (NFS). El conector de API Hub para Private Cloud consume estos datos y los publica en API Hub. 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 de API Hub de Edge para la nube privada, consulta Descripción general y flujo de la integración del conector de API Hub.

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 con la publicación de metadatos de API y datos de tiempo de ejecución en el concentrador de APIs
  • Activación basada en la aceptación con el conector estándar del concentrador de API de Apigee para el flujo de API de Private Cloud
  • 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 que la cuenta de servicio del conector habilite la nueva funcionalidad de la API.

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

Esta función garantiza la privacidad y el cumplimiento de los datos, ya que te permite enmascarar los datos sensibles dentro de los paquetes de flujos compartidos y proxies de API antes de que se sincronicen con API Hub.

  • Máscaras predeterminadas: El conector aplica automáticamente una lista integrada de expresiones XPath (máscaras predeterminadas) para enmascarar las fuentes conocidas de PII en la configuración 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 estableciendo 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

Ahora, el conector proporciona un proceso definido para conciliar (o completar) el conjunto completo de metadatos de la API de una organización de Apigee existente con el Centro de APIs.

  • 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, habilitándola de inmediato (restableciendo los valores).
  • Función: Esta acción obliga al conector a realizar una recuperación completa y una resincronización total 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 actualices 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 para 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. 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 de tarball 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.