Tworzenie standardowych przepływów pracy aplikacji logiki na potrzeby wdrożenia hybrydowego we własnej infrastrukturze

Dotyczy: Azure Logic Apps (Standard)

W sytuacjach, gdy musisz używać, kontrolować i zarządzać własną infrastrukturą, stwórz standardowe workflowy aplikacji logic, korzystając z hybrydowego modelu wdrożenia w Azure Logic Apps. Ten model zapewnia możliwości tworzenia i hostowania rozwiązań integracji dla częściowo połączonych środowisk, które wymagają lokalnego przetwarzania, magazynu i dostępu do sieci. Infrastruktura może obejmować systemy lokalne, chmury prywatne i chmury publiczne. Korzystając z modelu hybrydowego, przepływ pracy aplikacji logiki w warstwie Standard działa w oparciu o środowisko uruchomieniowe usługi Azure Logic Apps, które jest hostowane w Twojej infrastrukturze jako część rozszerzenia usługi Azure Container Apps.

Aby zapoznać się z omówieniem architektury pokazującym, gdzie przepływy pracy aplikacji logiki w warstwie Standard są hostowane i uruchamiane w środowisku częściowo połączonym, zobacz Konfigurowanie wymagań infrastruktury dla wdrożenia hybrydowego standardowych aplikacji logiki.

Ten poradnik pokazuje, jak stworzyć i wdrożyć workflow aplikacji Standard Logic za pomocą hybrydowego modelu wdrożenia po skonfigurowaniu niezbędnych zasobów do hostowania aplikacji.

Ograniczenia

W przypadku obecnie obsługiwanych regionów Azure, wspieranych klastrów Kubernetes oraz ograniczeń platformowych zobacz Ograniczenia dla wdrożenia hybrydowego.

Następujące ograniczenia obowiązują przy tworzeniu i obsłudze aplikacji logiki hybrydowej:

Zachowanie podczas przerwania łączności w Azure

• Przepływy pracy mogą nadal działać, jeśli środowisko uruchomieniowe i wszystkie wymagane zależności przepływu pracy pozostaną lokalnie dostępne.
• Wbudowane operacje działają z lokalnym środowiskiem wykonawczym, ale każda zewnętrzna usługa wywołana przez operację musi pozostać dostępna.
• Operacje zarządzanych łączników wymagają łączności z usługami hostowanymi na Azure.
• Zarządzanie portalem Azure, wdrażanie oparte na Azure, operacje tożsamości oraz dostarczanie telemetrii mogą stać się niedostępne lub opóźnione.
• Jeśli środowisko uruchomieniowe pozostanie odłączone przez ponad 24 godziny, możesz utracić dane dziennika wygenerowane po tym czasie.

Jeśli Twoje obciążenia robocze wymagają wdrażania, monitorowania, generowania alertów, ponownego przesyłania uruchomień lub operacji związanych z tożsamością podczas dłuższego okresu braku połączenia, zweryfikuj to działanie dla swojej konkretnej konfiguracji z opiekunem konta Microsoft lub zespołem produktu.

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.

• Następujące zasoby zarządzane przez klienta, które muszą istnieć w tej samej sieci, aby zapewnić wymaganą łączność:

  • Obsługiwany klaster Kubernetes połączony z Azure Arc
  • Baza danych SQL do lokalnego przechowywania historii uruchomień przepływu pracy, danych wejściowych i wyjściowych na potrzeby przetwarzania
  • Udział plików bloku komunikatów serwera (SMB) do lokalnego przechowywania artefaktów używanych przez przepływy pracy

  Aby spełnić te wymagania, skonfiguruj te zasoby wspierające hybrydowe wdrożenie dla standardowych przepływów pracy.

• Do pracy w programie Visual Studio Code potrzebne jest rozszerzenie usługi Azure Logic Apps (Standard) dla programu Visual Studio Code z powiązanymi wymaganiami wstępnymi.

  Wskazówka

  Jeśli masz nową instalację programu Visual Studio Code, upewnij się, że możesz lokalnie uruchomić podstawowy przepływ pracy w warstwie Standardowa przed podjęciem próby wdrożenia we własnej infrastrukturze. To uruchomienie testowe pomaga wykryć ewentualne błędy, które mogą występować w projekcie przepływu pracy typu Standard.

Tworzenie standardowej aplikacji logiki

Przechowywanie wersji wdrożeń hybrydowych

Aplikacja logiki w warstwie Standard z opcją hostingu hybrydowego automatycznie tworzy nową rewizję, czyli pojęcie dotyczące wersjonowania w usłudze Azure Container Apps, za każdym razem, gdy zapiszesz zmiany w podrzędnym przepływie pracy. Aktywacja tej poprawki może zająć trochę czasu, co oznacza, że po zapisaniu zmian może być konieczne odczekanie kilku chwil przed przetestowaniem przepływu pracy.

Jeśli zmiany nadal nie zostały wyświetlone w przepływie pracy, możesz sprawdzić, czy poprawka istnieje:

1. W witrynie Azure Portal otwórz zasób. W menu zasobów w obszarze Poprawki wybierz pozycję Poprawki i repliki.

2. Na stronie Poprawki i repliki na karcie Aktywne poprawki sprawdź, czy na liście pojawia się nowa poprawka.

Aby uzyskać więcej informacji, zobacz następujące zasoby:

• Aktualizowanie i wdrażanie zmian w usłudze Azure Container Apps

• Zarządzanie poprawkami w usłudze Azure Container Apps

Konfigurowanie rozszerzonej telemetrii lub funkcji OpenTelemetry na potrzeby monitorowania wydajności

Możesz skonfigurować rozszerzoną kolekcję danych telemetrycznych w usłudze Application Insights dla standardowej aplikacji logiki, a następnie wyświetlić zebrane dane po zakończeniu przebiegu przepływu pracy. Ta funkcja ułatwia uzyskiwanie szczegółowych informacji o przepływach pracy i większą kontrolę nad filtrowaniem zdarzeń w źródle danych, co pomaga zmniejszyć koszty magazynowania. Te ulepszenia koncentrują się na metrykach wydajności w czasie rzeczywistym, które zapewniają wgląd w kondycję i zachowanie systemu.

W przypadku scenariuszy częściowo połączonych i lokalnych można skonfigurować standardową aplikację logiczną w celu emitowania danych telemetrii na podstawie ustawień aplikacji obsługiwanych przez OpenTelemetry, zdefiniowanych dla określonego środowiska. Domyślnie te dane telemetryczne są wysyłane do usługi Application Insights. Aby uzyskać więcej informacji, zobacz Włączanie rozszerzonej telemetrii w usłudze Application Insights dla standardowych przepływów pracy w usłudze Azure Logic Apps.

Application Insights wymaga łączności z Azure. Podczas przerw w łączności dostarczanie telemetrii może napotykać opóźnienia, a dane logujące wygenerowane po 24 godzinach mogą być utracone. Zweryfikuj wszelkie wymagania dotyczące monitorowania lokalnego i alertowania w odniesieniu do miejsca docelowego telemetrii oraz konfiguracji, których używasz.

Zmiana alokacji procesorów wirtualnych i pamięci w portalu Azure

Możesz edytować ustawienia procesorów wirtualnych i pamięci dla zasobu standardowej aplikacji logiki. Te zmiany wpływają na opłaty rozliczeniowe obciążeń aplikacji logicznych w warstwie Standard.

1. W portalu Azure otwórz zasób aplikacji logiki w warstwie Standard.

2. W menu zasobów w obszarze Ustawienia wybierz pozycję Kontenery.

3. Na pasku narzędzi strony Kontenery wybierz pozycję Edytuj i wdróż, co spowoduje otwarcie okienka Edytowanie kontenera.

4. Na karcie Właściwości w obszarze Alokacja zasobów kontenera zmień następujące wartości, aby pasowały do danego scenariusza:

   Właściwości	Wartość	Opis
   Rdzenie CPU	- Wartość domyślna: 1 - Minimum: 0,25 - Maksimum: 2	Określa rdzenie vCPU do przypisania do instancji kontenera. Tę wartość można zwiększyć o 0,25 rdzeni do maksymalnej wartości. Łączny limit dla wszystkich wystąpień kontenera tej aplikacji logiki jest ograniczony do 2 rdzeni.
   Memory (Pamięć)	- Wartość domyślna: 2 - Minimum: 0,1 - Maksimum: 4	Określa pojemność pamięci w gibibajtach (GiB), którą należy przypisać do instancji kontenera. Możesz zwiększyć tę wartość o 0,1 GiB do maksymalnej wartości. Łączna pojemność wszystkich instancji kontenera dla tej aplikacji logiki jest ograniczona do 4 GiB.

5. Po zakończeniu wybierz pozycję Zapisz.

Zmienianie skalowania repliki w portalu Azure

Możesz sterować automatycznym skalowaniem zakresu replik uruchamianych w odpowiedzi na zdarzenie wyzwalające. Replika to nowe wystąpienie poprawki lub wersji zasobu aplikacji logiki. Aby zmienić minimalne i maksymalne wartości dla tego zakresu, można zmodyfikować reguły skalowania, aby określić typy zdarzeń, które wyzwalają skalowanie. Aby uzyskać więcej informacji, zobacz Ustawianie reguł skalowania w usłudze Azure Container Apps.

1. W portalu Azure otwórz zasób aplikacji logiki w warstwie Standard.

2. W menu zasobu, w obszarze Ustawienia, wybierz pozycję Skala.

3. Na stronie Skalowanie w obszarze Ustawienie reguły skalowania zmień następujące wartości, aby pasowały do danego scenariusza:

   Właściwości	Wartość	Opis
   Minimalna liczba replik	- Wartość domyślna: 1 - Min: 0 - Maksimum: 1000	Określa minimalną liczbę replik dozwolonych dla poprawki w danym momencie. Ta wartość zastępuje reguły skalowania i musi być mniejsza niż maksymalna liczba replik.
   Maksymalna liczba replik	- Ustawienie domyślne: 30 - Min: 0 - Maksimum: 1000	Określa maksymalną liczbę replik dozwolonych dla poprawki w danym momencie. Ta wartość zastępuje reguły skalowania.

4. Po zakończeniu wybierz pozycję Zapisz.

Sterowanie ruchem przychodzącym do aplikacji logiki w portalu Azure

Możesz udostępnić swoją aplikację logiki biznesowej publicznie w Internecie, w swojej sieci wirtualnej oraz innym aplikacjom logiki biznesowej w danym środowisku, po włączeniu ruchu przychodzącego. Platforma Azure egzekwuje ustawienia ruchu przychodzącego za pomocą zestawu reguł kontrolujących kierowanie ruchem zewnętrznym i wewnętrznym do aplikacji logiki. Po włączeniu ruchu przychodzącego nie musisz tworzyć usługi Azure Load Balancer, publicznego adresu IP ani żadnych innych zasobów platformy Azure w celu włączenia przychodzących żądań HTTP lub ruchu TCP. Aby uzyskać więcej informacji, zobacz Ingress w usłudze Container Apps.

1. W menu zasobu, w sekcji Ustawienia, wybierz pozycję Ruch przychodzący.

2. Na stronie Ingress, obok Ingress, zaznacz pole Enabled.

3. W zależności od scenariusza skonfiguruj pozostałe opcje.

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

   • Skonfiguruj ruch przychodzący dla swojej aplikacji w usłudze Azure Container Apps
   • Skonfiguruj ograniczenia ruchu przychodzącego na podstawie adresów IP w usłudze Azure Container Apps

Konfigurowanie uwierzytelniania dla połączeń zarządzanego interfejsu API

Połączenia zarządzane API obecnie nie obsługują uwierzytelniania tożsamości zarządzanej w aplikacjach logiki hybrydowej. Aby uwierzytelnić te połączenia, musisz utworzyć własną rejestrację aplikacji, używając Microsoft Entra ID. Następnie możesz dodać wartości rejestracji tej aplikacji jako zmienne środowiskowe w swoim zasobie aplikacji Standard Logic. Ten model uwierzytelniania wymaga łączności z Microsoft Entra ID.

Tworzenie rejestracji aplikacji przy użyciu identyfikatora Entra firmy Microsoft

Azure Portal

1. W portalu Azure wykonaj kroki opisane w przewodniku Szybki start: rejestrowanie aplikacji przy użyciu platformy tożsamości firmy Microsoft, aby utworzyć rejestrację aplikacji.

2. Po zakończeniu tworzenia znajdź nową rejestrację aplikacji w portalu.

3. W menu zasobów wybierz pozycję Przegląd i zapisz następujące wartości, które będą potrzebne później do uwierzytelniania połączenia:

   • ID klienta
   • Identyfikator dzierżawy

4. Na pasku bocznym zasobów wybierz Certyfikaty i sekrety>Tajemnice> klientaNowy sekret klienta.

5. Utwórz sekret klienta i natychmiast zapisz wartość sekretu. Wartość nie pojawia się ponownie po opuszczeniu strony.

6. W przypadku identyfikatora obiektu wykonaj następujące kroki:

   1. Na stronie Przegląd wybierz link Aplikacja zarządzana w katalogu lokalnym dla swojej rejestracji aplikacji, jak pokazano poniżej:

      

   2. Na stronie, która zostanie otwarta, skopiuj i zapisz wartość Identyfikator obiektu:

      

7. Teraz dodaj zapisane wartości jako zmienne środowiskowe do zasobu standardowej aplikacji logiki.

Interfejs wiersza polecenia platformy Azure

1. Aby utworzyć rejestrację aplikacji i jej jednostkę usługi bez przypisywania roli platformy Azure, uruchom następujące polecenie:

   az ad sp create-for-rbac \
      --name <app-registration-name> \
      --skip-assignment
   

2. Z wyjścia polecenia zapisz appId, password, oraz tenant wartości jako wartości dla identyfikatora klienta, tajemnicy klienta i identyfikatora tenanta. Sekret klienta pojawia się tylko w wyjściu polecenia.

3. Pobierz identyfikator obiektu usługi głównej:

   az ad sp show \
      --id <client-ID> \
      --query id \
      --output tsv
   

4. Teraz dodaj zapisane wartości jako zmienne środowiskowe do zasobu standardowej aplikacji logiki.

Aby uzyskać więcej informacji, zobacz:

• az ad sp create-for-rbac
• az ad sp show

Dodawanie wartości rejestracji aplikacji do standardowej aplikacji logiki

1. W portalu Azure przejdź do standardowego zasobu aplikacji logiki.

2. W menu zasobów w obszarze Ustawienia wybierz pozycję Kontenery, a następnie wybierz kartę Zmienne środowiskowe.

   Aby uzyskać więcej informacji na temat ustawień aplikacji i ustawień hosta, zobacz Edytowanie ustawień aplikacji i ustawień hosta.

3. Na pasku narzędzi wybierz pozycję Edytuj i wdróż.

4. W okienku Edytowanie kontenera wybierz pozycję Zmienne środowiskowe, a następnie wybierz pozycję Dodaj.

5. W poniższej tabeli dodaj każdą zmienną środowiskową z określoną wartością:

   Zmienna środowiskowa	Wartość
   WORKFLOWAPP_AAD_CLIENTID	< my-client-ID>
   WORKFLOWAPP_AAD_OBJECTID	< my-object-ID>
   WORKFLOWAPP_AAD_TENANTID	< my-tenant-ID>

6. Po zakończeniu wybierz pozycję Zapisz.

Przechowuj i odwołuj się do tajemnicy klienta

Zapisz sekret klienta jako sekret w zasobach aplikacji logicznej. Odwołaj się do tego sekretu w zmiennej środowiskowej WORKFLOWAPP_AAD_CLIENTSECRET.

1. W portalu Azure przejdź do zasobu aplikacji logiki.

2. Na pasku bocznym aplikacji Logic, w Ustawieniach, wybierz Sekrety.

3. Na pasku narzędzi wybierz Dodaj.

4. W okienku Dodaj sekret podaj następujące informacje, a następnie wybierz pozycję Dodaj:

   Klawisz	Wartość
   WORKFLOWAPP_AAD_CLIENTSECRET	< my-client-secret>

5. Na pasku bocznym aplikacji logicznej, w sekcji Ustawienia, wybierz Kontenery, a następnie zakładkę Zmienne środowiskowe .

6. Na pasku narzędzi wybierz pozycję Edytuj i wdróż.

7. Dodaj zmienną środowiskową WORKFLOWAPP_AAD_CLIENTSECRET, wybierz opcję odwołania się do sekretu i wybierz utworzony sekret.

8. Po zakończeniu wybierz pozycję Zapisz.

Znane problemy i rozwiązywanie problemów

W poniższej sekcji opisano obecnie znane problemy i wskazówki dotyczące rozwiązywania typowych problemów.

Ogólne problemy z konfiguracją środowiska lub wdrażaniem portalu

Aby ułatwić diagnozowanie i debugowanie problemów z konfiguracją środowiska lub niepowodzeniami wdrażania portalu, możesz spróbować uruchomić skrypt programu troubleshoot.ps1PowerShell podany dla opcji wdrożenia hybrydowego.

1. Przejdź do repozytorium GitHub usługi Azure Logic Apps: folder scripts/hybrid.

2. Skopiuj plik troubleshoot.ps1 do folderu w tej samej lokalizacji na miejscu co wdrożenie aplikacji logiki.

3. Uruchom skrypt przy użyciu programu PowerShell.

Klastry platformy Kubernetes z obsługą Arc

W rzadkich scenariuszach można zauważyć duże zużycie pamięci w klastrze. Aby zapobiec temu problemowi, należy albo zastosować skalowanie w poziomie, albo włączyć autoskalowanie dla pul węzłów.

Host funkcji nie jest uruchomiony

Po wdrożeniu standardowej aplikacji logiki upewnij się, że aplikacja działa poprawnie.

1. W witrynie Azure Portal otwórz zasób aplikacji logiki.

2. W menu zasobów wybierz pozycję Przegląd.

3. Na stronie Przegląd obok pola Adres URL aplikacji wybierz adres URL zasobu.

   Jeśli aplikacja działa poprawnie, zostanie otwarte okno przeglądarki i zostanie wyświetlony następujący komunikat:

   

   W przeciwnym razie, jeśli Twoja aplikacja ma awarie, sprawdź, czy Twoje pody Kubernetes działają poprawnie. Upewnij się, że kubectl używa kontekstu klastra, a następnie uruchom następujące polecenia:

   kubectl get ns
   kubectl get pods -n logicapps-aca-ns
   kubectl describe pod {logic-app-pod-name} -n logicapps-aca-ns 
   

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

   • Narzędzie wiersza polecenia (kubectl)

Klaster nie ma wystarczającej pojemności

Jeśli uruchomiono poprzednie polecenie i zostanie wyświetlone ostrzeżenie podobne do poniższego przykładu, klaster nie ma wystarczającej liczby węzłów do przetworzenia:

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.

W usłudze AKS zwiększ liczbę węzłów i skonfiguruj automatyczne skalowanie, wykonując poniższe kroki:

1. W witrynie Azure Portal przejdź do wystąpienia usługi Kubernetes.

2. W menu instancji, w obszarze Ustawienia, wybierz pozycję Pule węzłów.

3. Na pasku narzędzi strony Node tools wybierz pozycję + Dodaj pulę węzłów.

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

• Tworzenie pul węzłów dla klastra w usłudze Azure Kubernetes Service (AKS)
• Zarządzanie pulami węzłów dla klastra w usłudze Azure Kubernetes Service (AKS)
• Omówienie skalowania automatycznego klastra w usłudze Azure Kubernetes Service (AKS)
• Używanie narzędzia do automatycznego skalowania klastra w usłudze Azure Kubernetes Service (AKS)

W przypadku OpenShift lub RKE2 użyj obsługiwanej procedury dla dystrybucji Kubernetes, aby zwiększyć pojemność.

Sterownik SMB Container Storage Interface (CSI) nie jest zainstalowany

Po uruchomieniu wcześniejszego kubectl describe pod polecenia, jeśli zostanie wyświetlone następujące ostrzeżenie, upewnij się, czy sterownik CSI dla udziału plików SMB jest poprawnie zainstalowany:

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

Aby potwierdzić, wykonaj następujące polecenie:

kubectl get csidrivers

Jeśli wyniki nie zawierają smb.csi.k8s.io, postępuj zgodnie z instrukcjami dotyczącymi dystrybucji, aby zainstalować sterownik SMB.

Aby sprawdzić status sterownika CSI SMB, wykonaj następujące polecenie:

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

Powiązana zawartość

• Konfigurowanie wymagań dotyczących standardowego wdrażania aplikacji logiki we własnej infrastrukturze
• Włączanie rozszerzonej telemetrii w usłudze Application Insights dla standardowych przepływów pracy w usłudze Azure Logic Apps
• Dlaczego migrować z BizTalk Server do Azure Logic Apps Standard?
• Migrowanie programu BizTalk Server za pomocą Azure Logic Apps Migration Agent