4.51.00.12: Notas de la versión de Edge para la nube privada

Estás viendo la documentación de Apigee Edge.
Ve a la documentación de Apigee X.
Información

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 realizar una actualización desde una versión anterior, consulta Aplica varias versiones de parche.

Si instalas esta versión, se actualizarán 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

Puedes verificar las versiones de RPM que tienes instaladas actualmente para ver si deben actualizarse. Para ello, ingresa lo siguiente:

apigee-all version

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

  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 más reciente de Edge 4.51.00 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

      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
  2. Actualiza los nodos de Postgres (instancia principal y en espera):
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. En todos los nodos perimetrales, ejecuta la secuencia de comandos update.sh para el proceso perimetral:
    /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

Funciones nuevas

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

TLS 1.3 para el tráfico hacia el sur

Esta versión agrega compatibilidad con TLS 1.3 para el tráfico de dirección sur (tráfico entre un procesador de mensajes y el servidor de backend). Si deseas obtener más información, consulta Configura TLS 1.3 para el tráfico hacia el sur.

Problemas de seguridad solucionados

No se corrigieron problemas de seguridad en esta versión.

Cambios en el software compatible

No se realizaron cambios en el software compatible en esta versión.

Bajas y retiros

No hay nuevas bajas ni retiros en esta versión.

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

Falta de espacios finales después de que los operadores de condiciones fueran la causa de las fallas de implementación.

Esto se solucionó mediante el manejo mejorado de las líneas nuevas en las declaraciones de estado de los proxies.
269545512

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

193007714

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

Ya se solucionó este problema.
245387101

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

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

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

Esto debería acelerar el tiempo de inicio del procesador de mensajes si MP debe cargar muchos recursos OAS. Esto también debería evitar errores innecesarios y advertencias que se generen registros mientras se cargan los proxies que contienen recursos de OAS.
274587823

Las entidades externas no se pueden cargar de forma predeterminada en la política XSLTransform.

Para habilitarlo, configura la marca conf_feature-flags_xsl.allow.external.entities=true en el procesador de mensajes.
260714664

Algunas tablas de Cassandra aún usaban SizeTieredCompactionStrategy de forma predeterminada.

Se cambió a LeveledCompactionStrategy. Ten en cuenta que este cambio solo se aplica a instalaciones nuevas de Apigee Edge para 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 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 sobre la recuperación de 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 efecto en Edge para la nube privada, por lo que puedes ignorarlas de forma segura si las encuentras.

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

Errores conocidos

Consulta Problemas conocidos de Edge para la nube privada a fin de obtener una lista completa de los problemas conocidos.

Aplica varias versiones de parche

En esta sección, se describe cómo aplicar varias versiones de parche en caso de que estés actualizando 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 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 incluido 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 nube privada de todas las versiones posteriores a la actual y revisa la lista de RPM de esas versiones. Consulta las Notas de la versión de Apigee para ver los vínculos a todas las notas de la versión de Edge para 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 que se indican en las notas de la versión para actualizar el componente.

Nota: La actualización de un componente instala automáticamente la versión de parche más reciente de un componente. Si deseas actualizar a una versión de parche que no es la más reciente, debes mantener tu propia copia de archivo comprimido del repositorio de Apigee con la duplicación de Apigee y usar esta duplicación para las instalaciones de Apigee. Para obtener más información, consulta Usa un repositorio de Edge local para mantener tu versión de Edge.