Włącz wdrożenie HTTP

Domyślnie Edge używa RPC do wdrażania serwerów proxy interfejsów API. Ten tryb działa bardzo dobrze w większości przypadków, instalacji, w większych topologach z wieloma procesorami MP mogą występować przekroczenie limitu czasu, gdy równoczesnych wywołań jest wykonywanych przez RPC. Apigee planuje wycofać tę implementację w w przyszłości.

Dlatego Apigee zaleca, aby w przypadku większych wdrożeń używać protokołu HTTP zamiast RPC.

Oprócz potencjalnej niezawodności, włączenie wdrażania HTTP poprawia również treść i format wyjątków, które mogą zostać zgłoszone podczas procesu wdrażania.

W tej sekcji dowiesz się, jak włączyć protokół HTTP do wdrożenia.

Aktualizowanie organizacji

Aby włączyć wdrażanie HTTP, wyślij żądanie PUT do Zaktualizuj interfejs API Właściwości organizacji. W treści żądania ustaw te właściwości:

Właściwość Opis
allow.deployment.over.http Określa, czy Edge może wdrażać serwery proxy interfejsów API przez HTTP (oprócz RPC). Ustaw na true, aby zezwolić na wdrażanie HTTP; w przeciwnym razie: false. Wartość domyślna to false

Aby włączyć wdrożenia HTTP, ustaw tę właściwość na true.
use.http.for.configuration

Określa metodę, która ma być używana w przypadku zdarzeń konfiguracji. Możliwe wartości to:

  • never: wszystkie zdarzenia konfiguracji korzystają z RPC. Jest to ustawienie domyślne.
  • retry: wszystkie zdarzenia konfiguracji najpierw używają RPC; jeśli zdarzenie zakończy się niepowodzeniem w RPC, Edge HTTP. Może to spowodować opóźnienia, jeśli powinieneś używać protokołu HTTP.
  • always: wszystkie zdarzenia konfiguracji używają HTTP.

Aby można było włączyć wdrożenia HTTP, Apigee zaleca ustawienie tej właściwości na always

Oprócz ustawienia tych właściwości w treści wiadomości musisz ustawić nagłówek Content-Type na application/json lub application/xml.

Ten przykład wywołuje interfejs API aktualizacji właściwości organizacji za pomocą komunikatu 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"
      } ]
    }
  }'

Aby umożliwić wdrażanie HTTP na wszystkich serwerach proxy interfejsów API we wszystkich organizacjach, musisz zaktualizować każdy organizacji w sposób opisany powyżej.

Testowanie aktualizacji

Aby sprawdzić, czy aktualizacja się udała, wywołaj zdarzenie wdrożenia na serwerze proxy interfejsu API w zaktualizowanej organizacji, a potem przejrzyj pliki dziennika usługi przetwarzanie wiadomości. Wpis w dzienniku opisujący zdarzenia wdrożenia powinny zawierać wartość mode:API.

Więcej informacji znajdziesz w artykule Pliki dziennika.