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 volumineuses avec de nombreux MP peuvent rencontrer des délais d'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 d'utiliser HTTP plutôt que RPC pour les déploiements plus importants.

En plus d'offrir potentiellement une plus grande fiabilité, l'activation du déploiement HTTP améliore également le contenu et le format des exceptions pouvant ê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 à l'API de mise à jour 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éfinissez cette option sur true pour autoriser le déploiement HTTP. Sinon, définissez-la 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. Valeurs possibles :

  • 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 de mise à jour des propriétés de l'organisation 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 la mise à jour a réussi, déclenchez un événement de déploiement sur un proxy d'API dans l'organisation mise à jour, puis consultez les fichiers journaux du processeur de messages. L'entrée de journal pour les événements de déploiement doit contenir mode:API.

Pour en savoir plus, consultez Fichiers journaux.