4.51.00.12 - Notes de version d'Edge for Private Cloud

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.
info

Le 30 mars 2023, nous avons lancé une nouvelle version d'Apigee Edge pour le cloud privé.

Remarque : Cette version sera compatible jusqu'au 30 mars 2024.

Procédure de mise à jour

Cette section explique comment installer cette version si vous effectuez une mise à jour à partir de la version de correctif précédente, 4.51.00.11. Si vous devez effectuer une mise à jour à partir d'une version antérieure, consultez la section Appliquer plusieurs versions de correctif.

L'installation de cette version mettra à jour les composants de la liste suivante 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

Vous pouvez vérifier les versions RPM que vous avez installées pour voir si elles doivent être mises à jour en saisissant :

apigee-all version

Pour mettre à jour votre installation, procédez comme suit sur les nœuds Edge :

  1. Sur tous les nœuds Edge :

    1. Nettoyez les dépôts Yum :
      sudo yum clean all
    2. Téléchargez le dernier fichier Edge 4.51.00 bootstrap_4.51.00.sh dans /tmp/bootstrap_4.51.00.sh :
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
    3. Installez l'utilitaire et les dépendances Edge 4.51.00 apigee-service :
      sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

      uName et pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus d'Apigee. Si vous omettez pWord, vous serez invité à le saisir.

    4. Utilisez la commande source pour exécuter le script apigee-service.sh :
      source /etc/profile.d/apigee-service.sh
  2. Mettez à jour les nœuds Postgres (maître et de secours) :
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Sur tous les nœuds Edge, exécutez le script update.sh pour le processus Edge :
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Exécutez le script update.sh pour l'authentification unique sur tous les nœuds :
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

Nouvelles fonctionnalités

Cette version introduit la nouvelle fonctionnalité suivante :

TLS 1.3 pour le trafic Southbound

Cette version est compatible avec TLS 1.3 pour le trafic Southbound (trafic entre un processeur de messages et le serveur backend). Pour en savoir plus, consultez la section Configurer TLS 1.3 pour le trafic Southbound.

Problèmes de sécurité résolus

Aucun problème de sécurité n'a été résolu dans cette version.

Modifications apportées aux logiciels compatibles

Aucune modification n'a été apportée aux logiciels compatibles dans cette version.

Abandon et mise hors service

Aucun abandon ni mise hors service n'ont été effectués dans cette version.

Correction de bugs

Cette section répertorie les bugs du cloud privé qui ont été corrigés dans cette version.

ID du problème Description
197529839

L'absence d'espaces de fin après les opérateurs de condition entraînait des échecs de déploiement.

Ce problème a été résolu grâce à une meilleure gestion des nouvelles lignes dans les instructions de condition des proxys.
269545512

Version du pilote Postgres mise à jour dans Gateway et Monetization vers la version 42.5.4.

193007714

Quelques propriétés étaient manquantes lorsque les détails de la cible d'un proxy étaient récupérés au format JSON.

Ce problème a été résolu.
245387101

Données d'audit modifiées des API associées à l'application du développeur.

Le secret client est désormais enregistré de manière cohérente de manière masquée. Vous pouvez définir CWC conf_keymanagement_app.auditlog.mask.secret sur "false" dans le serveur de gestion pour empêcher le masquage du secret, si vous souhaitez enregistrer le secret en texte brut dans l'audit.
260013493

Ajout de correctifs pour optimiser le chargement des ressources de spécification Open API dans le cadre de la règle OASValidation.

Cela devrait accélérer le temps de démarrage du processeur de messages si le processeur de messages doit charger de nombreuses ressources OAS. Cela devrait également empêcher la génération de journaux d'erreur et d'avertissement inutiles lors du chargement des proxys contenant des ressources OAS.
274587823

Les entités externes ne sont pas autorisées à être chargées par défaut dans la règle XSLTransform.

Vous pouvez activer cette fonctionnalité en définissant l'indicateur conf_feature-flags_xsl.allow.external.entities=true dans le processeur de messages.
260714664

Certaines tables Cassandra utilisaient toujours SizeTieredCompactionStrategy par défaut.

Cette valeur a été remplacée par LeveledCompactionStrategy. Notez que cette modification ne s'applique qu'aux nouvelles installations d'Apigee Edge pour le cloud privé.
261631942

Correction d'une régression mineure dans un script de pré-installation de apigee-postgresql où la sauvegarde des fichiers de configuration échouait dans certaines conditions.

258898812

Suppression du paramètre inattendu credentialsLoaded de la réponse de l'API lors de la récupération des applications.

272136041

Les champs d'API suivants, qui ont été récemment ajoutés à Apigee, sont visibles dans Edge pour le cloud privé. Toutefois, ils n'ont aucun effet dans Edge pour le cloud privé, vous pouvez donc les ignorer en toute sécurité si vous les rencontrez.

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

Problèmes connus

Pour obtenir la liste complète des problèmes connus, consultez la section Problèmes connus avec Edge pour le cloud privé.

Appliquer plusieurs versions de correctif

Cette section explique comment appliquer plusieurs versions de correctif si vous effectuez une mise à jour à partir de une version d'Edge pour le cloud privé antérieure à la version de correctif précédente.

Chaque version de correctif contient des mises à jour de composants spécifiques d'Edge pour le cloud privé, tels que edge-management-server. Pour appliquer plusieurs versions de correctif, vous devez mettre à jour chaque composant Edge inclus dans une version de correctif ultérieure à la version actuellement installée. Pour trouver ces composants, consultez les notes de version d'Edge pour le cloud privé pour toutes les versions ultérieures à votre version actuelle, puis vérifiez la liste des RPM pour ces versions. Consultez les notes de version d'Apigee pour obtenir des liens vers toutes les notes de version d'Edge pour le cloud privé.

Remarque : Vous n'avez besoin de mettre à jour chaque composant qu'une seule fois en installant le RPM pour la dernière version du composant inclus dans les versions de correctif. Suivez les instructions des notes de version pour cette version afin de mettre à jour le composant.

Remarque : La mise à niveau d'un composant installe automatiquement la dernière version de correctif d'un composant. Si vous souhaitez effectuer une mise à niveau vers une version de correctif qui n'est pas la dernière, vous devez conserver votre propre copie tarball du dépôt Apigee à l'aide du miroir Apigee et utiliser ce miroir pour les installations Apigee. Pour en savoir plus, consultez la section Utiliser un dépôt Edge local pour conserver votre version d'Edge.