Abilita deployment HTTP

Per impostazione predefinita, Edge utilizza RPC per eseguire il deployment dei proxy API. Sebbene questa modalità funzioni molto bene per la maggior parte delle installazioni, le topologie più grandi con molti MP potrebbero riscontrare timeout quando viene effettuato un numero elevato di chiamate simultanee tramite RPC. Apigee prevede di ritirare questa implementazione in futuro.

Di conseguenza, Apigee consiglia di utilizzare HTTP anziché RPC per i deployment più grandi.

Oltre a fornire potenzialmente una maggiore affidabilità, l'attivazione del deployment HTTP migliora anche il contenuto e il formato delle eccezioni che potrebbero essere generate durante il processo di deployment.

Questa sezione descrive come attivare HTTP per il deployment.

Aggiorna la tua organizzazione

Per abilitare il deployment HTTP, invia una richiesta PUT all'API Update organization properties. Imposta le seguenti proprietà nel corpo della richiesta:

Proprietà Descrizione
allow.deployment.over.http Determina se Edge può eseguire il deployment dei proxy API tramite HTTP (oltre a RPC). Impostalo su true per consentire il deployment HTTP; in caso contrario, false. Il valore predefinito è false.

Per abilitare i deployment HTTP, devi impostare questa proprietà su true.
use.http.for.configuration

Specifica il metodo da utilizzare per gli eventi di configurazione. I valori possibili sono:

  • never: tutti gli eventi di configurazione utilizzano RPC. Questa è l'impostazione predefinita.
  • retry: tutti gli eventi di configurazione utilizzano prima RPC; se un evento non va a buon fine tramite RPC, Edge prova HTTP. Questo può causare ritardi se devi utilizzare HTTP.
  • always: tutti gli eventi di configurazione utilizzano HTTP.

Per attivare i deployment HTTP, Apigee consiglia di impostare questa proprietà su always.

Oltre a impostare queste proprietà nel corpo del messaggio, devi impostare l'intestazione Content-Type su application/json o application/xml.

L'esempio seguente chiama l'API Update organization properties con un corpo del messaggio 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"
      } ]
    }
  }'

Per abilitare il deployment HTTP su tutti i proxy API in tutte le tue organizzazioni, devi aggiornare ogni organizzazione come descritto sopra.

Testa l'aggiornamento

Per verificare che l'aggiornamento sia andato a buon fine, attiva un evento di deployment su un proxy API nell'organizzazione aggiornata, quindi esamina i file di log del processore di messaggi. La voce di log per gli eventi di deployment deve contenere mode:API.

Per saperne di più, consulta File di log.