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 komponentami 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.

W związku z tym Apigee zaleca, aby dla większych wdrożeń wykorzystywała protokół HTTP, a nie RPC lub wdrożenia.

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ć HTTP na potrzeby wdrożenia.

Aktualizowanie organizacji

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

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 powodować opóźnienia w przypadku korzystania z 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 też ustawić nagłówek Content-Type do 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ę powiodła, wywołaj zdarzenie wdrożenia na serwerze proxy interfejsu API w zaktualizowanym organizacji, a następnie sprawdzić pliki dziennika procesora wiadomości. Wpis w dzienniku opisujący zdarzenia wdrożenia powinny zawierać wartość mode:API.

Więcej informacji znajdziesz w artykule Pliki dziennika.