Ativar implantação HTTP

Por padrão, o Edge usa RPC para implantar proxies de API. Embora esse modo funcione muito bem na maioria das instalações, topologias maiores com muitos MPs podem enfrentar tempos limite quando um grande número de chamadas simultâneas é feito por meio de 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 fornecer 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 via HTTP (além de RPC). Defina como true para permitir a implantação HTTP. Caso contrário, false. O padrão é false.

Para ativar implantações HTTP, defina esta propriedade como true.

use.http.for.configuration

Especifica o método a ser usado 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 o RPC primeiro. Se um evento falhar por RPC, o Edge tentará o HTTP. Isso poderá causar atrasos se for necessário usar HTTP.
  • always: todos os eventos de configuração usam HTTP.

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

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

O exemplo a seguir chama a API Update organization Properties 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 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 analise 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 registros.