Você está lendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. info
O Apigee Edge inclui vários pacotes de extensão instalados. Antes de usar uma extensão em um proxy de API com uma política de chamada de extensão, é necessário adicionar e configurar a extensão. Ao adicionar uma extensão, você localiza o pacote de extensão que representa o recurso externo que você quer integrar ao proxy de API, adiciona e configura uma extensão desse pacote e implanta a extensão em um ambiente do Edge.
Ao configurar uma extensão de um pacote de extensão, você especifica valores que focam a interação da extensão com o recurso externo. Por exemplo, ao configurar uma extensão do Google Cloud Firestore, você especifica qual banco de dados a extensão deve usar ao criar, receber e excluir documentos. Cada extensão tem seu próprio conjunto de propriedades de configuração que correspondem a aspectos do recurso com que ela interage. Para uma lista de extensões incluídas, consulte a Visão geral da referência de extensões.
Normalmente, a configuração de cada extensão inclui as credenciais que a extensão deve usar para autenticar com o recurso em seu nome.
O ambiente de implantação de extensões é elástico para oferecer suporte ao escalonamento automático com base na carga. Como resultado, por padrão, uma implantação de extensão que não tem tráfego pode não ter uma instância disponível para responder a solicitações. Portanto, a primeira solicitação para uma extensão pode levar mais tempo enquanto o ambiente cria uma instância da extensão para uso.
Para um tutorial de introdução, consulte Tutorial: como adicionar e usar uma extensão.
Como adicionar e configurar uma extensão
Faça login no Edge, clique no menu Administrador e em Extensões.
A página Extensões que aparece lista todas as extensões que foram configuradas a partir de pacotes de extensão disponíveis no sistema. Se você quiser visualizar uma extensão configurada, filtre a lista digitando termos de filtragem na parte de cima da página.
Nas próximas etapas, você vai adicionar sua própria extensão.
Na página Extensão, clique em Adicionar extensão.
A página "Selecionar uma extensão" que aparece divide as extensões entre aquelas desenvolvidas pelo Google e aquelas desenvolvidas por outras empresas.
Em Selecionar uma extensão, clique na guia desejada e localize a extensão correspondente ao recurso externo que você está acessando.
Na caixa do pacote de extensão, clique em "Ver detalhes" para conferir informações sobre a versão, o autor da extensão e assim por diante.
Clique na caixa do pacote de extensão para começar a configurar uma extensão do pacote.
Na caixa de diálogo Propriedades da extensão , insira um nome e uma descrição para a extensão e clique em Criar.
Na página Extensão > My-Extension-Name da extensão que você está criando, localize um ambiente do Apigee Edge para o qual você quer configurar a extensão.
Uma extensão precisa ser implantada no mesmo ambiente que o proxy de API que a usará.
Clique na linha do ambiente na lista.
Na caixa de diálogo Configuração, selecione ou insira valores para configurar essa extensão.
Cada extensão tem as próprias propriedades de configuração. Para descrições das propriedades, use a referência da extensão. As referências de extensão estão listadas na Visão geral da referência de extensões.
Clique em Salvar.
Como implantar uma extensão
- Na página Extensão > My-Extension-Name da extensão, clique em Implantar para implantar a extensão para uso de um proxy de API.
Depois de implantar uma extensão:
Adicione a extensão a um proxy de API usando a política de chamada de extensão.
É possível visualizar os dados de registro gerados pela extensão. Para mais informações, consulte Como visualizar registros de extensão.