Activer le déploiement HTTP

Par défaut, Edge utilise RPC pour déployer des proxys d'API. Bien que ce mode fonctionne très bien pour la plupart des installations, les topologies volumineuses avec de nombreuses MP peuvent connaître des délais avant expiration lorsqu'un grand nombre d'appels simultanés sont effectués via RPC. Apigee prévoit d'abandonner cette implémentation à l'avenir.

Par conséquent, Apigee recommande que les déploiements plus importants utilisent HTTP plutôt que RPC pour le déploiement.

En plus d'accroître potentiellement la fiabilité, l'activation du déploiement HTTP améliore également le contenu et le format des exceptions pouvant être générées lors du processus de déploiement.

Cette section explique comment activer HTTP pour le déploiement.

Modifier votre organisation

Pour activer le déploiement HTTP, envoyez une requête PUT à l'API Mettre à jour les propriétés de l'organisation. Définissez les propriétés suivantes dans le corps de la requête:

Propriété Description
allow.deployment.over.http Détermine si Edge peut déployer des proxys d'API via HTTP (en plus du RPC). Définissez ce paramètre sur true pour autoriser le déploiement HTTP. Sinon, définissez cette valeur sur false. La valeur par défaut est false.

Pour activer les déploiements HTTP, vous devez définir cette propriété sur true.

use.http.for.configuration

Spécifie la méthode à utiliser pour les événements de configuration. Les valeurs possibles sont :

  • never: tous les événements de configuration utilisent le RPC. Il s'agit de la valeur par défaut.
  • retry: tous les événements de configuration utilisent d'abord le RPC. Si un événement échoue via RPC, Edge essaie HTTP. Si vous devez utiliser HTTP, cela peut entraîner des retards.
  • always: tous les événements de configuration utilisent HTTP.

Pour activer les déploiements HTTP, Apigee vous recommande de définir cette propriété sur always.

En plus de définir ces propriétés dans le corps du message, vous devez définir l'en-tête Content-Type sur application/json ou application/xml.

L'exemple suivant appelle l'API Update Organization Properties avec un corps de message JSON.

curl -u admin_email:admin_password
  "http://management_server_IP:8080/v1/organizations/org_name"
  -X POST -H "Content-Type: application/json" -d
  '{
    "properties" : {
      "property" : [
      {
        "name" : "allow.deployment.over.http",
        "value" : "true"
      },
      {
        "name" : "use.http.for.configuration",
        "value" : "always"
      } ]
    }
  }'

Pour activer le déploiement HTTP sur tous les proxys d'API de toutes vos organisations, vous devez mettre à jour chaque organisation comme décrit ci-dessus.

Tester la mise à jour

Pour vérifier que votre mise à jour a réussi, déclenchez un événement de déploiement sur un proxy d'API de l'organisation mise à jour, puis consultez les fichiers journaux du processeur de messages. L'entrée de journal des événements de déploiement doit contenir mode:API.

Pour en savoir plus, consultez l'article Fichiers journaux.