Ativar implantação HTTP

Por padrão, o Edge usa RPC para implantar proxies de API. Embora esse modo funcione muito bem para a maioria das instalações, topologias maiores com muitos MPs podem apresentar tempos limite quando um grande número de chamadas simultâneas é feito por RPC. A Apigee planeja descontinuar essa implementação no futuro.

Como resultado, a Apigee recomenda que implantações maiores usem HTTP em vez de RPC para implantação.

Além de potencialmente oferecer maior confiabilidade, ativar a implantação HTTP também melhora o conteúdo e o formato das exceções que podem ser geradas durante o processo de implantação.

Nesta seção, descrevemos como ativar o HTTP para implantação.

Atualizar sua organização

Para ativar a implantação HTTP, envie uma solicitação PUT para a API Update organization properties. Defina as seguintes propriedades no corpo da solicitação:

Propriedade Descrição
allow.deployment.over.http Determina se o Edge pode implantar proxies de API por HTTP (além de RPC). Defina como true para permitir a implantação de HTTP. Caso contrário, defina como false. O padrão é false.

Para ativar as implantações HTTP, defina essa propriedade como true.
use.http.for.configuration

Especifica qual método usar para eventos de configuração. Os valores possíveis são:

  • never: todos os eventos de configuração usam RPC. Esse é o padrão.
  • retry: todos os eventos de configuração usam RPC primeiro. Se um evento falhar via RPC, o Edge tentará HTTP. Isso pode causar atrasos se você precisar usar HTTP.
  • always: todos os eventos de configuração usam HTTP.

Para ativar as implantações HTTP, a Apigee recomenda definir essa propriedade como always.

Além de definir essas propriedades no corpo da mensagem, é necessário definir o cabeçalho Content-Type como application/json ou application/xml.

O exemplo a seguir chama a API de atualização de propriedades da organização com um corpo de mensagem 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"
      } ]
    }
  }'

Para ativar a implantação HTTP em todos os proxies de API em todas as suas organizações, atualize cada organização conforme descrito acima.

Testar a atualização

Para testar se a atualização foi bem-sucedida, acione um evento de implantação em um proxy de API na organização atualizada e, em seguida, consulte os arquivos de registro do processador de mensagens. A entrada de registro dos eventos de implantação precisa conter mode:API.

Para mais informações, consulte Arquivos de registro.