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 actualizas desde la versión anterior de Edge para Private Cloud. 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 si es necesario actualizar las versiones de RPM instaladas actualmente, 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 perimetrales, haz lo siguiente:

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

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 nuevas bajas ni descontinuaciones.

Nuevas funciones

En esta sección, se enumeran las funciones nuevas de esta versió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 nube privada, lo que permite a las organizaciones sincronizar los metadatos de la API y los análisis del entorno de ejecución con Google Cloud API Hub. La integración incluye un nuevo objeto binario de conector de Centro de APIs de Apigee y mejoras en el Message Processor, 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 Private Cloud, consulta Descripción general y flujo de la integración del conector de API Hub.

Aspectos destacados importantes:

• Nuevo conector binario del Centro de APIs de Apigee
• Mejoras en el procesador de mensajes para exportar datos de tiempo de ejecución a NFS
• Compatibilidad total con la publicación de metadatos de API y datos de tiempo de ejecución en el centro de APIs
• Activación basada en la aceptación con el conector estándar del Centro de APIs 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 (IIP)

Esta función garantiza la privacidad de los datos y el cumplimiento, ya que te permite enmascarar los datos sensibles dentro de los paquetes de proxy de API y de flujo compartido 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 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 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 reconciliació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 parches

En esta sección, se describe cómo aplicar varias versiones de parches en caso de que actualices desde una versión de Edge para Private Cloud anterior a la versión del parche anterior.

Cada versión de parche contiene actualizaciones para componentes específicos de Edge para Private Cloud, 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 tuya 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 tar.gz 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.