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 plus grandes avec de nombreux MP peuvent rencontrer 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 de fournir potentiellement une meilleure 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 le protocole HTTP pour le déploiement.

Modifier votre organisation

Pour activer le déploiement HTTP, envoyez une requête PUT à l'API Update organization properties. 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 de RPC). Définissez la valeur sur true pour autoriser le déploiement HTTP. Sinon, définissez la 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	Indique la méthode à utiliser pour les événements de configuration. Les valeurs possibles sont : never: tous les événements de configuration utilisent RPC. Il s'agit de la valeur par défaut. retry: tous les événements de configuration utilisent d'abord le protocole RPC. Si un événement échoue via le protocole RPC, Edge tente d'utiliser le protocole HTTP. Cela peut entraîner des retards si vous devez utiliser HTTP. 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 dans l'organisation mise à jour, puis examinez 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 la section Fichiers journaux.