Włączanie trybu stanowego dla bezstanowych wbudowanych łączników w usłudze Azure Logic Apps

Dotyczy: Azure Logic Apps (Standardowa)

W przypadku standardowych przepływów pracy aplikacji logiki następujące wbudowane łączniki oparte na dostawcy usług są domyślnie bezstanowe:

• Azure Service Bus
• SAP
• IBM MQ

Aby uruchomić te operacje łącznika w trybie stanowym, należy włączyć tę funkcję. W tym przewodniku z instrukcjami pokazano, jak włączyć tryb stanowy dla tych łączników.

Wymagania wstępne

• Konto i subskrypcja platformy Azure. Jeśli nie masz subskrypcji, zarejestruj się w celu założenia bezpłatnego konta platformy Azure.

• Zasób standardowej aplikacji logiki, w którym planujesz utworzyć przepływ pracy korzystający z operacji łącznika z obsługą trybu stanowego. Jeśli nie masz tego zasobu, utwórz teraz zasób aplikacji logiki w warstwie Standardowa.

• Sieć wirtualna platformy Azure z podsiecią do integracji z aplikacją logiki. Jeśli nie masz tych elementów, zapoznaj się z następującą dokumentacją:

  • Szybki start: tworzenie sieci wirtualnej za pomocą witryny Azure Portal
  • Dodawanie, zmienianie i usuwanie podsieci sieci wirtualnej

Włączanie trybu stanowego w witrynie Azure Portal

1. W witrynie Azure Portal otwórz zasób standardowej aplikacji logiki, w którym chcesz włączyć tryb stanowy dla tych operacji łącznika.

2. Włącz integrację sieci wirtualnej dla aplikacji logiki i dodaj aplikację logiki do wcześniej utworzonej podsieci:

   1. W zasobie menu aplikacji logiki w obszarze Ustawienia wybierz pozycję Sieć.

   2. W sekcji Ruch wychodzący wybierz pozycję Integracja>z siecią wirtualną Dodaj sieć wirtualną.

   3. W otwartym okienku Dodawanie integracji z siecią wirtualną wybierz subskrypcję platformy Azure i sieć wirtualną.

   4. W obszarze Podsieć wybierz pozycję Wybierz istniejącą. Z listy Podsieć wybierz podsieć, w której chcesz dodać aplikację logiki.

   5. Po zakończeniu wybierz OK.

      Na stronie Sieć opcja integracji z siecią wirtualną jest teraz wyświetlana na wartość Włączone, na przykład:

      

   Aby uzyskać ogólne informacje na temat włączania integracji sieci wirtualnej z aplikacją, zobacz Włączanie integracji sieci wirtualnej w usłudze aplikacja systemu Azure Service.

3. Następnie zaktualizuj podstawową konfigurację witryny internetowej aplikacji logiki (<logic-app-name.azurewebsites.net>) przy użyciu jednego z następujących narzędzi:

Aktualizowanie konfiguracji witryny internetowej dla aplikacji logiki

Po włączeniu integracji sieci wirtualnej dla aplikacji logiki należy zaktualizować podstawową konfigurację witryny internetowej aplikacji logiki (<logic-app-name.azurewebsites.net>) przy użyciu jednej z następujących metod:

• Witryna Azure Portal (token elementu nośnego nie jest wymagany)
• Interfejs API usługi Azure Resource Management (wymagany token elementu nośnego)
• Azure PowerShell (token elementu nośnego nie jest wymagany)

Azure Portal

Aby skonfigurować porty prywatne sieci wirtualnej przy użyciu witryny Azure Portal, wykonaj następujące kroki:

1. W witrynie Azure Portal znajdź i otwórz zasób aplikacji logiki w warstwie Standardowa.
2. W menu aplikacji logiki w obszarze Ustawienia wybierz pozycję Konfiguracja.
3. Na stronie Konfiguracja wybierz pozycję Ustawienia ogólne.
4. W obszarze Ustawienia platformy w polu Porty prywatne sieci wirtualnej wprowadź porty, których chcesz użyć.

Azure Resource Management API

Aby wykonać to zadanie za pomocą interfejsu API usługi Azure Resource Management — zaktualizuj według identyfikatora, zapoznaj się z następującymi wymaganiami, składnią i wartościami parametrów.

Wymagania

Wymagana jest autoryzacja protokołu OAuth i token elementu nośnego. Aby uzyskać token elementu nośnego, wykonaj następujące kroki

1. Po zalogowaniu się do witryny Azure Portal otwórz narzędzia deweloperskie przeglądarki internetowej (F12).

2. Pobierz token, wysyłając dowolne żądanie zarządzania, na przykład przez zapisanie przepływu pracy w aplikacji logiki w warstwie Standardowa.

Składnia

Aktualizacje zasobu przy użyciu określonego identyfikatora zasobu:

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

Wartości parametrów

Element	Wartość	Opis
Metoda żądania HTTP	PATCH
<Resourceid>	subscriptions/{yourSubscriptionID}/resourcegroups/{yourResourceGroup}/providers/Microsoft.Web/sites/{websiteName}/config/web
<yourSubscriptionId>	Identyfikator subskrypcji platformy Azure
<yourResourceGroup>	Grupa zasobów zawierająca zasób aplikacji logiki
<nazwa witryny sieci Web>	Nazwa zasobu aplikacji logiki, czyli mystandardlogicapp w tym przykładzie
Treść żądania HTTP	{"properties": {"vnetPrivatePortsCount": "2"}}

Przykład

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

Aby wykonać to zadanie za pomocą programu Azure PowerShell, zapoznaj się z następującymi wymaganiami, składnią i wartościami. Ta metoda nie wymaga ręcznego pobrania tokenu elementu nośnego.

Składnia

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

Więcej informacji można znaleźć w następującej dokumentacji:

• Set-AzContext
• Get-AzResource
• Set-AzResource

Wartości parametrów

Element	Wartość
<yourSubscriptionID>	Identyfikator subskrypcji platformy Azure
<Resourceid>	subscriptions/{yourSubscriptionID}/resourcegroups/{yourResourceGroup}/providers/Microsoft.Web/sites/{websiteName}/config/web
<yourResourceGroup>	Grupa zasobów zawierająca zasób aplikacji logiki
<nazwa witryny sieci Web>	Nazwa zasobu aplikacji logiki, czyli mystandardlogicapp w tym przykładzie

Przykład

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

Rozwiązywanie problemów

Błąd: liczba wystąpień zarezerwowanych jest nieprawidłowa

Jeśli wystąpi błąd informujący, że liczba wystąpień zarezerwowanych jest nieprawidłowa, użyj następującego obejścia:

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

Przykład błędu:

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
}

Zapobieganie utracie kontekstu podczas zdarzeń skalowania zasobów

Zdarzenia skalowania zasobów mogą spowodować utratę kontekstu dla wbudowanych łączników z włączonym trybem stanowym. Aby zapobiec tej potencjalnej utracie przed wystąpieniem takich zdarzeń, napraw liczbę wystąpień dostępnych dla zasobu aplikacji logiki. W ten sposób żadne zdarzenia skalowane w poziomie mogą spowodować tę potencjalną utratę kontekstu.

1. W menu zasobów aplikacji logiki w obszarze Ustawienia wybierz pozycję Skaluj w poziomie.

2. W obszarze Skalowanie aplikacji w poziomie ustaw opcję Wymuszanie limitu skalowania w poziomie na wartość Tak, co pokazuje maksymalny limit skalowania w poziomie.

3. Na stronie Skalowanie w poziomie w obszarze Skalowanie aplikacji w poziomie ustaw liczbę zawsze gotowych wystąpień na taką samą liczbę jak limit maksymalnej skali w poziomie i maksymalny wzrost, który jest wyświetlany w obszarze Planowanie skalowania w poziomie, na przykład:

   

4. Gdy wszystko będzie gotowe, na pasku narzędzi Skalowanie w poziomie wybierz pozycję Zapisz.

Następne kroki

• Połączenie do usługi Azure Service Bus
• Połączenie do oprogramowania SAP
• Połączenie do ibm MQ