Crie fluxos de trabalho de aplicativos lógicos padrão para implantação híbrida em sua própria infraestrutura

Aplica-se a: Aplicativos Lógicos do Azure (Padrão)

Para cenários em que você precisa usar, controlar e gerenciar sua própria infraestrutura, você pode criar fluxos de trabalho de aplicativo lógico padrão usando o modelo de implantação híbrida nos Aplicativos Lógicos do Azure. Esse modelo fornece recursos para que você crie e hospede soluções de integração para ambientes parcialmente conectados que exigem processamento local, armazenamento e acesso à rede. Sua infraestrutura pode incluir sistemas locais, nuvens privadas e nuvens públicas. Com o modelo híbrido, seu fluxo de trabalho de aplicativo lógico padrão é alimentado pelo tempo de execução dos Aplicativos Lógicos do Azure, que é hospedado no local como parte de uma extensão de Aplicativos de Contêiner do Azure.

Para obter uma visão geral da arquitetura que mostra onde os fluxos de trabalho do aplicativo lógico padrão são hospedados e executados em um ambiente parcialmente conectado, consulte Configurar requisitos de infraestrutura para implantação híbrida para aplicativos lógicos padrão.

Este guia de instruções mostra como criar e implantar um fluxo de trabalho de aplicativo lógico padrão usando o modelo de implantação híbrida depois de configurar os recursos locais necessários para hospedar seu aplicativo.

Limitações

A seção a seguir descreve as limitações para a opção de implantação híbrida:

Pré-requisitos

• Uma conta e uma subscrição do Azure. Se não tiver uma subscrição, inscreva-se numa conta do Azure gratuita.

• Os seguintes recursos locais, que devem existir todos na mesma rede para a conectividade necessária:

  • Um cluster do Serviço Kubernetes do Azure conectado ao Azure Arc
  • Um banco de dados SQL para armazenar localmente o histórico de execução do fluxo de trabalho, entradas e saídas para processamento
  • Uma partilha de arquivos SMB (Server Message Block) para armazenar localmente artefatos usados pelos seus workflows.

  Para atender a esses requisitos, configure esses recursos locais para dar suporte à implantação híbrida para aplicativos lógicos padrão.

• Para trabalhar no Visual Studio Code, você precisa da extensão Azure Logic Apps (Standard) para Visual Studio Code com os pré-requisitos relacionados.

  Gorjeta

  Se você tiver uma nova instalação do Visual Studio Code, confirme se você pode executar localmente um fluxo de trabalho padrão básico antes de tentar implantar em sua própria infraestrutura. Esta execução de teste ajuda a isolar quaisquer erros que possam existir no seu projeto de fluxo de trabalho Padrão.

Crie seu aplicativo lógico padrão

Versionamento para implantações híbridas

Uma aplicação lógica padrão com a opção de hospedagem híbrida cria automaticamente uma nova revisão, que é um conceito de controlo de versão das Aplicações de Contêiner do Azure, sempre que se guardam alterações num fluxo de trabalho secundário. Essa revisão pode levar um pouco de tempo para ser ativada, o que significa que, depois de salvar as alterações, convém aguardar vários momentos antes de testar seu fluxo de trabalho.

Se as alterações ainda não apareceram no fluxo de trabalho, você pode verificar se a revisão existe:

1. No portal do Azure, abra seu recurso. No menu de recursos, em Revisão, selecione Revisões e réplicas.

2. Na página Revisões e réplicas, na guia de Revisões ativas, verifique se uma nova revisão aparece na lista.

Para obter mais informações, consulte os seguintes recursos:

• Atualizar e implantar alterações nos Aplicativos de Contêiner do Azure

• Gerenciar revisões em Aplicativos de Contêiner do Azure

Configurar telemetria aprimorada ou OpenTelemetry para monitoramento de desempenho

Você pode configurar a coleta de telemetria aprimorada no Application Insights para seu aplicativo lógico padrão e, em seguida, exibir os dados coletados depois que o fluxo de trabalho concluir uma execução. Esse recurso oferece uma experiência mais simples para obter informações sobre seus fluxos de trabalho e mais controle sobre a filtragem de eventos na fonte de dados, o que ajuda a reduzir os custos de armazenamento. Essas melhorias se concentram em métricas de desempenho em tempo real que fornecem informações sobre a integridade e o comportamento do seu sistema.

Para cenários parcialmente conectados e locais, você pode configurar seu aplicativo lógico padrão para emitir telemetria com base nas configurações do aplicativo com suporte OpenTelemetry que você define para o ambiente específico. Por padrão, esses dados de telemetria são enviados para o Application Insights. Para obter mais informações, consulte Habilitar telemetria aprimorada no Application Insights para fluxos de trabalho padrão em Aplicativos Lógicos do Azure.

Alterar a vCPU e a alocação de memória no portal do Azure

Você pode editar as configurações de vCPU e memória para seu recurso de aplicativo lógico padrão. Essas alterações afetam a taxa de faturação para as tarefas do aplicativo lógico padrão.

1. No portal do Azure, abra seu recurso de aplicativo lógico padrão.

2. No menu de recursos, em Configurações, selecione Contêineres.

3. Na barra de ferramentas da página Contêineres, selecione Editar e implantar, que abre o painel Editar um contêiner.

4. Na guia Propriedades, em Alocação de recursos de contêiner, altere os seguintes valores para se adequar ao seu cenário:

   Propriedade	Valor	Descrição
   Núcleos de CPU	- Padrão: 1 - Mínimo: 0,25 - Máximo: 2	Determina os núcleos vCPU a serem atribuídos à sua instância de contêiner. Você pode aumentar esse valor em 0,25 núcleos até o valor máximo. O número total em todas as instâncias de contêiner para este aplicativo lógico é limitado a 2 núcleos.
   Memória	- Padrão: 2 - Mínimo: 0,1 - Máximo: 4	Determina a capacidade de memória em gibibytes (GiB) para atribuir à sua instância de contêiner. Pode aumentar este valor em 0,1 GiB até ao valor máximo. A capacidade total em todas as instâncias de contêiner para este aplicativo lógico é limitada a 4 GiB.

5. Quando terminar, selecione Guardar.

Alterar o dimensionamento de réplica no portal do Azure

Você pode controlar o dimensionamento automático para o número de réplicas que são implantadas em resposta a um evento de ativação. Uma réplica é uma nova instância de uma revisão ou versão de recursos de aplicativo lógico. Para alterar os valores mínimo e máximo para esse intervalo, você pode modificar as regras de escala para determinar os tipos de evento que acionam o dimensionamento. Para obter mais informações, veja Definir regras de dimensionamento no Azure Container Apps.

1. No portal do Azure, abra seu recurso de aplicativo lógico padrão.

2. No menu de recursos, em Configurações, selecione Escala.

3. Na página Escala, em Configuração da regra de escala, altere os seguintes valores para se ajustar ao seu cenário:

   Propriedade	Valor	Descrição
   Réplicas mínimas	- Padrão: 1 - Mínimo: 0 - Máximo: 1000	Determina o número mínimo de réplicas permitidas para a revisão a qualquer momento. Esse valor substitui as regras de escala e deve ser menor que o número máximo de réplicas.
   Máximo de réplicas	- Padrão: 30 - Mínimo: 0 - Máximo: 1000	Determina o número máximo de réplicas permitidas para a revisão a qualquer momento. Esse valor substitui as regras de escala.

4. Quando terminar, selecione Guardar.

Controle o tráfego de entrada para seu aplicativo lógico no portal do Azure

Você pode expor seu aplicativo lógico à Web pública, sua rede virtual e outros aplicativos lógicos em seu ambiente habilitando a entrada. O Azure impõe configurações de entrada por meio de um conjunto de regras que controlam o roteamento do tráfego externo e interno para seu aplicativo lógico. Quando você habilita a entrada, não precisa criar um Balanceador de Carga do Azure, endereço IP público ou quaisquer outros recursos do Azure para habilitar solicitações HTTP de entrada ou tráfego TCP. Para obter mais informações, consulte Ingress in Container Apps.

1. No menu de recursos, em Configurações, selecione Ingressar.

2. Na página Ingresso, ao lado de Ingresso, selecione a caixa Habilitado.

3. Com base no seu cenário, configure as opções restantes.

   Para obter mais informações, veja a seguinte documentação:

   • Configurar o ingresso para a sua aplicação nos Apps de Contêiner do Azure
   • Configurar restrições de entrada de IP em Aplicativos de Contêiner do Azure

Configurar a autenticação para conexões de API gerenciadas

Para autenticar conexões de API gerenciadas em fluxos de trabalho de aplicativos lógicos padrão hospedados em clusters Kubernetes habilitados para Azure Arc, você deve criar seu próprio registro de aplicativo usando o Microsoft Entra ID. Em seguida, você pode adicionar os valores desse registro de aplicativo como variáveis de ambiente em seu recurso de aplicativo lógico padrão para autenticar suas conexões de API.

Criar um registo de aplicação com o Microsoft Entra ID

Portal do Azure

1. No portal do Azure, siga Guia de início rápido: registrar um aplicativo na plataforma de identidade da Microsoft para criar um registro de aplicativo.

2. Após a conclusão da criação, encontre seu novo registro de aplicativo no portal.

3. No menu de recursos, selecione Visão geral e salve os seguintes valores, que você precisará mais tarde para autenticação de conexão:

   • ID de Cliente
   • ID do Inquilino
   • Segredo do cliente

4. Para a ID do objeto, execute estas etapas:

   1. Na página Visão geral, selecione Aplicativo gerenciado no link do diretório local para o registro do aplicativo, conforme mostrado:

      

   2. Na página que se abre, copie e guarde o valor do ID do Objeto:

      

5. Agora, adicione os valores salvos como variáveis de ambiente ao recurso do aplicativo lógico padrão.

CLI do Azure

1. Para criar o registro do aplicativo, use o comando az ad sp create.

2. Para rever todas as propriedades, use o comando az ad sp show.

3. Na saída de ambos os comandos, localize e salve os seguintes valores, que você precisará mais tarde para autenticação de conexão:

   • ID de Cliente
   • ID do Objeto
   • ID do Inquilino
   • Segredo do cliente

4. Agora, adicione os valores salvos como variáveis de ambiente ao recurso do aplicativo lógico padrão.

Adicionar valores de registo de aplicação à sua aplicação lógica padrão

1. No portal do Azure, aceda ao recurso de Aplicação lógica Standard.

2. No menu de recursos, em Configurações, selecione Contêineres e, em seguida, selecione a guia Variáveis de ambiente.

   Para obter mais informações sobre configurações de aplicativo e configurações de host, consulte Editar configurações de aplicativo e configurações de host.

3. Na barra de ferramentas, selecione Editar e implantar.

4. No painel Editar um contêiner, selecione Variáveis de ambiente e, em seguida, selecione Adicionar.

5. Na tabela a seguir, adicione cada variável de ambiente com o valor especificado:

   Variável de ambiente	Valor
   WORKFLOWAPP_AAD_CLIENTID	< ID do meu cliente>
   WORKFLOWAPP_AAD_OBJECTID	< my-object-ID>
   WORKFLOWAPP_AAD_TENANTID	< my-tenant-ID>
   WORKFLOWAPP_AAD_CLIENTSECRET	< meu-cliente-segredo>

6. Quando terminar, selecione Guardar.

Armazenar e referenciar o ID do cliente e o segredo do cliente

Você pode armazenar o identificador do cliente e os segredos do cliente no seu recurso de aplicação lógica e, em seguida, fazer referência a esses valores na guia Variáveis de ambiente.

1. No portal do Azure, vá para o recurso Logic App.

2. No menu de recursos, em Configurações, selecione Segredos.

3. Na barra de ferramentas, selecione Adicionar.

4. No painel Adicionar segredo, forneça as seguintes informações para cada segredo e selecione Adicionar:

   Chave	Valor
   WORKFLOWAPP_AAD_CLIENTID	< ID do meu cliente>
   WORKFLOWAPP_AAD_CLIENTSECRET	< meu-cliente-segredo>

Problemas conhecidos e resolução de problemas

A seção a seguir descreve os problemas atualmente conhecidos e as diretrizes para solucionar problemas comuns.

Problemas gerais de configuração do ambiente ou implantação do portal

Para ajudá-lo a diagnosticar e depurar problemas com a configuração do ambiente ou falhas de implantação do portal, você pode tentar executar o script dotroubleshoot.ps1 PowerShell fornecido para a opção de implantação híbrida.

1. Vá para o repositório GitHub do Azure Logic Apps: scripts/pasta hybrid.

2. Copie o arquivo troubleshoot.ps1 para uma pasta no mesmo local da implantação do aplicativo lógico.

3. Execute o script usando o PowerShell.

Clusters Kubernetes habilitados pelo Arc

Em cenários raros, poderás notar um alto consumo de memória no teu cluster. Para evitar esse problema, aumente a capacidade ou adicione redimensionamento automático para pools de nós.

O host de função não está em execução

Depois de implantar seu aplicativo lógico padrão, confirme se o aplicativo está sendo executado corretamente.

1. No portal do Azure, abra seu recurso de aplicativo lógico.

2. No menu de recursos, selecione Visão geral.

3. Na página Visão geral, ao lado do campo URL do aplicativo, selecione a URL do recurso.

   Se o seu aplicativo estiver sendo executado corretamente, uma janela do navegador será aberta e mostrará a seguinte mensagem:

   

   Caso contrário, se a sua aplicação tiver alguma falha, verifique se os seus pods AKS estão a funcionar corretamente. No Windows PowerShell, execute os seguintes comandos:

   az aks get-credentials {resource-group-name} --name {aks-cluster-name} --admin
   kubectl get ns
   kubectl get pods -n logicapps-aca-ns
   kubectl describe pod {logic-app-pod-name} -n logicapps-aca-ns 
   

   Para obter mais informações, veja a seguinte documentação:

   • AZ AKS Get-Credenciais
   • Ferramenta de linha de comando (kubectl)

O cluster não tem nós suficientes

Se você executou o comando anterior e recebe um aviso semelhante ao exemplo a seguir, seu cluster não tem nós suficientes para processamento:

Warning: FailedScheduling  4m52s (x29 over 46m)  default-scheduler  0/2 nodes are available: 2 Too many pods. preemption: 0/2 nodes are available: 2 No preemption victims found for incoming pod.

Para aumentar o número de nós e configurar o dimensionamento automático, siga estas etapas:

1. No portal do Azure, vá para sua instância de serviço do Kubernetes.

2. No menu de instâncias, em Configurações, selecione Pools de nós.

3. Na barra de ferramentas da página Ferramentas do Nó, selecione + Adicionar pool de nós.

Para obter mais informações, veja a seguinte documentação:

• Criar conjuntos de nós para um cluster no Serviço Kubernetes do Azure (AKS)
• Gerir grupos de nós para o cluster no Serviço Kubernetes do Azure (AKS)
• Visão geral do dimensionamento automático de cluster no Serviço Kubernetes do Azure (AKS)
• Utilizar o autoscaler de cluster no Serviço Kubernetes do Azure (AKS)

Driver CSI (SMB Container Storage Interface) não instalado

Depois de executar o comando anterior kubectl describe pod , se o seguinte aviso aparecer, confirme se o driver CSI para seu compartilhamento de arquivos SMB está instalado corretamente:

Warning FailedScheduling 5m16s (x2 over 5m27s)  default-scheduler 0/14 nodes are available: pod has unbound immediate PersistentVolumeClaims. preemption: 0/14 nodes are available: 14 Preemption is not helpful for scheduling.

Normal NotTriggerScaleUp 9m49s (x31 over 14m) cluster-autoscaler pod didn't trigger scale-up: 3 pod has unbound immediate PersistentVolumeClaims

Para confirmar, a partir do Windows PowerShell, execute os seguintes comandos:

kubectl get csidrivers

Se a lista de resultados exibida não incluir smb.csi.k8s.io, em um prompt de comando do Windows, execute o seguinte comando:

helm repo add csi-driver-smb
helm repo update helm install csi-driver-smb csi-driver-smb/csi-driver-smb --namespace kube-system --version v1.15.0

Para verificar o status dos pods do driver CSI SMB, no prompt de comando do Windows, execute o seguinte comando:

kubectl --namespace=kube-system get pods --selector="app.kubernetes.io/name=csi-driver-smb" --watch

Para obter mais informações, consulte CSI (Container Storage Interface) drivers no Serviço Kubernetes do Azure (AKS).

Conteúdos relacionados

• Configurar requisitos para a implantação de aplicativos lógicos padrão em sua própria infraestrutura
• Habilitar telemetria aprimorada no Application Insights para fluxos de trabalho padrão em Aplicativos Lógicos do Azure