Como desenvolver fluxos compartilhados

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

Observação: use o desenvolvimento local com a Apigee e a Apigee híbrida 1.5 e posteriores.

Combine políticas e recursos em um fluxo compartilhado que você possa consumir a partir de vários proxies de API e até mesmo de outros fluxos compartilhados. Ele é semelhante a um proxy, mas um fluxo compartilhado não tem endpoint. É possível usá-lo somente a partir de um proxy de API ou fluxo compartilhado que esteja na mesma organização do fluxo compartilhado.

Desenvolva seus fluxos compartilhados usando a Apigee no Cloud Code, conforme descrito nas seções a seguir. Consulte também Como gerenciar pastas e arquivos em um espaço de trabalho da Apigee.

Antes de começar: familiarize-se com os conceitos descritos nos seguintes tópicos:

• Como criar fluxos compartilhados reutilizáveis
• Como anexar um fluxo compartilhado usando um gancho de fluxo

Como criar um fluxo compartilhado

Para criar um fluxo compartilhado usando a Apigee no Cloud Code:

1. Realize uma das seguintes etapas:

   • Na seção da Apigee, posicione o cursor sobre a pasta shareflows e clique em .

   • Selecione Visualizar > Paleta de Comandos para abrir a paleta de comandos e selecione Cloud Code: criar pacote de fluxo compartilhado da Apigee.

   O assistente "Criar fluxo compartilhado" é aberto.

2. Digite um nome exclusivo para o fluxo compartilhado no prompt e aperte Enter.

Depois de concluir as etapas no assistente, a nova pasta sharedflow-name será adicionada em sharedflows na seção da Apigee. Cada pasta de fluxo compartilhado é estruturada conforme descrito em Estrutura do diretório do pacote de fluxo compartilhado

Como fazer upload de um pacote de fluxo compartilhado

Para fazer upload de um pacote de fluxo compartilhado usando a Apigee no Cloud Code:

1. Realize uma das seguintes ações:

   • Na seção da Apigee, posicione o cursor sobre a pasta sharedflows e clique em .

   • Selecione Visualizar > Paleta de comandos para abrir a paleta de comandos e selecione Cloud Code: importar pacote de fluxo compartilhado da Apigee.

2. Acesse o pacote de fluxo compartilhado que será feito upload e clique em Importar fluxo compartilhado. O pacote de fluxo compartilhado precisa ser estruturado conforme descrito em Estrutura do diretório do pacote de fluxo compartilhado.

3. (Opcional) Por padrão, o nome do arquivo ZIP menos a extensão dele é usado para o nome do fluxo compartilhado. Se o nome não for exclusivo, você deverá digitar um nome exclusivo.

A pasta sharedflow-name enviada é adicionada em sharedflows no Explorador da Apigee.

Como configurar fluxos compartilhados

Configure fluxos compartilhados conforme descrito nos seguintes tópicos:

• Como criar fluxos compartilhados reutilizáveis
• Como adicionar recursos usando políticas
• Como gerenciar recursos

Como usar fluxos compartilhados

Você pode chamar um fluxo compartilhado usando a política FlowCallout, conforme descrito em Política FlowCallout.

Além disso, ao anexar um fluxo compartilhado a um gancho de fluxo, é possível executá-lo antes de um proxy ou de uma solicitação de destino, ou depois de um proxy ou uma resposta de destino. Veja mais informações em:

• Como anexar um fluxo compartilhado usando um gancho de fluxo (visão geral conceitual)
• Como anexar fluxos compartilhados usando ganchos de fluxo (flowhooks.json) (etapas usando a Apigee no Cloud Code)

Observação: a Apigee não valida as dependências entre fluxos compartilhados e proxies de API no momento da implantação. Por exemplo, se a política FlowCallout em um proxy de API referir-se a um fluxo compartilhado que não existe ou não foi implantado, a implantação do proxy de API ainda será concluída. Quando a Apigee verifica a dependência no ambiente de execução e a validação falha, a Apigee lança um erro de proxy de API com um código de status HTTP 500.