4.51.00.12: 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 30 de marzo de 2023, lanzamos una nueva versión de Apigee Edge para la nube privada.

Nota: Esta versión será compatible hasta el 30 de marzo de 2024.

Procedimiento de actualización

En esta sección, se describe cómo instalar esta versión si estás actualizando desde la versión de parche anterior, 4.51.00.11. Si necesitas actualizar desde una versión anterior, consulta Cómo aplicar varias versiones de parche.

La instalación de esta versión actualizará los componentes de la siguiente lista de RPM:

  • edge-gateway-4.51.00-0.0.60186.noarch.rpm
  • edge-management-server-4.51.00-0.0.60186.noarch.rpm
  • edge-postgres-server-4.51.00-0.0.60186.noarch.rpm
  • edge-qpid-server-4.51.00-0.0.60186.noarch.rpm
  • edge-router-4.51.00-0.0.60186.noarch.rpm
  • apigee-postgresql-10.17-0.0.2535.noarch.rpm
  • edge-mint-gateway-4.51.00-0.0.40322.noarch.rpm
  • edge-mint-management-server-4.51.00-0.0.40322.noarch.rpm
  • edge-mint-message-processor-4.51.00-0.0.40322.noarch.rpm
  • apigee-sso-4.51.00-0.0.21244.noarch.rpm
  • apigee-attribution-4.51.00-0.0.723.noarch.rpm
  • apigee-sosreport-5.0-0.0.2508.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:

  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.51.00.sh de Edge 4.51.00 más reciente en /tmp/bootstrap_4.51.00.sh:
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
    3. Instala la utilidad apigee-service y las dependencias de Edge 4.51.00:
      sudo bash /tmp/bootstrap_4.51.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.

    4. Usa el comando source para ejecutar la secuencia de comandos apigee-service.sh:
      source /etc/profile.d/apigee-service.sh
  2. Actualiza los nodos de Postgres (principal y en espera):
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. En todos los nodos de Edge, ejecuta el script update.sh para el proceso de Edge:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Ejecuta la secuencia de comandos update.sh para el SSO en todos los nodos:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

Nuevas funciones

En esta versión, se incluye la siguiente función nueva:

TLS 1.3 para el tráfico de extremos descendentes

Esta versión agrega compatibilidad con TLS 1.3 para el tráfico de salida (tráfico entre un procesador de mensajes y el servidor de backend). Consulta Cómo configurar TLS 1.3 para el tráfico de salida para obtener más información.

Se corrigieron problemas de seguridad

En esta versión, no se corrigieron problemas de seguridad.

Cambios en el software compatible

En esta versión, no se realizaron cambios en el software compatible.

Bajas y retiros

En esta versión, no hay nuevas bajas ni descontinuaciones.

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
197529839

La falta de espacios finales después de los operadores de condición provocaba fallas en la implementación.

Esto se corrigió con un mejor manejo de los saltos de línea en las instrucciones condicionales de los proxies.
269545512

Se actualizó la versión del controlador de Postgres en Gateway y Monetización a la 42.5.4.

193007714

Faltaban algunas propiedades cuando se recuperaron los detalles del destino de un proxy como JSON.

Ya se solucionó este problema.
245387101

Se modificaron los datos de auditoría de las APIs relacionadas con las apps para desarrolladores.

Ahora, el secreto del consumidor se registra de forma coherente y enmascarada. Puedes establecer CWC conf_keymanagement_app.auditlog.mask.secret como falso en el servidor de administración para evitar que se enmascare el secreto, en caso de que desees registrar el secreto de texto simple en la auditoría.
260013493

Se agregaron correcciones para optimizar la carga de recursos de especificaciones de Open API como parte de la política de OASValidation.

Esto debería acelerar el tiempo de inicio del procesador de mensajes si este tiene que cargar muchos recursos de OAS. Esto también debería evitar que se generen registros de advertencia y error innecesarios mientras se cargan los proxies que contienen recursos de la OEA.
274587823

De forma predeterminada, no se permite la carga de entidades externas en la política XSLTransform.

Esto se puede habilitar configurando la marca conf_feature-flags_xsl.allow.external.entities=true en el procesador de mensajes.
260714664

Algunas tablas de Cassandra seguían usando SizeTieredCompactionStrategy de forma predeterminada.

Se cambió a LeveledCompactionStrategy. Ten en cuenta que este cambio solo se aplica a las instalaciones nuevas de Apigee Edge para la nube privada.
261631942

Se corrigió una regresión menor en una secuencia de comandos previa a la instalación de apigee-postgresql en la que fallaba la creación de una copia de seguridad de los archivos de configuración en algunas condiciones.

258898812

Se quitó el parámetro inesperado credentialsLoaded de la respuesta de la API para recuperar apps.

272136041

Los siguientes campos de la API, que se agregaron recientemente a Apigee, se pueden ver en Edge para la nube privada. Sin embargo, no tienen ningún efecto en Edge para la Nube privada, por lo que puedes ignorarlos de forma segura si los encuentras.

  • proxy_deployment_type
  • sense_action_id
  • sense_flag_headers
  • x_apigee_grpc_status
  • x_apigee_grpc_service_name
  • x_apigee_grpc_rpc_name

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