Abilita deployment HTTP

Per impostazione predefinita, Edge utilizza RPC per 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 un numero elevato di chiamate simultanee viene effettuato tramite RPC. Apigee prevede di ritirare questa implementazione in futuro.

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

Oltre a fornire potenzialmente maggiore affidabilità, l'abilitazione 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 abilitare HTTP per il deployment.

Aggiorna l'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, altrimenti su 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 l'RPC; se un evento non va a buon fine tramite RPC, Edge prova con HTTP. Ciò può causare ritardi se utilizzi il protocollo HTTP.
  • always: tutti gli eventi di configurazione utilizzano HTTP.

Per abilitare 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 attivare il deployment HTTP su tutti i proxy API in tutte le organizzazioni, devi aggiornare ciascuna organizzazione come descritto sopra.

Testa l'aggiornamento

Per verificare che l'aggiornamento sia riuscito, attiva un evento di deployment su un proxy API nell'organizzazione aggiornata e controlla i file di log del processore di messaggi. La voce di log per gli eventi di deployment deve contenere mode:API.

Per ulteriori informazioni, consulta File di log.