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

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

Le 3 avril 2020, nous avons lancé la version 1.2.0 de l'environnement d'exécution Apigee hybrid.

Mise à niveau…

Nouvelles fonctionnalités et mises à jour

Vous trouverez ci-dessous les nouvelles fonctionnalités et mises à jour offertes par cette version.

Ajout d'une nouvelle configuration d'hôte virtuel pour spécifier des règles de routage

La nouvelle fonctionnalité de configuration virtualhosts résout le problème qui rendait incertain l'ordre dans lequel les chemins de base étaient acheminés vers plusieurs environnements. Pour plus d'informations, consultez la section Configurer les hôtes virtuels. (150336519)

Version bêta de la stratégie OASValidation

La règle OASValidation (validation de spécification OpenAPI) (bêta) vous permet de valider un message de requête ou de réponse entrant par rapport à une spécification OpenAPI 3.0 (JSON ou YAML). Pour plus d'informations, consultez la page Règle OASValidation (bêta). (144949685)

Version bêta de la compatibilité avec WebSocket

Apigee hybrid est compatible avec les connexions WebSocket. Les clients de proxy d'API peuvent désormais demander une mise à niveau du protocole de HTTP vers WebSockets. Pour en savoir plus, consultez la page Utiliser WebSockets (bêta).

Accéder aux valeurs de secret des règles à partir de secrets Kubernetes

Une nouvelle fonctionnalité vous permet d'accéder aux valeurs stockées dans un secret Kubernetes dans les variables de flux de proxy. Pour en savoir plus, consultez la page Stocker des données dans un secret Kubernetes. (133377603)

L'élément Apigee Operator (AO) remplace ADAC et ADAH

Apigee Operators (AO) crée et met à jour les ressources Kubernetes et Istio de bas niveau qui sont nécessaires au déploiement et à la gestion d'AD. Par exemple, le contrôleur effectue le lancement des processeurs de message. Il valide également la configuration ApigeeDeployment avant de la conserver dans le cluster Kubernetes. AO remplace Apigee Deployment Admissionhook (ADAH) et Apigee Deployment Controller (ADC). Pour plus d'informations, consultez la section sur AO dans la documentation de référence sur les propriétés de configuration. (151250559)

Remplacement et abandon de certaines propriétés de configuration de cluster et de projet

Deux nouvelles propriétés de configuration ont été ajoutées : k8sCluster et gcp. Ces propriétés remplacent les propriétés obsolètes suivantes : k8sClusterName, gcpRegion et gcpProjectID. Pour en savoir plus, consultez la documentation de référence sur les propriétés de configuration. (146299599)

Expansion des volumes persistants pour Cassandra sur Kubernetes

Un processus a été ajouté pour augmenter la taille d'un volume persistant utilisé par apigee-cassandra afin de répondre aux besoins de stockage. Il n'est donc plus nécessaire d'ajouter des nœuds dans le seul but d'augmenter l'espace de stockage. Pour plus d'informations, consultez la page Développer des volumes persistants Cassandra. (138167919)

Compatibilité avec des sources supplémentaires pour les certificats, les clés de chiffrement et les autorités de contrôle

De nouvelles propriétés de configuration ont été ajoutées pour offrir une plus grande flexibilité dans la spécification des certificats TLS, des clés de chiffrement et des clés de compte de service. Les nouvelles propriétés sont répertoriées ci-dessous :

  • kmsEncryptionPath
  • kmsEncryptionSecret.key
  • kmsEncryptionSecret.name
  • cassandra.backup.serviceAccountSecretRef
  • cassandra.restore.serviceAccountSecretRef
  • envs[].cacheEncryptionPath
  • envs[].cacheEncryptionSecret.key
  • envs[].cacheEncryptionSecret.name
  • envs[].kmsEncryptionPath
  • envs[].kmsEncryptionSecret.key
  • envs[].kmsEncryptionSecret.name
  • envs[].serviceAccountSecretRefs.synchronizer
  • envs[].serviceAccountSecretRefs.udca
  • envs[].sslSecret
  • logger.serviceAccountSecretRef
  • mart.serviceAccountSecretRef
  • mart.sslSecret
  • metrics.serviceAccountSecretRef
  • synchronizer.serviceAccountSecretRef
  • udca.serviceAccountSecretRef

Pour plus d'informations, consultez la documentation de référence sur les propriétés de configuration. (145303466)

Autoriser les clients à obscurcir les données avant de les envoyer pour analyse

Une fonctionnalité a été ajoutée pour vous permettre d'obscurcir certaines données d'analyse avant de les envoyer au plan de gestion. Pour en savoir plus, consultez la page Obscurcir les données utilisateur pour l'analyse. (142578910)

Expansion des volumes persistants pour les StatefulSets

Une fonctionnalité a été ajoutée pour permettre d'augmenter la taille d'un volume persistant utilisé par apigee-cassandra afin de répondre aux besoins de stockage sans augmenter la puissance de calcul. Pour plus d'informations, consultez la page Développer des volumes persistants pour les StatefulSets. (138167919)

Mise à jour des versions minimales compatibles de GKE, d'Anthos et d'AKS

Apigee hybrid est désormais compatible avec GKE 1.14.x, Anthos 1.2 et AKS 1.14.x. (149578101)

Compatibilité avec TLS 1.3 pour les connexions Northbound

Deux nouvelles propriétés de configuration vous permettent de définir la version minimale et maximale de TLS pour l'entrée : ingress.minTLSProtocolVersion et maxTLSProtocolVersion. Les valeurs possibles sont 1.0, 1.1, 1.2 et 1.3. Pour plus d'informations, consultez la documentation de référence sur les propriétés de configuration. (117580780)

Possibilité de configurer le proxy direct pour l'environnement d'exécution hybride

Le proxy direct HTTP est désormais compatible avec les proxys d'API déployés dans un environnement. Pour en savoir plus, consultez la page Configurer le proxy direct. (148970527)

Compatibilité avec plusieurs hostAliases par environnement

Une nouvelle propriété de configuration, envs[].hostAliases, a été ajoutée. Cette propriété vous permet d'ajouter plusieurs alias d'hôte à un environnement. Utilisez cet élément à la place de hostAlias, qui est obsolète. Pour plus d'informations, consultez la page Ajouter plusieurs alias d'hôte à un environnement. (150738495)

Autoriser les modèles pour les ensembles de propriétés

Un nouvel élément <PropertySetRef> a été ajouté à l'élément <AssignVariable> de la règle <AssignMessage>. <PropertySetRef> vous permet de créer une paire nom/clé d'ensemble de propriétés de façon dynamique. Cette fonctionnalité n'est disponible que pour les proxys d'API déployés sur Apigee hybrid. Consultez AssignVariable. (148612340)

Bugs résolus

Les bugs suivants sont résolus dans cette version. Cette liste s'adresse principalement aux utilisateurs qui veulent vérifier si un correctif a été émis en réponse à leurs demandes d'assistance. Elle n'est pas conçue pour fournir des informations détaillées à tous les utilisateurs.

ID du problème Nom du composant Description
147958049 Exécution Correction d'un problème de synchronisation dans le séquencement du démarrage de l'environnement d'exécution, qui empêchait parfois le synchronisateur de démarrer correctement.
149867244 Plate-forme K8S Échec du pod apigee-cps-setup dans la configuration multirégionale.
150187652 / 149117839 Exécution Impossible d'utiliser des tirets dans les noms d'environnement.
149220463 Pod MP Les proxys précédemment déployés devaient être déployés à nouveau.
144321144 Exécution Impossible de recharger les proxys avec des hôtes virtuels sécurisés.
147685310 Exécution Échec de l'initialisation de l'outil de synchronisation en raison de l'échec de la récupération du jeton GCP lors de l'initialisation.
151115900 Exécution La vérification interne périodique n'apparaît pas pour HybridMART, ce qui entraîne de faux résultats.

Problèmes connus

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

Problème Description
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.
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).