Como adicionar e configurar uma extensão

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

O Apigee Edge inclui vários pacotes de extensões instalados. Antes de usar uma extensão em um proxy de API com uma política de extensão de frase de destaque, você precisa adicionar e configurar a extensão. Ao adicionar uma extensão, você localiza o pacote 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 de borda.

Ao configurar uma extensão de um pacote, 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 precisa usar ao criar, receber e excluir documentos. Cada extensão tem o próprio conjunto de propriedades de configuração que correspondem a aspectos do recurso com que ela interage. Para ver uma lista das 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 ela 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 sem tráfego pode não ter uma instância disponível para responder às solicitações. Assim, a primeira solicitação de uma extensão pode demorar mais enquanto o ambiente cria uma instância da extensão para uso.

Para começar, consulte Tutorial: como adicionar e usar uma extensão.

Como adicionar e configurar uma extensão

  1. Faça login no Edge, clique no menu Administrador e em Extensões.

    A página Extensions exibida lista todas as extensões que foram configuradas nos pacotes de extensões disponíveis no sistema. Se quiser visualizar uma extensão configurada existente, você pode filtrar a lista digitando termos de filtragem na parte superior da página.

    Nas próximas etapas, você adicionará sua própria extensão.

  2. Na página Extensão, clique em Adicionar extensão.

    A página "Selecionar uma extensão" divide as extensões entre aquelas desenvolvidas pelo Google e aquelas desenvolvidas por outras empresas.

  3. Em Selecionar uma extensão, clique na guia e localize a extensão correspondente ao recurso externo que você está acessando.

    Na caixa do pacote de extensão, clique em Visualizar detalhes para ver informações sobre a versão, o autor e outras informações da extensão.

  4. Clique na caixa do pacote de extensão para começar a configurar uma extensão do pacote.

  5. Na caixa de diálogo Extension Properties, insira um nome e uma descrição para ela e clique em Create.

  6. Na página Extensão > My-Extension-Name da extensão que você está criando, localize um ambiente do Apigee Edge para configurar a extensão.

    Uma extensão precisa ser implantada no mesmo ambiente que o proxy de API que a usará.

  7. Clique na linha do ambiente na lista.

  8. Na caixa de diálogo Configuration, selecione ou insira valores para configurar a 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ões estão listadas na Visão geral da referência de extensões.

  9. Clique em Salvar.

Como implantar uma extensão

  1. 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, faça o seguinte: