Notes de version d'Edge for Private Cloud 4.19.01

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

Cette section décrit la version 4.19.01 de la mise à jour des fonctionnalités Edge for Private Cloud.

Résumé de la version

Le tableau suivant récapitule les modifications apportées à cette version:

Nouvelles fonctionnalités

Cette version inclut les nouvelles fonctionnalités suivantes :

○ Version en disponibilité générale de l'interface utilisateur Edge
○ Version en disponibilité générale de la monétisation dans l'interface utilisateur Edge
apigee-monit ajoute des services d'auto-réparation et de surveillance
○ L'interface utilisateur Edge dispose de nouvelles propriétés de configuration TLS
○ Vous pouvez désormais créer, modifier et supprimer des hôtes virtuels dans l'interface utilisateur Edge
○ la prise en charge d'OpenHat Enterprise v3 dans l'interface utilisateur Edge v3
○ RedHat Enterprise Linux est désormais pris en charge
○ RedHat Enterprise est désormais compatible avec Linux (Oracle 7).

Pour en savoir plus sur chacune de ces nouvelles fonctionnalités, consultez la section Nouvelles fonctionnalités.

Versions incluses

Depuis la version précédente des fonctionnalités Edge for Private Cloud, les versions suivantes ont eu lieu et sont incluses dans celle-ci:

○ Edge:
   18.06.08
   18.06.06
   18.05.21
   18.05.10
   18.05.09
18.04.04.
○ Portail:
   18.11.28.00
   18.10.17.00
   18.10.09.00
   18.07.16.00
Retraits Aucun
Abandons La version 4.17.09 d'Apigee Edge pour Private Cloud n'est plus compatible (obsolète).

Pour plus d'informations, consultez Abandons, retraits et modifications de CPS d'Apigee.

Correction de bugs

Cette version inclut les corrections de bugs suivantes:

○9 x9 (z909 avec le script de sauvegarde qui n'a pas été arrêté par un script de sauvegarde (122694069)
5x9








Pour en savoir plus sur chacune de ces corrections, consultez Correction de bugs.

Problèmes connus

Cette version inclut les problèmes connus suivants:

○ ○ Metadata File format for apigee-sso install (135616498)
apigee-monit not supported on Amazon Linux 1 (122370980) ○ La sauvegarde du processeur de messages ne sauvegarde pas le bon ensemble de fichiers (121095148)
○ Les jetons de session non invalidés (83827)







HEAD

Pour en savoir plus sur chacun de ces problèmes connus et obtenir des solutions, consultez la section Problèmes connus.

Chemins de mise à niveau

Le tableau suivant indique les chemins de mise à niveau pour cette version:

À partir du 18/04 Passez directement de la version 4.18.05 à la version 4.19.01.
De Passez directement de la version 4.18.01 à la version 4.19.01.
À partir de 17/04 Passez directement de la version 4.17.09 à la version 4.19.01.
À partir de 17/04 Passez de la version 4.17.05 à la version 4.18.01, puis passez de la version 4.18.01 à la version 4.19.01
De Passez de la version 4.17.01 à la version 4.18.01, puis passez de la version 4.18.01 à la version 4.19.01
À partir du 16/04/09 Passez de la version 4.16.09 à la version 4.18.01, puis passez de la version 4.18.01 à la version 4.19.01
À partir de 16/04 Passez de la version 4.16.05 à la version 4.18.01, puis passez de la version 4.18.01 à la version 4.19.01
À partir de 16/04 Passez de la version 4.16.01 à la version 4.18.01, puis passez de la version 4.18.01 à la version 4.19.01
À partir de 4.15.0x Passez de la version 4.15.0x à la version 4.16.01, puis passez de la version 4.16.01 à la version 4.18.01, puis passez de la version 4.18.01 à la version 4.19.01.

Nouvelles fonctionnalités

Cette section présente les nouvelles fonctionnalités de cette version. De plus, cette version inclut toutes les fonctionnalités des versions d'interface utilisateur Edge, de gestion Edge et de portail répertoriées dans les versions incluses.

Outre les améliorations suivantes, cette version inclut plusieurs améliorations en termes de convivialité, de performances, de sécurité et de stabilité.

Disponibilité générale de l'interface utilisateur Edge

L'interface utilisateur Apigee Edge est notre dernier service d'interface utilisateur de gestion. Auparavant, il était en version bêta. Avec Apigee Edge pour Private Cloud v4.19.01, l'interface utilisateur Edge fait partie de la version générale.

Pour utiliser l'interface utilisateur Edge, vous devez activer SAML, puis installer l'interface utilisateur Edge sur son propre nœud.

Pour plus d'informations, voir L'interface utilisateur Edge pour cloud privé.

Disponibilité générale de la fonctionnalité de monétisation dans l'interface utilisateur Edge

La version en disponibilité générale de la monétisation dans l'interface utilisateur de la nouvelle expérience Edge est maintenant disponible.

Vous pouvez maintenant gérer toutes les tâches de monétisation d'Apigee Edge pour Private Cloud dans l'interface utilisateur de la nouvelle expérience Edge, y compris les suivantes:

Suite à cette annonce, les rapports sur les écarts de monétisation ont été officiellement abandonnés. Consultez la page Abandons d'Apigee.

apigee-monit ajoute des services d'auto-réparation et de surveillance

Apigee Edge pour Private Cloud inclut désormais apigee-monit, un outil basé sur l'utilitaire de monétisation Open Source. apigee-monit interroge régulièrement les services Edge. Si un service est indisponible, apigee-monit tente de le redémarrer.

Pour plus d'informations sur l'installation, la configuration et l'utilisation de apigee-monit, consultez Réparation automatique avec apigee-monit.

Nouvelles propriétés de configuration TLS

L'interface utilisateur Edge prend en charge les nouvelles propriétés de configuration TLS que vous pouvez utiliser pour définir les éléments suivants:

  • Protocole TLS par défaut
  • Liste des protocoles TLS acceptés
  • Algorithmes TLS compatibles
  • Algorithmes de chiffrement TLS compatibles

Pour en savoir plus, consultez Définir des propriétés TLS facultatives.

Créer, modifier et supprimer des hôtes virtuels dans l'interface utilisateur Edge

La fonctionnalité en libre-service a été étendue pour vous permettre de créer, modifier et supprimer des hôtes virtuels dans un navigateur (interface utilisateur Edge uniquement).

Pour en savoir plus, consultez la section Créer un hôte virtuel à l'aide d'un navigateur.

Compatibilité avec OpenAPI v3

Cette version permet désormais de créer un proxy via OpenAPI version 3 (interface utilisateur Edge uniquement).

Logiciels compatibles

Cette version apporte les modifications suivantes aux logiciels compatibles:

Assistance ajoutée N'est plus disponible

Cette version est compatible avec les plates-formes suivantes:

  • Red Hat Enterprise Linux (RHEL) 7.6
  • CentOS 7.6
  • Oracle Linux 7.6

Les plates-formes suivantes ne sont plus compatibles avec cette version:

  • RHEL/CentOS/Oracle version 7.3
  • RHEL/CentOS version 6.8
  • Oracle Linux 6.7

Pour obtenir la liste complète des plates-formes compatibles, consultez la section Logiciels et versions compatibles.

Corrections de bugs

Cette section liste les bugs du cloud privé qui ont été corrigés dans cette version. De plus, cette version inclut toutes les corrections de bugs des versions de l'interface utilisateur Edge, de la gestion Edge et du portail indiquées dans les versions incluses.

ID du problème Description
122694069

Zookeeper n'a pas été arrêté par un script de sauvegarde

Le processus ZooKeeper n'était pas arrêté par le script de sauvegarde avant ce correctif.
120993451

Page de destination "Aucune organisation" ajoutée

Les développeurs qui se connectent avec un utilisateur qui n'est associé à aucune organisation ne sont plus redirigés vers une page qui n'existe pas. Une nouvelle page de destination a été ajoutée pour ces utilisateurs.
120682369

Supprimer des rapports personnalisés

Les utilisateurs n'ont pas pu supprimer des rapports personnalisés dans l'expérience New Edge.
120681592

Onglet "Geomap" dans la nouvelle expérience Edge

Lorsque les utilisateurs ont accédé à l'onglet Geomap de l'expérience New Edge, l'expérience New Edge générait une erreur.
120624977

Options de la JVM Zoookeeper

La définition des options JVM à l'aide de Code avec Config pour Zookeeper ne fonctionnait pas.
80187407

Des erreurs non définies se sont produites dans les info-bulles

Lorsqu'un graphique ne comportait qu'une seule série temporelle, les info-bulles renvoyaient des erreurs non définies.
79949124

Créer des proxys inverses via OpenAPI

Le bouton Utiliser OpenAPI lors de la création de proxys ne fonctionnait pas.
77515655

Réinitialiser un mot de passe qui n'envoie pas de liens

Les utilisateurs ne recevaient pas d'e-mails lorsqu'ils demandaient un lien pour réinitialiser leur mot de passe.
72799769

En-têtes incorrects pour les liens de réinitialisation du mot de passe

Même après qu'un utilisateur a défini la propriété trustxforwarded sur true, les en-têtes de requête obtenus n'utilisaient pas HTTPS.
69550284

Utiliser WSDL pour créer des proxys d'API

La génération du proxy d'API échouait lors de l'utilisation de WSDL.

Problèmes connus

Le tableau suivant répertorie les problèmes connus de cette version:

ID du problème Description
135616498

Format du fichier de métadonnées pour l'installation de apigee-sso

Lors de l'installation de apigee-sso et de l'utilisation d'un fichiermetadata.xml au lieu d'une URL, si celui-ci ne comporte pas de nouvelle ligne (CRLF) à la fin, il n'est pas lu entièrement.

Solution :

Pour contourner ce problème, vous pouvez effectuer l'une des opérations suivantes:

  • Ajoutez un CRLF à la fin du fichiermetadata.xml

    OU

  • Indiquez un emplacement basé sur une URL pour les métadonnées
122370980

apigee-monit n'est pas compatible avec Amazon Linux 1

Solution :

Aucune
121095148

La sauvegarde du processeur de messages ne sauvegarde pas le bon ensemble de fichiers

Solution :

Exécutez la sauvegarde une deuxième fois. Elle devrait sauvegarder le bon ensemble de fichiers.

115278838

Jetons de session non invalidés

Les jetons de session ne sont pas invalidés sur le serveur lorsque l'utilisateur clique sur le bouton de déconnexion d'Apigee Edge.

Solution :

Utilisez la nouvelle expérience Edge avec SAML.

113342838

Les opérations Cassandra ne fonctionnent pas lorsque l'authentification JMX est activée

Solution :

Ajoutez votre nom d'utilisateur et votre mot de passe chaque fois que vous appelez la commande nodetool.

79993247

Les requêtes HEAD adressées à des cibles Node.js sont bloquées

Les requêtes HEAD adressées à une cible Node.js peuvent être bloquées et les connexions restent en attente.

Solution :

Pour contourner ce problème, définissez un gestionnaire afin que les requêtes HEAD renvoient explicitement une réponse vide.

79757554

Noms d'hôte non résolus

Après l'installation ou la mise à niveau de Edge for Private Cloud, les noms d'hôte peuvent ne pas correspondre à leurs adresses.

Solution :

Pour résoudre ce problème, redémarrez le composant UI Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
76087166

DataAccessException dans plusieurs configurations de centres de données

Dans plusieurs configurations de centres de données, si un datastore devient indisponible, l'erreur suivante peut s'afficher:

DataAccessException: Error while accessing datastore;
Please retry later

Il se peut donc que Management Server ne démarre pas, car il tente de se connecter aux nœuds Cassandra à la fois dans dc-1 et dc-2. Le DataAccessExceptions se produit si un nœud Cassandra est en panne. Cela peut également entraîner une interruption du trafic de l'API, où les processeurs de messages signalent DataAccessExceptions lors de la tentative de récupération des KVM.

Notez que l'état attendu est que le serveur de gestion ne se connecte pas aux composants du datastore entre les régions.

Solution

La solution consiste à annuler l'enregistrement des types de nœuds Cassandra suivants dans le centre de données indisponible, puis à les réenregistrer une fois que les nœuds Cassandra sont à nouveau disponibles:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

Pour annuler l'enregistrement de ces types de nœuds Cassandra et les réenregistrer:

  1. Obtenez les UUID des nœuds Cassandra à l'aide de la commande curl suivante :
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Où :

    • ADMIN_EMAIL et ADMIN_PW sont les identifiants de votre compte Apigee.
    • MS_IP et MS_PORT sont l'adresse IP et le numéro de port du serveur de gestion.
    • REGION est le nom du centre de données dans lequel se trouve le serveur de gestion.
    • GATEWAY_POD est le nom du pod, qui correspond par défaut à "passerelle". Il se peut toutefois que vous l'ayez renommé autrement. Vérifiez votre implémentation.
    • CASSANDRA_NODE_TYPE est l'une des valeurs suivantes : kms-datastore, dc-datastore ou keyvaluemap-datastore.

    Exemple :

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    La réponse utilise le format suivant :

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    Exemple :

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    Notez les valeurs du champ uUID dans la réponse. Vous les utiliserez pour annuler l'enregistrement des nœuds.

  2. Répétez l'étape 1 pour chaque type de nœud Cassandra: kms-datastore, dc-datastore et keyvaluemap-datastore. Prenez note des UUID renvoyés.
  3. Annulez l'enregistrement des nœuds à l'aide de la commande suivante :
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    UUID correspond à l'UUID renvoyé dans la réponse de la commande précédente.

  4. Répétez l'étape 3 pour chaque UUID que vous avez collecté aux étapes 1 et 2.
  5. Réenregistrez les nœuds à l'aide de la commande suivante :
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

Notez que ces opérations enregistrent et annulent l'enregistrement des nœuds auprès de Zookeeper et n'ont aucune incidence sur le cluster Cassandra. Pour en savoir plus sur ces commandes, consultez la page Mettre à jour les enregistrements dans le datastore.

68722102

Règle MessageLogging incluant des informations supplémentaires dans le message de journal

L'élément FormatMessage de la règle MessageLogging contrôle le format du message enregistré. Lorsque la valeur est FormatMessage=false, le message journal n'est pas censé inclure des informations générées par Apigee. Toutefois, même si vous définissez FormatMessage=false, le message de journal inclut toujours les informations suivantes:

  • Le niveau de priorité
  • Le code temporel

Solution :

Aucune
65737520

La réinitialisation du mot de passe administrateur système échoue

La réinitialisation du mot de passe de l'administrateur système du serveur de gestion qui contient des caractères spéciaux échouera.

Solution :

Définissez le mot de passe dans un fichier de données que vous transmettrez au point de terminaison /users dans l'API Management. Pour plus d'informations, consultez Réinitialiser le mot de passe de l'administrateur système.

Étape suivante

Pour commencer à utiliser Edge for Private Cloud 4.19.01, utilisez les liens suivants:

Nouvelles installations:
Présentation de la nouvelle installation
Installations existantes:
Processus de mise à niveau