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 installations, les topologies plus importantes avec de nombreux MP peuvent rencontrer des délais d'inactivité lorsqu'un grand nombre des appels simultanés sont effectués via RPC. Apigee prévoit d'abandonner cette implémentation à venir.

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

En plus d'améliorer la fiabilité, l'activation du déploiement HTTP améliore le contenu et le format des exceptions qui peuvent être générées pendant le processus de déploiement.

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

Mettre à jour votre organisation

Pour activer le déploiement HTTP, envoyez une requête PUT au Mettre à jour l'API des 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 de RPC). Définir sur true pour autoriser le déploiement HTTP ; sinon 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 RPC. Il s'agit de la valeur par défaut.
  • retry: tous les événements de configuration utilisent d'abord RPC. si un événement échoue via RPC, Edge essaie 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 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 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 l'organisation, comme décrit ci-dessus.

Tester la mise à jour

Pour tester la réussite de votre mise à jour, déclenchez un événement de déploiement sur un proxy d'API dans la organisation mise à jour et examiner les fichiers journaux du processeur de messages. L'entrée de journal de les événements de déploiement doivent contenir mode:API.

Pour en savoir plus, consultez la section Fichiers journaux.