Você pode testar ou publicar uma integração do Editor de integração depois de adicionar e configurar a integração com as conexões necessárias de acionadores, tarefas e edge. Quando você testa ou publica uma integração usando o console do Google Cloud, ela é executada no modo síncrono.
Papel necessário
Para garantir que a conta de usuário tenha as permissões necessárias
para testar ou publicar uma integração
peça ao administrador para conceder à conta de usuário
o papel Agente de serviço do Application Integration (roles/integrations.serviceAgent
) do IAM no projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
O administrador também pode conceder à conta de usuário as permissões necessárias via papéis personalizados ou outros papéis predefinidos.
Testar uma integração
Se você quiser verificar se a integração está funcionando conforme o esperado, faça um teste antes de publicar. Testar uma integração permite que você teste os valores da variável de entrada de integração e ajuda a identificar falhas no fluxo de conexão da integração.
Para testar uma integração, siga estas etapas:
- Na IU da Apigee, selecione sua organização da Apigee.
- Clique em Desenvolver > Integrações.
- Selecione a integração que você quer testar.
- Na barra de navegação do designer, clique em Testar.
Se você tiver vários gatilhos configurados na integração, selecione o gatilho em que você quer testar a execução da integração. O painel Test Integration é exibido.
- Clique em Testar integração.
O teste de integração da Apigee executa a integração e exibe o resultado da execução no painel Testar integração.
- Para editar as variáveis de entrada, clique em Editar variáveis de entrada.
- Para testar a integração novamente, clique em Testar a integração novamente.
- Para restaurar os valores, clique em Restaurar valores.
- Para ver e inspecionar os registros de execução da execução do teste, clique em Ver registros.
- Se você tiver ativado o Cloud Logging, clique em Visualizar registros do Cloud para ver os registros no Cloud Logging.
- Para editar a integração sem criar uma nova versão, clique em Editar integração.
- Para fechar a operação de teste e retornar ao editor de integração, clique em Fechar.
Publicar uma integração
Publicar uma versão de integração implanta essa versão de integração e a coloca em um estado ativo. A versão da integração publicada anteriormente será automaticamente cancelada, e todos os serviços que dependem da versão publicada anteriormente usarão automaticamente a versão mais recente.
Para fazer o download de uma integração, siga estas etapas:
- Na IU da Apigee, selecione sua organização da Apigee.
- Clique em Desenvolver > Integrações.
- Selecione a integração que você quer publicar.
- Na barra de navegação do designer, clique no menu suspenso Versão e selecione a versão de integração que você quer publicar.
- Clique em Publicar.
A caixa de diálogo Autogenerate Integration description vai aparecer. Se quiser gerar uma descrição, clique em Claro, continuar. Caso contrário, clique em Não, publicar.
Após a publicação da integração, você poderá ver e inspecionar os registros de execução da integração publicada. Para ver os registros, clique em Registros na barra de ferramentas do editor de integração.
Por padrão, a integração da Apigee bloqueia uma integração de edição quando ela é publicada. Para fazer alterações na integração publicada, clique em Ativar edição no editor de integração. Editar uma integração publicada criará uma nova versão dela.
Cancelar a publicação de uma integração
Cancelar a publicação de uma versão de integração ativa cancela a implantação dessa versão e a coloca em um estado de snapshot. Todos os serviços que dependem da versão publicada da integração serão automaticamente interrompidos.
Para fazer o download de uma integração, siga estas etapas:
- Na IU da Apigee, selecione sua organização da Apigee.
- Clique em Desenvolver > Integrações.
- Selecione a integração que você quer cancelar.
- Na barra de navegação do designer, clique no menu suspenso Versão e selecione a versão de integração que você quer cancelar.
- Clique em Unpublish.
Após a publicação da integração, clique em Ativar edição no editor de integração para editar a integração. A edição da integração cria uma nova versão dela.
Cotas e limites
Para informações sobre cotas e limites de integração da Apigee, consulte Cotas e limites.
Prática recomendada
- Defina a usabilidade de uma variável (de entrada ou saída) antes de testar sua integração. Consulte Variáveis de integração.
- Defina o tratamento de erros para sua integração.