Partilhar via


Habilite o modo stateful para conectores internos sem monitoração de estado nos Aplicativos Lógicos do Azure

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

Nos fluxos de trabalho de aplicativos lógicos padrão, os seguintes conectores internos baseados em provedor de serviços são sem monitoração de estado, por padrão:

  • Azure Service Bus
  • SAP
  • IBM MQ

Para executar essas operações de conector no modo com monitoração de estado, você deve habilitar esse recurso. Este guia de instruções mostra como habilitar o modo stateful para esses conectores.

Pré-requisitos

Habilitar o modo stateful no portal do Azure

  1. No portal do Azure, abra o recurso de aplicativo lógico padrão onde você deseja habilitar o modo com monitoração de estado para essas operações de conector.

  2. Para habilitar a integração de rede virtual para seu aplicativo lógico e adicionar seu aplicativo lógico à sub-rede criada anteriormente, siga estas etapas:

    1. No recurso de menu do aplicativo lógico, em Configurações, selecione Rede.

    2. Na seção Configuração de tráfego de saída, ao lado de Integração de rede virtual, selecione Não configurado>Adicionar integração de rede virtual.

    3. No painel Adicionar integração de rede virtual que é aberto, selecione sua assinatura do Azure e sua rede virtual.

    4. Na lista Sub-rede, selecione a sub-rede à qual deseja adicionar seu aplicativo lógico.

    5. Quando terminar, selecione Conectar e retorne à página Rede .

      A propriedade de integração de rede virtual agora está definida como a rede virtual e a sub-rede selecionadas, por exemplo:

      A captura de tela mostra o portal do Azure, o recurso do aplicativo lógico padrão, a página Rede com a rede virtual selecionada e a sub-rede.

    Para obter informações gerais sobre como habilitar a integração de rede virtual com seu aplicativo, consulte Habilitar integração de rede virtual no Serviço de Aplicativo do Azure.

  3. Em seguida, atualize a configuração subjacente do site do aplicativo lógico (<logic-app-name.azurewebsites.net>) usando uma das seguintes ferramentas:

Atualizar a configuração do site para o aplicativo lógico

Depois de habilitar a integração de rede virtual para seu aplicativo lógico, você deve atualizar a configuração de site subjacente do aplicativo lógico (<logic-app-name.azurewebsites.net>) usando um dos seguintes métodos:

  • Portal do Azure (token de portador não necessário)
  • API de Gerenciamento de Recursos do Azure (token de portador necessário)
  • Azure PowerShell (token de portador não necessário)

Portal do Azure

Para configurar portas privadas de rede virtual usando o portal do Azure, siga estas etapas:

  1. No portal do Azure, localize e abra seu recurso de aplicativo lógico padrão.
  2. No menu do aplicativo lógico, em Configurações, selecione Configuração.
  3. Na página Configuração, selecione Configurações gerais.
  4. Em Configurações da plataforma, na caixa Portas privadas de rede virtual, insira as portas que você deseja usar.

API de Gerenciamento de Recursos do Azure

Para concluir esta tarefa com a API de Gerenciamento de Recursos do Azure - Atualização por Id, examine os seguintes requisitos, sintaxe e valores de parâmetro.

Requisitos

É necessária autorização OAuth e o token ao portador. Para obter o token ao portador, siga estas etapas

  1. Enquanto estiver conectado ao portal do Azure, abra as ferramentas de desenvolvedor do navegador da Web (F12).

  2. Obtenha o token enviando qualquer solicitação de gerenciamento, por exemplo, salvando um fluxo de trabalho em seu aplicativo lógico padrão.

Sintaxe

Atualiza um recurso usando a ID de recurso especificada:

PATCH https://management.azure.com/{resourceId}?api-version=2021-04-01

Valores dos parâmetros

Elemento Value
Método de pedido HTTP REMENDO
<resourceId> assinaturas/{yourSubscriptionID}/resourcegroups/{yourResourceGroup}/providers/Microsoft.Web/sites/{websiteName}/config/web
<yourSubscriptionId> A ID da sua subscrição do Azure
<yourResourceGroup> O grupo de recursos que contém o recurso do aplicativo lógico
<Nome do site> O nome do recurso do aplicativo lógico, que é mystandardlogicapp neste exemplo
Corpo da solicitação HTTP {"propriedades": {"vnetPrivatePortsCount": "2"}}

Exemplo

https://management.azure.com/subscriptions/XXxXxxXX-xXXx-XxxX-xXXX-XXXXxXxXxxXX/resourcegroups/My-Standard-RG/providers/Microsoft.Web/sites/mystandardlogicapp/config/web?api-version=2021-02-01

Azure PowerShell

Para concluir essa tarefa com o Azure PowerShell, revise os seguintes requisitos, sintaxe e valores. Este método não requer que você obtenha manualmente o token de portador.

Sintaxe

Set-AzContext -Subscription {yourSubscriptionID}
$webConfig = Get-AzResource -ResourceId {resourceId}
$webConfig.Properties.vnetPrivatePortsCount = 2
$webConfig | Set-AzResource -ResourceId {resourceId}

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

Valores dos parâmetros

Elemento Value
<seuSubscriptionID> A ID da sua subscrição do Azure
<resourceId> assinaturas/{yourSubscriptionID}/resourcegroups/{yourResourceGroup}/providers/Microsoft.Web/sites/{websiteName}/config/web
<yourResourceGroup> O grupo de recursos que contém o recurso do aplicativo lógico
<Nome do site> O nome do recurso do aplicativo lógico, que é mystandardlogicapp neste exemplo

Exemplo

https://management.azure.com/subscriptions/XXxXxxXX-xXXx-XxxX-xXXX-XXXXxXxXxxXX/resourcegroups/My-Standard-RG/providers/Microsoft.Web/sites/mystandardlogicapp/config/web?api-version=2021-02-01

Resolver erros

Erro: A contagem de instâncias reservadas é inválida

Se você receber um erro dizendo que a contagem de instâncias reservadas é inválida, use a seguinte solução alternativa:

$webConfig.Properties.preWarmedInstanceCount = $webConfig.Properties.reservedInstanceCount
$webConfig.Properties.reservedInstanceCount = $null
$webConfig | Set-AzResource -ResourceId {resourceId}

Exemplo de erro:

Set-AzResource :
{
   "Code":"BadRequest",
   "Message":"siteConfig.ReservedInstanceCount is invalid.  Please use the new property siteConfig.PreWarmedInstanceCount.",
   "Target": null,
   "Details":
   [
      {
         "Message":"siteConfig.ReservedInstanceCount is invalid. Please use the new property siteConfig.PreWarmedInstanceCount."
      },
      {
         "Code":"BadRequest"
      },
      {
         "ErrorEntity":
         {
            "ExtendedCode":"51021",
            "MessageTemplate":"{0} is invalid. {1}",
            "Parameters":
            [
               "siteConfig.ReservedInstanceCount", "Please use the new property siteConfig.PreWarmedInstanceCount."
            ],
            "Code":"BadRequest",
            "Message":"siteConfig.ReservedInstanceCount is invalid. Please use the new property siteConfig.PreWarmedInstanceCount."
         }
      }
   ],
   "Innererror": null
}

Evitar perda de contexto durante eventos de dimensionamento de recursos

Os eventos de dimensionamento de recursos podem causar a perda de contexto para conectores internos com o modo stateful habilitado. Para evitar essa perda potencial antes que tais eventos possam acontecer, corrija o número de instâncias disponíveis para seu recurso de aplicativo lógico. Dessa forma, nenhum evento de escala pode acontecer para causar essa perda de contexto potencial.

  1. No menu de recursos do aplicativo lógico, em Configurações, selecione Dimensionamento.

  2. Na página Dimensionamento, na seção Dimensionamento do aplicativo, siga estas etapas:

    1. Defina Impor limite de expansão como Sim, que mostra o limite máximo de expansão.

    2. Defina Instâncias Sempre Prontas para o mesmo número que Limite Máximo de Expansão e Burst Máximo, que aparece na seção Planejar Dimensionamento , por exemplo:

    A captura de tela mostra o portal do Azure, o recurso de aplicativo lógico padrão, a página Dimensionamento e o número de instâncias sempre prontas definidas para corresponder ao Máximo de Burst e ao Limite Máximo de Expansão.

  3. Quando terminar, na barra de ferramentas Dimensionar, selecione Salvar.

Próximos passos