Estás viendo la documentación de Apigee Edge.
Ir a la documentación de
Apigee X. info
El 25 de octubre de 2023, lanzamos una nueva versión de Apigee Edge para la nube privada.
Nota: Esta versión será compatible hasta el 25 de octubre de 2024.
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.
La actualización de esta versión actualizará los componentes de la siguiente lista de RPM:
- edge-gateway-4.52.00-0.0.60200.noarch.rpm
- edge-management-server-4.52.00-0.0.60200.noarch.rpm
- edge-message-processor-4.52.00-0.0.60200.noarch.rpm
- edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
- edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
- edge-router-4.52.00-0.0.60200.noarch.rpm
- apigee-sso-4.52.00-0.0.21316.noarch.rpm
- edge-analytics-4.52.00-0.0.40100.noarch.rpm
- edge-management-ui-4.52.00-0.0.20029.noarch.rpm
- edge-ui-4.52.00-0.0.20233.noarch.rpm
- apigee-service-4.52.00-0.0.1500.noarch.rpm
- apigee-mirror-4.52.00-0.0.1032.noarch.rpm
- apigee-tomcat-9.0.82-0.0.939.noarch.rpm
- apigee-configutil-4.52.00-0.0.624.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:
-
En todos los nodos perimetrales, haz lo siguiente:
- Limpia los repositorios de Yum:
sudo yum clean all
- Descarga el archivo
bootstrap_4.52.00.shde Edge 4.52.00 más reciente en/tmp/bootstrap_4.52.00.sh:curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
- Instala la utilidad
apigee-servicede Edge 4.52.00 y las dependencias:sudo bash /tmp/bootstrap_4.52.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.
- Usa el comando
sourcepara ejecutar la secuencia de comandos apigee-service.sh:source /etc/profile.d/apigee-service.sh
- Limpia los repositorios de Yum:
- En todos los nodos de Edge, ejecuta la secuencia de comandos
update.shpara el proceso de Edge:/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Ejecuta la secuencia de comandos
update.shpara el SSO en todos los nodos: - En todos los nodos de la IU, ejecuta la secuencia de comandos
update.shpara la IU:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Si usas la nueva experiencia de Edge, ejecuta el siguiente comando:
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
Se corrigieron problemas de seguridad
A continuación, se incluye una lista de los problemas de seguridad conocidos que se corrigieron en esta versión. Para evitar estos problemas, instala la versión más reciente de Edge para la nube privada.| ID del problema | Descripción |
|---|---|
| 279065506 | En la URL de redireccionamiento para OAuth2, se mejoró la entropía del parámetro de estado para que sea impredecible y evitar la vulnerabilidad de falsificación de solicitudes entre sitios (CSRF)". |
| 279065586 | Se agregaron políticas de seguridad del contenido en el encabezado para proporcionar una capa adicional de seguridad para los sitios contra ataques del cliente. |
Cambios en el software compatible
Se agregó compatibilidad con las siguientes versiones de software:
- Red Hat Enterprise Linux (Intel 64 bits): versión 8.8
- Oracle Linux (Intel de 64 bits): versiones 7.9, 8.7 y 8.8
- Rocky Linux 8
- Tomcat 9.0.82
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 versión, se incluyen las siguientes funciones nuevas:
Establece la cantidad máxima de caracteres para los nombres de la organización y el entorno
Con este lanzamiento, puedes limitar la cantidad máxima de caracteres para los nombres de la organización y el entorno cuando creas una organización o un entorno nuevos. El valor predeterminado para la cantidad máxima de caracteres es 255. Para establecer un valor máximo más bajo, configura las siguientes propiedades en sus respectivos archivos de propiedades:
- En el archivo de propiedades de la organización, establece
org.name.max.length. - En el archivo de propiedades de la organización, establece
env.name.max.length.
Si alguna de estas propiedades se establece en un valor inferior a 0 o superior a 255, el sistema usará un valor máximo de 1 o 255, respectivamente.
Cómo establecer el vencimiento de los tokens de acceso
Con este lanzamiento, puedes establecer el vencimiento de los tokens de acceso configurando la propiedad
conf_keymanagement_oauth_access_token_expiry_time_in_millis en el tiempo de vencimiento deseado en milisegundos. Esta función está inhabilitada de forma predeterminada. Para habilitarlo, configura conf_keymanagement_oauth_access_token_is_apply_limit como true en el procesador de mensajes.
Esta función brinda a los administradores de Apigee un mejor control sobre el vencimiento de los tokens de acceso creados en Apigee.
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 |
|---|---|
| 290242749 |
Cuando se usó la variable |
| 260397807 |
Se solucionó un problema en las plantillas de correo electrónico que impedía que se enviaran caracteres multibyte en los correos electrónicos. Ya se solucionó este problema. |
| 234544436 |
Se solucionó un problema por el que desaparecía el menú de la izquierda cuando se cambiaba de organización en la nueva IU de Edge. Ya se solucionó este problema. |
| 293268203 |
Las dependencias de Analytics no se actualizaban automáticamente en los nodos del servidor de administración. Ya se solucionó este problema. |
| 261616264 |
Se agregó una verificación de inicio para garantizar que PostgreSQL no se quite ni se borre durante el proceso de actualización. |
| 279065586 |
En la URL de redireccionamiento para OAuth2, se mejoró la entropía del parámetro de estado para que sea impredecible y evitar la vulnerabilidad de falsificación de solicitudes entre sitios (CSRF). |
| 283310836 |
Se mejoró el mensaje de error que aparece cuando se analizan archivos XML grandes. |
| 245936798 |
Se solucionó un problema con los nombres de la organización y el entorno que provocaba que fallaran las consultas de Postgresql <code<create< code="" dir="ltr" translate="no"> queries to fail.</code<create<> Se corrigió el problema con el control mejorado de los conflictos de nombres de índices de Postgres para nombres de organizaciones y entornos largos. |
| 293733533 |
Se actualizó la biblioteca de terceros de Spring en los componentes de Edge Gateway de la versión 5.3.20 a la versión 5.3.27. |
| 294363158 |
Se corrigió una regresión que provocaba que aparecieran algunas dimensiones adicionales en los menús desplegables de las páginas de análisis y supervisión de la IU de Edge. Ya se solucionó este problema. |
| 297889765 |
Los artefactos generados por apigee-mirror ahora tienen la propiedad correcta. |
| 294989027 |
Se mejoró el rendimiento de ciertas APIs de estadísticas. |
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 nubes privadas, 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 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.