4.16.05 - Notes de version d'Edge for Private Cloud

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

Le mardi 31 mai 2016, nous avons lancé une nouvelle version d'Apigee Edge pour le cloud privé.

Depuis la version précédente de la fonctionnalité Edge for Private Cloud (4.16.01), les versions suivantes ont eu lieu et sont incluses dans cette version de fonctionnalité:

Consultez la section À propos de la numérotation de version pour comprendre comment déterminer si une version spécifique du cloud est incluse dans votre version d'Edge for Private Cloud.

Nouvelles fonctionnalités et améliorations

Voici les nouvelles fonctionnalités et améliorations de cette version. Outre les améliorations suivantes, cette version inclut plusieurs améliorations en termes de facilité d'utilisation, de performances, de sécurité et de stabilité.

Pour plus de détails et d'instructions, consultez la documentation Edge pour le cloud privé.

Guides d'installation et d'utilisation mis en ligne

Vous pouvez désormais accéder au guide d'installation et d'utilisation d'Edge pour le cloud privé dans la version 4.18.01.

Mises à jour logicielles

Les mises à jour logicielles suivantes sont incluses dans cette version:

  • Java JDK 1.8 : afin de bénéficier des dernières fonctionnalités Java, cette version est compatible avec Java 1.8. Oracle JDK 1.8 ou OpenJDK 8 est requis dans votre environnement.
    Dans le cadre de la mise à jour de Java 8, certains algorithmes de chiffrement TLS ne sont plus disponibles dans Oracle JDK 1.8. Pour obtenir la liste complète, consultez la section "Default Disabled Cipher Suites" (Suites de chiffrement désactivées par défaut) http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13 : mise à jour depuis Cassandra 2.0.15.

Installation, mise à niveau, rollback

Vous trouverez ci-dessous la liste des modifications apportées aux scripts d'installation et de mise à niveau, ainsi qu'aux scripts associés. Pour plus d'informations sur son utilisation, consultez la documentation Edge pour le cloud privé.

  • New process to update from 4.16.01 : cette version remplace l'utilitaire apigee-migrate par l'utilitaire update.sh pour mettre à jour votre installation de la version 4.16.01 à la version 4.16.05. Consultez la section Mettre à jour Apigee Edge de la version 4.16.01 à la version 4.16.05.
  • Amorçage
    • bootstrap.sh (la version 4.16.01) est désormais bootstrap_4.16.05.sh dans la version 4.16.05.
    • Vous n'avez plus besoin de spécifier uname:pword pour télécharger bootstrap_4.16.05.sh.
  • Rollback : Pour effectuer un rollback vers une mise à jour vers la version 4.16.05, désinstallez la version 4.16.05 du composant et réinstallez la version précédente. L'utilitaire rollback.sh précédent a été supprimé. Consultez la section 4.16.05 Processus de rollback.
  • setup.sh et update.sh peuvent écrire le fichier journal dans /tmp. Par défaut, les utilitaires setup.sh et update.sh écrivent les informations de journal dans /opt/apigee/var/log/apigee-setup. Si l'utilisateur qui exécute l'utilitaire n'a pas accès à ce répertoire, il écrit le journal dans le répertoire /tmp. Si l'utilisateur n'a pas accès à /tmp, l'utilitaire échoue.
  • Procédure de mise à jour des API BaaS : dans la version 4.16.01, vous avez dû réinstaller l'API BaaS pour la migrer. Le nouvel utilitaire update.sh prend en charge la mise à jour des BaaS des API. Consultez la section Mettre à jour Apigee Edge de la version 4.16.01 à la version 4.16.05.

Administration

Vous trouverez ci-dessous les nouvelles fonctionnalités d'administration et de configuration du cloud privé.

  • Validation de l'installation : L'utilitaire apigee-validate utilisé pour tester votre installation Edge Private Cloud peut désormais être exécuté à partir du serveur de gestion. Auparavant, le script devait être exécuté sur le processeur de messages. Consultez la section Tester l'installation.
  • Nom de la région : vous pouvez indiquer n'importe quel nom pour la région. Dans les versions précédentes, le nom était sous la forme "dc-#", où # correspondait à un nombre entier.
  • Pods de passerelle : les pods de passerelle peuvent avoir n'importe quel nom. Dans les versions précédentes, le pod devait être nommé "gateway".
  • Administration basée sur des scripts : un nouvel utilitaire de ligne de commande apigee-adminapi.sh vous permet d'effectuer les mêmes tâches de configuration Edge que celles effectuées en appelant l'API de gestion Edge. Consultez la section Utiliser l'utilitaire apigee-adminapi.sh.
  • Configuration silencieuse SSL de l'hôte virtuel : lors de la création d'une organisation ou d'un environnement, vous pouvez désormais transmettre des propriétés pour configurer SSL sur un hôte virtuel. Consultez Intégrer une organisation.

Services d'API

Vous trouverez ci-dessous les nouvelles fonctionnalités des services d'API Edge, fournies dans les versions cloud précédentes du produit.

Préfixe de longueur fixe pour la journalisation des messages syslog (Cloud 16.03.30)

La stratégie de journalisation des messages comporte un nouvel élément <FormatMessage> dans la configuration Syslog. Lorsque vous définissez <FormatMessage>true</FormatMessage>, les messages Syslog commencent par un nombre fixe de caractères, ce qui vous permet de filtrer les données insérées par Apigee. Pour en savoir plus, consultez la section Règle de journalisation des messages. (APIRT-1398).

Caractère générique dans le chemin de base du proxy d'API (interface utilisateur Cloud 16.03.09)

L'interface utilisateur de gestion prend en charge l'utilisation d'un ou plusieurs caractères génériques /*/ dans les chemins d'accès de base des proxys d'API. Par exemple, un chemin de base de /team/*/members permet aux clients d'appeler votre proxy avec https://[host]/team/blue/members ou https://[host]/team/green/members sans que vous ayez à créer un proxy pour prendre en charge les nouvelles équipes. Notez que /**/ n'est pas autorisé. (MGMT-3154)

Enchaînement de proxys d'API (interface utilisateur Cloud 16.03.02, Cloud 16.03.09)

Edge prend en charge le chaînage de proxys d'API locaux, ce qui permet à un proxy d'API d'appeler un autre proxy d'API déployé dans votre organisation Edge sans surcharge réseau supplémentaire. Auparavant, le chaînage de proxys d'API nécessitait un appel http(s) vers un autre proxy d'API, qui transmettait la requête via un équilibreur de charge, un routeur et un processeur de messages.

De nouveaux éléments LocalTargetConnection sont disponibles sur le point de terminaison TargetEndpoint d'un proxy d'API, vous permettant de spécifier un nom de proxy d'API, le nom d'un proxy d'API spécifique dans un proxy d'API ou simplement le chemin de base vers une ressource de proxy d'API locale (telle que /v1/myresource). L'interface utilisateur de l'éditeur de proxy fournit également ces options lorsque vous ajoutez ou mettez à jour un TargetEndpoint.

Le chaînage de proxy est également disponible dans les règles d'appel de service.

Pour plus d'informations, consultez la section Enchaîner des proxys d'API ensemble. Les nouveaux éléments LocalTargetConnection sont également répertoriés dans le schéma XML disponible à l'adresse suivante: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

Bugs résolus

Les bugs suivants sont résolus dans cette version. Cette liste est principalement destinée aux utilisateurs qui souhaitent vérifier si leurs demandes d'assistance ont été corrigées. Elle n'est pas conçue pour fournir des informations détaillées à tous les utilisateurs.

Edge pour Private Cloud 4.16.05

ID du problème Description
PRC-770 Le programme d'installation 16.01 ne parvient pas à enregistrer le serveur de secours Postgres dans axgroup
PRC-758 Un utilisateur disposant du rôle "Utilisateur" peut modifier des rapports personnalisés
PRC-883 Échec de la mise à jour sur le serveur Postgres avec la configuration de mise en veille maître

Cloud 16.03.30

ID du problème Description
SECENG-584 La vérification de validation de l'ajout de ligne entre les certificats d'une chaîne de certificats entraîne des problèmes avec certains certificats en production
MGMT-3217 Les appels de l'API Management échouent si le nom KVMap se termine par "keys"
MGMT-3214 Des conflits de classes peuvent se produire lors d'accroches Java qui entraînent l'échec du code Java d'un client
MGMT-3185 Erreur lors de l'ajout d'administrateurs de l'organisation à une organisation
EDGEUI-127 Obtenir des autorisations insuffisantes avec le nouvel éditeur de proxy
EDGEUI-119 Problème d'expiration de la session d'UI
CORESERV-671 Le message d'erreur "Aucun anneau configuré ; impossible d'initialiser le service cps" s'affiche
AXAPP-2345 Problème lié à la création de listes de rapports personnalisés AX pour les clients non-CP
AXAPP-2302 Le résumé quotidien des analyses Apigee indique que l'adoption par les développeurs est nulle
APIRT-2750 Échecs de trafic fréquents dans une organisation spécifique
APIRT-2516 Les erreurs d'exécution dans les accroches JavaScript indiquent des numéros de ligne incorrects
APIRT-2508 Erreur de sortie lors de l'appel de l'écoute express dans un rappel Vault
APIRT-2336 Problème gzip avec Node.js
APIRT-1975 Les configurations de masque ne fonctionnent pas pour message.content

UI Cloud 16.03.16

ID du problème Description
MGMT-3142 Les graphiques ne se chargent pas dans le tableau de bord d'analyse des erreurs (correction mise à jour)

Interface utilisateur Cloud 16.03.09

ID du problème Description
MGMT-3158 Autorisations insuffisantes dans l'interface utilisateur lorsque RBAC sur des proxys individuels est défini via l'API
MGMT-3142 Les graphiques ne se chargent pas dans le tableau de bord d'analyse des erreurs
MGMT-3118 L'interface utilisateur affiche une configuration d'hôte virtuel SSL incorrecte pour le paramètre "clientAuthEnabled"
DEVRT-2344 Les définitions de rapport portant sur une seule journée ne chargent pas les transactions dans l'interface utilisateur

Cloud 16.03.02

ID du problème Description
MGMT-3083 L'actualisation automatique des journaux Node.js est trop détaillée avec les messages de journal
DEVRT-2275 Les plans tarifaires d'attributs personnalisés n'affichent que cinq attributs au lieu des dix autorisés
DEVRT-1275 Tous les développeurs ne figurent pas dans le menu déroulant "Plan tarifaire"
DEVRT-1074 Un développeur prépayé avec un solde nul génère une exception NullpointerException lorsque le crédit est appliqué

Cloud 16.02.17

ID du problème Description
MGMT-3083 L'actualisation automatique des journaux Node.js est trop détaillée avec les messages de journal
MGMT-3077 L'interface utilisateur génère un groupe de proxys non valide à partir d'un WSDL qui utilise l'espace de noms par défaut
MGMT-1642 Le rôle utilisateur personnalisé ne dispose pas de l'autorisation "get" pour les applications de développement

Problèmes connus

Cette version présente les problèmes connus suivants.

ID du problème Description
APIRT-2978

Le routeur ne parvient pas à démarrer Nginx ou le routeur ne démarre pas

Si le routeur Edge ne parvient pas à démarrer Nginx ou ne démarre pas, comme indiqué dans le fichier /opt/apigee/var/log/edge-router/logs/system.log, supprimez tous les fichiers du répertoire /opt/nginx/conf.d et redémarrez le routeur:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
APIRT-3364

Le processeur de messages effectue la résolution DNS sur IPv4 et IPv6

Si vous avez installé et activé NSCD (Name Service Cache Daemon), vous remarquerez peut-être que les processeurs de messages effectuent deux résolutions DNS: une pour IPv4 et une pour IPv6.

Pour désactiver la résolution DNS sur IPv6:

  1. Sur chaque nœud de processeur de messages, modifiez /etc/nscd.conf.
  2. Définissez la propriété suivante:

    enable-cache hosts no
PRC-1118

Erreur lors de l'exécution de la commande "apigee-service apigee-postgresql pg-data-purge"

Si vous exécutez la commande "apigee-service apigee-postgresql pg-data-purge" et une erreur s'affiche sous la forme suivante:

ERREUR: Vous devez être le propriétaire de la relation

Modifiez /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge et définissez la propriété suivante sur "apigee":

POSTGRES_USER=apigee
DOC-1687 En raison d'un conflit de dépendances de packages connu, l'agent Katello utilisé dans Satellite Server 6 ne s'installe pas correctement sur les hôtes Apigee Edge exécutant le daemon Qpid.

Charges utiles JSON dans les stratégies d'attribution de message, d'appel Java et de déclenchement de pannes

Les stratégies "Attribuer un message", "Accroche Java" et "Signaler des erreurs" vous permettent de générer le contenu du message à l'aide de l'élément <Set><Payload>. Dans ces messages, vous pouvez inclure des variables dont les valeurs sont renseignées automatiquement au moment de l'exécution. Par exemple, si vous souhaitez afficher la date dans l'en-tête HTTP, vous pouvez insérer {message.header.date} dans votre message.

Si le format du message est JSON, le message se présente comme suit:

{"The date is: " : "{message.header.date}"}

Toutefois, vous pouvez constater que le format JSON est incorrect. Pour contourner ce problème, vous avez deux options:

  • Échappez l'accolade ouvrante avec une barre oblique inverse : 
    \{"The date is: " : "{message.header.date}"}
  • Dans la configuration de l'élément de charge utile, utilisez les attributs variablePrefix et variableSuffix pour indiquer une variable dans une charge utile JSON. Exemple:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

Dans la prochaine version de la fonctionnalité Edge for Private Cloud, vous pourrez sans problème utiliser des accolades pour les variables dans les messages JSON. (APIRT-1160).

Le routeur ne parvient pas à démarrer Nginx ou le routeur ne démarre pas

Si le routeur Edge ne démarre pas Nginx ou ne démarre pas, comme indiqué dans le fichier /opt/apigee/var/log/edge-router/logs/system.log, supprimez tous les fichiers du répertoire /opt/nginx/conf.d et redémarrez le routeur:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Précédent
4.16.05.01
Suivant
4.16.01.08