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é:
- Cloud: 16.02.17, 16.03.02, 16.03.09 (UI), 16.03.16 (UI), 16.03.23 (UI), 16.03.30
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'utilitaireupdate.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ésormaisbootstrap_4.16.05.sh
dans la version 4.16.05.- Vous n'avez plus besoin de spécifier
uname:pword
pour téléchargerbootstrap_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
etupdate.sh
peuvent écrire le fichier journal dans/tmp
. Par défaut, les utilitairessetup.sh
etupdate.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:
|
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
etvariableSuffix
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