Notes de version de l'environnement d'exécution Apigee hybrid 1.1.0

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

Le 27 janvier 2020, Google a lancé la version 1.1.0 de l'environnement d'exécution Apigee hybrid. Cette section décrit les nouvelles fonctionnalités et les modifications apportées à la version 1.1.0.

Mise à niveau…

Vous ne pouvez pas passer de la version 1.0.0 à la version 1.1.0, et la nouvelle version n'est pas rétrocompatible avec la version 1.0.0. La version 1.1.0 nécessite une nouvelle installation.

Nouvelles fonctionnalités et améliorations

Apigee Connect (version alpha)

La version alpha d'Apigee Connect permet au service MART d'Apigee hybrid de se connecter au plan de gestion sans avoir à exposer le point de terminaison MART. Si vous utilisez Apigee Connect, vous n'avez pas besoin de configurer la passerelle d'entrée MART avec un alias d'hôte et un certificat DNS autorisé. Pour en savoir plus, contactez votre représentant Apigee.

Routage du chemin de base

Le routage du chemin de base vous permet de configurer et de gérer la manière dont Apigee hybrid achemine les appels de proxy d'API vers des environnements spécifiques. Pour en savoir plus, consultez la section Configurer le routage du chemin de base.

Changements

Les modifications suivantes ont été apportées à la version 1.1.0 de l'environnement d'exécution hybride. Certaines de ces modifications, comme indiqué, ne sont pas rétrocompatibles avec la version 1.0.0.

  • La CLI apigeectl installe maintenant Istio dans l'espace de noms istio-system. Il s'agit de l'espace de noms par défaut pour Istio. Cette modification est incompatible avec la version hybride 1.0.0.
  • La CLI apigeectl installe maintenant CertManager dans l'espace de noms cert-manager. Cette modification est incompatible avec la version hybride 1.0.0.
  • La version compatible d'Istio déployée avec l'environnement d'exécution Apigee hybrid a été migrée vers la version 1.4.2, car la version 1.2.x n'est plus compatible.

Bugs résolus

Les problèmes suivants répertoriés dans les notes de version d'Apigee hybrid 1.0.0 ont été corrigés :

Problème Description
144886537 Le routage du chemin de base ne fonctionne pas dans la version 1.0.0 d'Apigee hybrid. Lorsque les remplacements sont configurés pour être acheminés vers différents environnements avec le même alias d'hôte, l'entrée ne les achemine pas vers un environnement en fonction du chemin.
143774187 L'interface utilisateur hybride affiche le libellé "Entreprise" dans la vue des applications.

Problèmes connus

Le tableau suivant décrit les problèmes connus de cette version :

Problème Description
N/A Vous ne pouvez pas utiliser un "*" pour la propriété hostAlias dans les configurations mart et envs. Il est recommandé d'utiliser un nom d'hôte spécifique pour la configuration mart.
N/A La définition des variables HTTP_PROXY, HTTPS_PROXY et NO_PROXY n'est pas prise en charge dans la version Alpha d'Apigee Connect.
N/A

Erreur d'en-tête HTTP non valide : l'entrée Istio transfère toutes les réponses cibles entrantes au protocole HTTP2. Comme le processeur de messages hybride n'accepte que le protocole HTTP1, vous pouvez rencontrer l'erreur suivante lorsqu'un proxy d'API est appelé :

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

Si cette erreur s'affiche, vous pouvez effectuer l'une des actions suivantes pour corriger le problème :

  • Modifiez le service cible pour omettre l'en-tête d'hôte dans la réponse.
  • Si nécessaire, supprimez l'en-tête d'hôte à l'aide de la règle AssignMessage dans votre proxy d'API.
144584813 Si vous créez une session de débogage, mais qu'elle ne comporte pas encore de transactions, l'API List Debug Sessions ne l'inclut pas dans la liste. L'API n'inclut les sessions dans la réponse que si elles contiennent au moins une transaction.
144436206 Dans la vue Performances des caches, le calcul du taux d'accès au cache est incorrect.
144321491 Apigee hybrid enregistre les notifications "Création de cache manquant" indiquant une dégradation potentielle des performances. Ces messages sont attendus et peuvent être ignorés.
144321144 Les proxys avec des hôtes virtuels sécurisés ne peuvent pas être actualisés.
144286363

Le masque de débogage dans env.json ne masque pas les données de réponse.

L'API suivante ne permet pas de mettre à jour le masque de débogage "env.json" avec un champ "responseJSONPaths" :

PATCH /v1/organizations/org/environments/env/debugmask?replaceRepeatedFields=true
{
  "responseJSONPaths": ["$.maskedDataEnv"]
}

Pour contourner ce problème avec Trace, vous pouvez supprimer l'intégralité d'une session Trace dans l'interface utilisateur ou utiliser les API Trace pour supprimer des transactions individuelles dans une session.
143659917

Le paramètre d'expiration de la règle PopulateCache doit être défini sur une valeur explicite comprise entre 1 et 30. Exemple : 

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

Résumé : La latence est très élevé lorsque vous utilisez l'API ou l'interface utilisateur pour obtenir l'état de déploiement de votre organisation. Cette latence peut aboutir à une réponse HTTP 204 (No Content) ou HTTP 400 (Bad Request).

Solution : actualisez votre navigateur (ou renvoyez la requête).