4.19.01.03 - Notes de version d'Edge for Private Cloud

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

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

Procédure de mise à jour

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

  1. Sur tous les nœuds périphériques:

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

      uName:pWord correspondent au nom d'utilisateur et au mot de passe que vous avez reçus de la part d'Apigee. Si vous omettez pWord, vous êtes invité à le faire.

    4. Mettez à jour l'utilitaire apigee-setup :
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. Utilisez la commande source pour exécuter le script apigee-service.sh :
      source /etc/profile.d/apigee-service.sh
  2. Mettez à jour l'utilitaire apigee validate :
    sudo /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  3. Importez le nouveau proxy SmartDocs à partir du fichier smartdocs.zip dans le répertoire /opt/apigee/apigee-validate/bundles et déployez-le en tant que nouvelle révision. Le nouveau proxy doit être importé dans l'organisation où SmartDocs est actuellement configuré. Le déploiement du proxy en tant que nouvelle révision facilitera le rollback, si nécessaire.

    Remarque: Avant le déploiement, vérifiez que <VirtualHost> du nouveau proxy correspond à la configuration <VirtualHost> actuellement définie dans votre environnement. Si ce n'est pas le cas, modifiez-le avant de le déployer.

  4. À partir de l'interface utilisateur Edge, créez et mettez à jour un KVM nommé "smartdocs_playlist", comme illustré dans la figure ci-dessous. La KVM doit être créée dans l'organisation et l'environnement dans lesquels le proxy SmartDocs est actuellement déployé.

    Remarque: Assurez-vous que la case encrypted n'est PAS cochée.

    • Ajoutez une clé nommée "is_playlist_structured", avec la valeur "YES".
    • Ajoutez une deuxième clé nommée "allowed_hosts", où les valeurs sont des noms d'hôte séparés par des espaces ou des adresses IP appelés à partir de SmartDocs. La valeur "allowed_hosts" doit inclure tous les hôtes inclus dans les spécifications OpenAPI ajoutés à SmartDocs. Par exemple, si vous disposez d'une spécification OpenAPI qui appelle mocktarget.apigee.net, vous devez ajouter mocktarget.apigee.net à la valeur "allowed_hosts". Si un hôte n'est pas inclus dans le KVM, la réponse SmartDocs sera 400 Bad Request avec une charge utile de contenu de Bad Request-Hostname not permitted
    Interface de création KVM Remarque: Si vous n'ajoutez et ne configurez pas ce KVM, le proxy n'appliquera pas la liste blanche. Cela peut entraîner un accès non autorisé à vos hôtes et à vos adresses IP. Seuls les noms d'hôte et les adresses IP des points de terminaison de l'API documentés avec SmartDocs doivent être inclus dans les valeurs "allowed_hosts".

Logiciels compatibles

Aucune

Abandons et retraits

Aucune

Bugs résolus

Le tableau suivant répertorie les bugs corrigés dans cette version:

ID du problème Description
145340106

Faille de l'API Apigee SmartDocs

Mise à jour du proxy Apigee SmartDocs pour corriger les failles de sécurité. Pour en savoir plus et connaître les étapes requises, consultez la section Procédure de mise à jour.