4.19.01 Edge for Private Cloud Notes de version

Vous consultez la documentation sur Apigee Edge.
Consultez la documentation sur Apigee X.

Cette section décrit la version 4.19.01 d'Edge pour la fonctionnalité de fonctionnalités de cloud privé.

Résumé de la version

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

Nouvelles fonctionnalités

Cette version inclut les nouvelles fonctionnalités suivantes :

○ Lancement en disponibilité générale de l'interface utilisateur Edge
○ Lancement en disponibilité générale de la monétisation dans l'interface utilisateur périphérique
apigee-monit ajoute des services d'auto-réparation et de surveillance
○ Nouvelles propriétés de configuration TLS
○ Vous pouvez désormais créer, modifier et supprimer des hôtes virtuels dans l'interface utilisateur périphérique
○ Compatibilité avec OpenAPI v3 ajoutée
○ Linux Linux est désormais compatible avec RHEL 7

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

Versions incluses

Depuis la version précédente d'Edge for Private Cloud, les versions suivantes ont eu lieu et sont incluses dans cette version:

○ Edge:
   18.06.08
   18.06.06
   18.05.21
   18.05.10
   18.05.09
   18.04.09
○ Portail:
   18.11.28.00
   18.10.17.00
   18.10.09.00
   18.07.16.00
Retraites Aucune
Abandons Apigee Edge pour le cloud privé version 4.17.09 n'est plus compatible (obsolète).

Pour en savoir plus, consultez Abandons, retraits et modifications du CPS d'Apigee.

Correction de bugs

Cette version inclut les corrections de bugs suivantes:

(1)









Pour en savoir plus sur chacun de ces correctifs, consultez Correction de bugs.

Problèmes connus

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

?









apigee-monitHEAD

Pour obtenir plus d'informations sur chacun de ces problèmes connus, y compris des solutions, consultez la section Problèmes connus.

Chemins de mise à niveau

Le tableau suivant présente les chemins de mise à niveau pour cette version:

À partir du 18/04/05 Mise à niveau directe du 4.18.05 au 4.19.01
Depuis le 18/04/01 Mise à niveau directe du 4.18.01 au 4.19.01
À partir du 17/04/09 Mise à niveau directe du 4.17.09 au 4.19.01
À partir du 17/04/05 Passez de 4.17.05 à 4.18.01, puis passez de 4.18.01 à 4.19.01
Depuis le 17/04/01 Passez de 4.17.01 à 4.18.01, puis passez de 4.18.01 à 4.19.01
À partir du 16/04/09 Passez de 4.16.09 à 4.18.01, puis passez de 4.18.01 à 4.19.01
À partir du 16/04/05 Passez de 4.16.05 à 4.18.01, puis passez de 4.18.01 à 4.19.01
À partir du 16/04/01 Passez de 4.16.01 à 4.18.01, puis 4.18.01 à 4.19.01
À partir de 4.15.0x Passez de la version 4.15.0 à la version 4.16.01, 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 liste les nouvelles fonctionnalités de cette version. De plus, cette version inclut toutes les fonctionnalités de l'interface utilisateur Edge, de la gestion périphérique et des versions de portail répertoriées dans les versions incluses.

En plus des améliorations suivantes, cette version offre plusieurs améliorations en termes de facilité d'utilisation, de performances, de sécurité et de stabilité.

Version en disponibilité générale de l'interface utilisateur Edge

L'interface utilisateur d'Apigee Edge est notre dernier service d'interface de gestion. Auparavant, il était en version bêta. Avec Apigee Edge pour le cloud privé 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 en savoir plus, consultez la section Interface utilisateur périphérique pour cloud privé.

Disponibilité générale de la monétisation dans l'interface utilisateur de périphérie

La version en disponibilité générale de la monétisation dans l'interface utilisateur de New Edge est désormais disponible.

Vous pouvez maintenant gérer toutes les tâches de monétisation d'Apigee Edge pour le cloud privé dans l'interface utilisateur de l'expérience New Edge, y compris les suivantes:

Avec 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'autoréparation et de surveillance

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

Pour en savoir plus 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 de 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 compatibles
  • Algorithmes TLS compatibles
  • Algorithmes de chiffrement TLS compatibles

Pour en savoir plus, consultez la section 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 que vous puissiez désormais créer, modifier et supprimer des hôtes virtuels dans un navigateur (interface utilisateur Edge uniquement).

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

Ajout de la 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 inclut les modifications suivantes apportées aux logiciels compatibles:

Assistance ajoutée Non 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.

Correction de bugs

Cette section répertorie les bugs liés au cloud privé qui ont été corrigés dans cette version. De plus, cette version inclut toutes les corrections de bugs dans l'interface utilisateur Edge, la gestion Edge et les versions de portail présentées dans les versions incluses.

ID du problème Description
122694069

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

Avant ce correctif, le script de sauvegarde n'arrêtait pas le processus Zookeeper.
120993451

Page de destination "Aucune organisation" ajoutée

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

Supprimer des rapports personnalisés

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

Onglet Geomap dans l'expérience New Edge

Lorsque les utilisateurs accédaient à l'onglet Geomap dans l'expérience New Edge, celle-ci renvoyait une erreur.
120624977

Options de la JVM Zookeeper

La configuration 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 comporte 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 Use OpenAPI (Utiliser OpenAPI) pour créer des proxys ne fonctionnait pas.
77515655

Réinitialiser les mots de passe sans envoyer de liens

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

En-têtes incorrects pour les liens de réinitialisation de 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 des WSDL pour créer des proxys d'API

Échec de la génération du proxy d'API lors de l'utilisation de WSDL.

Problèmes connus

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

ID du problème Description
135616498

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

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

Solution :

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

  • Ajoutez un fichier CRLF à la fin du fichier metadata.xml.

    OU

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

apigee-monit non compatible avec Amazon Linux 1

Solution :

Aucune.
121095148

Les sauvegardes du processeur de messages ne sauvegardent pas le bon ensemble de fichiers

Solution :

Exécutez la sauvegarde une deuxième fois pour que l'ensemble de fichiers approprié soit sauvegardé.

115278838

Jetons de session non valides

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

Blocage des requêtes HEAD sur les cibles Node.js

Les requêtes HEAD envoyées à une cible Node.js peuvent se figer, laissant les connexions en attente.

Solution :

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

79757554

Impossible de résoudre les noms d'hôte

Après l'installation ou la mise à niveau d'Edge pour Private Cloud, les noms d'hôte peuvent ne pas être résolus avec leurs adresses.

Solution :

Pour résoudre ce problème, redémarrez le composant de l'interface utilisateur 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 centre de données, si un datastore devient indisponible, l'erreur suivante peut s'afficher:

DataAccessException: Error while accessing datastore;
Please retry later

Par conséquent, il est possible que le serveur de gestion ne démarre pas, car il tente de se connecter aux nœuds Cassandra dans dc-1 et dc-2. DataAccessExceptions se produit si un nœud Cassandra est arrêté. Cela peut également perturber le 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 les nœuds Cassandra disponibles:

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

Pour annuler l'inscription de ces types de nœuds Cassandra, puis les réenregistrer, procédez comme suit:

  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 est par défaut "gateway". Toutefois, vous l'avez peut-être renommé, vérifiez votre implémentation.
    • CASSANDRA_NODE_TYPE est l'une des valeurs suivantes : kms-datastore, dc-datastore et 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 désenregistrer les nœuds.

  2. Répétez l'étape 1 pour chaque type de nœud Cassandra: kms-datastore, dc-datastore et keyvaluemap-datastore. Veillez à noter les 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 est l'UUID renvoyé dans la réponse de la commande précédente.

  4. Répétez l'étape 3 pour chaque UUID 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 désenregistrent des nœuds de Zookeeper. Elles n'ont aucune incidence sur le cluster Cassandra. Pour en savoir plus sur ces commandes, consultez la page Mettre à jour les enregistrements du datastore.

68722102

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

L'élément FormatMessage de la stratégie MessageLogging contrôle le format du message journalisé. Lorsque FormatMessage=false, le message journalisé n'est pas censé inclure d'informations générées par Apigee. Toutefois, même si vous définissez FormatMessage=false, le message de journal comprend les informations suivantes:

  • Score de priorité
  • Horodatage

Solution :

Aucune.
65737520

Échec de la réinitialisation du mot de passe administrateur système

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

Solution :

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

Étape suivante

Pour commencer à utiliser Edge pour le cloud privé 4.19.01, cliquez sur les liens suivants:

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