HTTP-Bereitstellung aktivieren

Standardmäßig verwendet Edge RPC zum Bereitstellen von API-Proxys. Dieser Modus funktioniert für die meisten Installationen sehr gut. Bei größeren Topologien mit vielen MP können jedoch Zeitüberschreitungen auftreten, wenn eine große Anzahl gleichzeitiger Aufrufe über RPC erfolgt. Apigee plant, diese Implementierung in Zukunft einzustellen.

Daher empfiehlt Apigee, dass größere Bereitstellungen HTTP anstelle von RPC für die Bereitstellung verwenden.

Das Aktivieren der HTTP-Bereitstellung bietet nicht nur potenziell eine höhere Zuverlässigkeit, sondern verbessert auch den Inhalt und das Format von Ausnahmen, die während des Bereitstellungsprozesses ausgelöst werden können.

In diesem Abschnitt wird beschrieben, wie HTTP für die Bereitstellung aktiviert wird.

Organisation aktualisieren

Senden Sie eine PUT-Anfrage an die Update Organization Properties API, um die HTTP-Bereitstellung zu aktivieren. Legen Sie im Text der Anfrage die folgenden Attribute fest:

Property	Beschreibung
allow.deployment.over.http	Bestimmt, ob Edge API-Proxys über HTTP (zusätzlich zu RPC) bereitstellen kann. Legen Sie true fest, um die HTTP-Bereitstellung zuzulassen, andernfalls false. Der Standardwert ist false. Zum Aktivieren von HTTP-Bereitstellungen müssen Sie dieses Attribut auf true setzen.
use.http.for.configuration	Gibt an, welche Methode für Konfigurationsereignisse verwendet werden soll. Folgende Werte sind möglich: never: Alle Konfigurationsereignisse verwenden RPC. Das ist die Standardeinstellung. retry: Alle Konfigurationsereignisse verwenden zuerst RPC. Wenn ein Ereignis über RPC fehlschlägt, versucht Edge HTTP. Dies kann bei der Verwendung von HTTP zu Verzögerungen führen. always: Alle Konfigurationsereignisse verwenden HTTP. Zum Aktivieren von HTTP-Bereitstellungen empfiehlt Apigee, dieses Attribut auf always zu setzen.

Sie müssen diese Attribute nicht nur im Text der Nachricht festlegen, sondern auch den Header Content-Type auf application/json oder application/xml festlegen.

Im folgenden Beispiel wird die Update Organization Properties API mit einem JSON-Nachrichtentext aufgerufen.

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"
      } ]
    }
  }'

Wenn Sie die HTTP-Bereitstellung auf allen API-Proxys in allen Organisationen aktivieren möchten, müssen Sie jede Organisation wie oben beschrieben aktualisieren.

Update testen

Lösen Sie ein Bereitstellungsereignis auf einem API-Proxy in der aktualisierten Organisation aus und sehen Sie sich die Protokolldateien von Message Processor an, um zu testen, ob das Update erfolgreich war. Der Logeintrag für die Bereitstellungsereignisse sollte mode:API enthalten.

Weitere Informationen finden Sie unter Protokolldateien.