4.16.05 - Notes de version d'Edge for Private Cloud

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

Le mardi 31 mai 2016, nous avons lancé une nouvelle version d'Apigee Edge pour Private Cloud.

Depuis la précédente version de fonctionnalité Edge for Private Cloud (4.16.01), les versions suivantes se sont produites 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

Reportez-vous à la section À propos de la version la numérotation pour comprendre comment déterminer si une version spécifique du cloud inclus dans votre version d'Edge pour Private Cloud.

Nouvelles fonctionnalités et améliorations

Vous trouverez ci-dessous les nouvelles fonctionnalités et améliorations de cette version. En plus des éléments suivants, Cette version inclut également de multiples fonctionnalités en termes de facilité d'utilisation, de performances, de sécurité et de stabilité améliorations.

Pour plus d'informations et d'instructions, consultez la documentation Edge pour Private Cloud.

Installation et Les guides des opérations sont désormais accessibles en ligne

Vous pouvez maintenant accéder au guide d'installation et d'utilisation d'Edge for Private Cloud à la version 4.18.01.

Mises à jour logicielles

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

• Java JDK 1.8 : pour bénéficier des dernières fonctionnalités Java, ce 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 "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 à partir de Cassandra 2.0.15.

Installation, mise à niveau rollback

Vous trouverez ci-dessous la liste des modifications apportées à l'installation, à la mise à niveau et aux scripts associés. Pour plus d'informations consultez la documentation Edge pour Private Cloud.

• Nouveau processus de mise à jour depuis la version 4.16.01 : cette version remplace apigee-migrate avec l'utilitaire update.sh pour mettre à jour votre de la version 4.16.01 à la version 4.16.05. Voir Mettre à jour Apigee Edge 4.16.01 vers 4.16.05.
• Amorçage <ph type="x-smartling-placeholder">
  </ph>
  • bootstrap.sh (la version 4.16.01) est maintenant bootstrap_4.16.05.sh au 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 la version 4.16.05, vous devez désinstaller le 4.16.05 et réinstallez la version précédente. Le précédent L'utilitaire rollback.sh 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 règles setup.sh et Les utilitaires update.sh écrivent les informations de journal à /opt/apigee/var/log/apigee-setup. Si l'utilisateur qui exécute l'utilitaire ait 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 BaaS de l'API : dans la version 4.16.01, vous deviez réinstaller l'API BaaS pour la migrer. Le nouvel utilitaire update.sh prend en charge en mettant à jour les API BaaS. Voir Mettre à jour Apigee Edge 4.16.01 vers 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 cloud privé Edge l'installation peut maintenant être exécutée à partir du serveur de gestion. Auparavant, il fallait exécuter le script sur le processeur de messages. Reportez-vous à la section Tester le installation.
• Nom de la région : la région peut être le nom de votre choix. Dans les versions précédentes, le nom était au format "dc-#", où # était 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 : A Le nouvel utilitaire de ligne de commande apigee-adminapi.sh vous permet Tâches de configuration Edge que vous effectuez en appelant l'API de gestion Edge. Voir À l'aide du utilitaire apigee-adminapi.sh.
• Configuration silencieuse SSL de l'hôte virtuel : lors de la création d'une organisation ou 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 fournis dans le cloud précédent versions du produit.

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

La règle de journalisation des messages comporte un nouvel élément <FormatMessage> dans la configuration Syslog. Par paramètre <FormatMessage>true</FormatMessage>, messages Syslog commencer par un nombre fixe de caractères, ce qui vous permet de filtrer les données insérées par Apigee. Pour plus informations, consultez la section Message Règle de journalisation. (APIRT-1398).

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

L'UI de gestion permet d'utiliser un ou plusieurs caractères génériques /*/ dans le proxy d'API de base. Par exemple, un chemin de base /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 autre proxy à soutenir de nouvelles équipes. Notez que /**/ n'est pas autorisé. (MGMT-3154)

Chaînage de proxys d'API (Cloud 16.03.02, UI Cloud 16.03.09)

Edge prend en charge le chaînage de proxys d'API local, ce qui permet à un proxy d'API d'appeler un autre proxy d'API déployés dans votre organisation Edge sans engendrer de frais supplémentaires sur le réseau. Auparavant, le proxy d'API le chaînage nécessitait un appel HTTP(s) à un autre proxy d'API, qui a transféré la requête via un l'équilibreur de charge, le routeur et le processeur de messages.

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

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 listés dans le fichier XML. ici: 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 consultent pour voir si leurs tickets de support ont été résolus. Il n'est pas conçu pour fournir pour tous les utilisateurs.

Edge for Private Cloud 4.16.05

Cloud 16.03.30

Interface utilisateur de Cloud 16.03.16

Interface utilisateur de Cloud 16.03.09

Cloud 16.03.02

Cloud 16.02.17

Problèmes connus

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

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

les charges utiles JSON dans Attribuer des règles de message, d'appel Java et de génération d'erreurs

Les règles d'affectation de message, d'appel Java et de génération d'erreur vous permettent de générer un message à l'aide de l'élément <Set><Payload>. Dans le cadre de ces messages, peuvent inclure des variables dont les valeurs sont renseignées automatiquement au moment de l'exécution. Par exemple, si vous souhaitez la date de l'en-tête HTTP, vous pouvez insérer {message.header.date} dans votre message.

Si le format du message est JSON, le message doit ressembler à ceci:

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

Vous pouvez toutefois constater que le format JSON est incorrect. Pour contourner ce problème, options:

• Échappez l'accolade ouvrante à l'aide d'une barre oblique inverse:

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

• Dans la configuration de l'élément de charge utile, utilisez variablePrefix et Attributs variableSuffix pour indiquer une variable dans une charge utile JSON. Pour exemple:
  

  <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
  

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

le routeur ne parvient pas à démarrer Nginx ou Échec du démarrage du routeur

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

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