4.53.00.05 - Notes de version d'Edge pour le cloud privé

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

Le 21 juillet 2025, nous avons lancé une nouvelle version d'Apigee Edge pour le cloud privé.

Procédure de mise à jour

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

La mise à jour de cette version mettra à jour les composants listés ci-dessous :

  • edge-gateway-4.53.00-0.0.60310.noarch.rpm
  • edge-management-server-4.53.00-0.0.60310.noarch.rpm
  • edge-message-processor-4.53.00-0.0.60310.noarch.rpm
  • edge-postgres-server-4.53.00-0.0.60310.noarch.rpm
  • edge-qpid-server-4.53.00-0.0.60310.noarch.rpm
  • edge-router-4.53.00-0.0.60310.noarch.rpm
  • apigee-qpidd-8.0.6-0.0.2540.noarch.rpm
  • apigee-setup-4.53.00-0.0.1151.noarch.rpm
  • apigee-sso-4.53.00-0.0.21590.noarch.rpm
  • apigee-tomcat-9.0.106-0.0.957.noarch.rpm
  • edge-uapim-4.53.00-0.0.60313.noarch.rpm
  • edge-uapim-connector-4.53.00-0.0.60313.noarch.rpm
  • edge-mint-gateway-4.53.00-0.0.40542.noarch.rpm
  • edge-mint-management-server-4.53.00-0.0.40542.noarch.rpm
  • edge-mint-message-processor-4.53.00-0.0.40542.noarch.rpm

Vous pouvez vérifier si les versions RPM actuellement installées 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.53.00 bootstrap_4.53.00.sh dans /tmp/bootstrap_4.53.00.sh :
      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
    3. Installez l'utilitaire apigee-service Edge 4.53.00 et les dépendances :
      sudo bash /tmp/bootstrap_4.53.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
    5. Mettez à jour l'utilitaire apigee-setup :
      apigee-service apigee-setup update
  2. Sur tous les nœuds Edge, exécutez le script update.sh pour le processus edge (y compris la monétisation) :
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. Sur tous les nœuds Qpid, exécutez le script update.sh :
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Si vous utilisez l'authentification unique, exécutez la commande suivante :
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

Correction de bugs

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

ID du problème Description
429056579 Correction du script wait_for_ready de qpid.
391852306 Correction des échecs de tarification des transactions de monétisation après des modifications de fuseau horaire.

Améliorations

Cette section liste les améliorations apportées dans cette version.

ID du problème Description
430665793 Ajout d'une journalisation supplémentaire pour les opérations de clé et de certificat lors du démarrage du processeur de messages.
366144787 L'API de monétisation a été ajoutée pour faciliter la synchronisation des données à la demande pour les entités individuelles.

Problèmes de sécurité résolus

ID du problème Description
391546513 Résolution de plusieurs problèmes de sécurité liés à la monétisation.

Intégration du connecteur Edge pour le cloud privé API Hub

Cette version inclut la prise en charge du connecteur hub d'API Apigee pour l'intégration au cloud privé, ce qui permet aux organisations de synchroniser les métadonnées d'API et les analyses d'exécution avec Google Cloud API Hub. L'intégration inclut un nouveau binaire de connecteur hub d'API Apigee et des améliorations apportées au processeur de messages, qui exporte les données d'exécution vers un système de fichiers réseau (NFS). Le connecteur API Hub pour le cloud privé consomme ces données et les publie dans API Hub. Aucun bug n'a été corrigé et aucun changement n'a été apporté au comportement existant d'Apigee Edge pour le cloud privé. Pour en savoir plus sur l'intégration du connecteur Edge pour le cloud privé API Hub, consultez la présentation et le flux d'intégration du connecteur API Hub.

Points clés :

  • Nouveau binaire de connecteur Apigee API Hub
  • Améliorations apportées au processeur de messages pour exporter les données d'exécution vers NFS
  • Prise en charge complète de la publication des métadonnées d'API et des données d'exécution dans API Hub
  • Activation basée sur l'acceptation à l'aide du connecteur standard du hub d'API Apigee pour le flux d'API du cloud privé
  • Nouvelle intégration d'API avec le connecteur pour permettre l'importation d'environnements et de bundles de proxy
  • Une nouvelle autorisation IAM (roles/apihub.admin) est désormais requise pour que le compte de service du connecteur puisse activer la nouvelle fonctionnalité d'API

Masquage des informations permettant d'identifier personnellement l'utilisateur (PII)

Cette fonctionnalité garantit la confidentialité des données et la conformité en vous permettant de masquer les données sensibles dans les bundles de proxy d'API et de flux partagés avant qu'ils ne soient synchronisés avec API Hub.

  • Masques par défaut : le connecteur applique automatiquement une liste intégrée d'expressions XPath (masques par défaut) pour masquer les sources connues d'informations permettant d'identifier personnellement des utilisateurs dans les configurations de règles (par exemple, les mots de passe d'authentification de base codés en dur, les clés privées dans les règles JWT/JWS).
  • Masques personnalisés : vous pouvez configurer des masques personnalisés supplémentaires en définissant la propriété conf_uapim_connector.uapim.mask.xpaths dans le fichier /opt/apigee/customer/application/uapim-connector.properties, ce qui vous permet de cibler des champs sensibles spécifiques aux clients.

Réconciliation de l'organisation (remplissage)

Le connecteur fournit désormais un processus défini pour réconcilier (ou remplir) l'ensemble des métadonnées d'API d'une organisation Apigee existante avec API Hub.

  • Processus : la réconciliation est obtenue en désactivant temporairement une organisation de la configuration du connecteur (en effaçant les valeurs des propriétés runtimeDataPubsub et metadataPubsub), puis en la réactivant immédiatement (en restaurant les valeurs).
  • Fonction : cette action force le connecteur à effectuer une récupération complète et une resynchronisation complète de toutes les métadonnées de l'organisation spécifiée, ce qui résout les éventuelles incohérences de données.

Modifications apportées aux logiciels compatibles

Tomcat v9.0.106 est compatible. Pour obtenir la liste complète des logiciels compatibles, consultez la section Logiciels compatibles avec Edge pour le cloud privé.

Abandon et mise hors service

Aucun abandon ni mise hors service n'est prévu dans cette version.

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 précédente du correctif.

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 à votre version actuellement installée. Vous pouvez trouver ces composants en consultant les notes de version d'Edge pour le cloud privé pour toutes les versions ultérieures à votre version actuelle, et en vérifiant 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 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 d'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 Edge.