Eksportowanie przepływów pracy Consumption do standardowej aplikacji Logic Apps

Standardowe przepływy pracy aplikacji logiki, działające w jednodzierżawczej usłudze Azure Logic Apps, oferują wiele nowych i ulepszonych funkcji. Na przykład uzyskujesz izolację obliczeniową, integrację sieci wirtualnej i prywatne punkty końcowe wraz z hostingiem środowiska App Services Environment, lokalnym programowaniem i debugowaniem przy użyciu programu Visual Studio Code, małymi opóźnieniami w przepływach pracy bezstanowych i nie tylko.

Jeśli chcesz korzystać z standardowych przepływów pracy, ale przepływy pracy działają w wielodostępnej usłudze Azure Logic Apps, możesz teraz przenieść przepływy pracy Zużycie do usługi Azure Logic Apps z jedną dzierżawą. Ten przełącznik ma sens w scenariuszach, które wymagają niektórych funkcji standardowych, takich jak izolacja i integracja sieci, mniejsze opóźnienia lub lepsza przewidywalność kosztów.

Teraz możesz wyeksportować aplikacje logiki Consumption do standardowej aplikacji logiki. Korzystając z programu Visual Studio Code i najnowszego rozszerzenia Azure Logic Apps (Standard), można wyeksportować aplikację logiki jako stanowy przepływ pracy do projektu aplikacji logiki w standardzie Standard. Następnie możesz lokalnie aktualizować, testować i debugować przepływy pracy, aby przygotować je do ponownego wdrożenia. Gdy wszystko będzie gotowe, możesz wdrożyć bezpośrednio z programu Visual Studio Code lub za pomocą własnego procesu DevOps.

Uwaga

Możliwość eksportu nie przenosi przepływów pracy. Zamiast tego to narzędzie replikuje artefakty, takie jak definicje przepływu pracy, połączenia, artefakty konta integracji i inne. Zasoby źródłowej aplikacji logiki, przepływy pracy, historia wyzwalaczy, historia uruchamiania i inne dane pozostają nienaruszone.

Kontrolujesz proces eksportowania i proces migracji. Możesz przetestować i zweryfikować wyeksportowane przepływy pracy w celu zadowolenia ze środowiska docelowego. Możesz wybrać, kiedy wyłączyć lub usunąć aplikacje logiki źródłowej.

Ten artykuł zawiera informacje na temat procesu eksportowania i pokazuje, jak wyeksportować przepływy pracy aplikacji Logic z przepływu pracy Consumption do lokalnego projektu aplikacji Logic w warstwie Standard w programie Visual Studio Code.

Znane problemy i ograniczenia

  • Narzędzie eksportu nie eksportuje żadnych informacji o infrastrukturze, takich jak ustawienia konta integracji.

  • Narzędzie eksportu może eksportować przepływy pracy aplikacji logiki z wyzwalaczami, które mają ustawienia współbieżności. Jednak jednodzierżawowy Azure Logic Apps ignoruje te ustawienia.

  • Aplikacje logiki muszą istnieć w tym samym regionie, jeśli chcesz je wyeksportować w ramach tego samego projektu aplikacji logicznych w wersji Standard.

  • Domyślnie poświadczenia połączenia nie są klonowane z przepływów pracy aplikacji logiki źródłowej. Przed uruchomieniem przepływów pracy aplikacji logiki należy ponownie uwierzytelnić te połączenia po wyeksportowaniu.

  • Domyślnie jeśli łącznik platformy Azure ma wbudowaną wersję łącznika, narzędzie eksportu automatycznie konwertuje łącznik platformy Azure na wbudowany łącznik. Nie istnieje opcja rezygnacji z tego zachowania.

Typy operacji możliwych do wyeksportowania

Operacja Typ JSON
Wyzwalacz Wbudowane: Http, HttpWebhook, Recurrence, manual (żądanie)

Zarządzane: ApiConnectionApiConnectionNotification, ApiConnectionWebhook
Akcja Wbudowane: AppendToArrayVariable, AppendToStringVariable, Compose, DecrementVariable, Foreach, Http, HttpWebhook, If, IncrementVariable, InitializeVariable, JavaScriptCode, Join, ParseJson, Response, Scope, Select, SetVariable, Switch, Table, Terminate, Until, Wait

- Zarządzane: ApiConnection, ApiConnectionWebhook

Wymagania wstępne

  • Konto i subskrypcja platformy Azure skojarzone z aplikacjami logiki Consumption do wyeksportowania.

  • Co najmniej jedna aplikacja logiki w warstwie Consumption do wdrożenia w tej samej subskrypcji i regionie Azure, na przykład Wschodnie Stany Zjednoczone 2.

  • Dostęp na poziomie subskrypcji czytelnika platformy Azure do subskrypcji, w której są obecnie wdrażane aplikacje logiki.

  • Dostęp na poziomie grupy zasobów współautora platformy Azure, jeśli chcesz później wybrać opcję Wdróż łączniki zarządzane.

  • Program Visual Studio Code z zainstalowanym rozszerzeniem usługi Azure Logic Apps (Standard) i ich wymaganiami wstępnymi.

    Uwaga

    Upewnij się, że zainstalowano wersję 2.0.16 lub nowszą dla rozszerzenia usługi Azure Logic Apps (Standard) dla programu Visual Studio Code. Niektóre scenariusze konwersji wymagają najnowszego projektanta przepływu pracy, który jest dostępny w tej wersji.

Grupowanie aplikacji logicznych do eksportu

Dzięki rozszerzeniu Azure Logic Apps (Standard), można połączyć wiele przepływów pracy aplikacji logicznych typu Consumption w jeden projekt aplikacji logicznej typu Standard. W usłudze Azure Logic Apps z pojedynczą dzierżawą jeden zasób aplikacji logiki w warstwie standardowa może mieć wiele przepływów pracy. Dzięki temu podejściu można wstępnie walidować przepływy pracy, aby nie przegapić żadnych zależności podczas wybierania aplikacji logiki do wyeksportowania.

Podczas wybierania aplikacji logiki do eksportowania należy wziąć pod uwagę następujące zalecenia:

  • Grupuj aplikacje logiki, w których przepływy pracy współdzielą te same zasoby, takie jak artefakty kont integracyjnych, mapy i schematy, lub używają zasobów poprzez łańcuch procesów.

  • Aby zapoznać się z organizacją i liczbą przepływów pracy dla aplikacji logiki, zapoznaj się z tematem Najlepsze rozwiązania i zalecenia.

Eksportowanie przepływów pracy dotyczących zużycia do projektu lokalnego

Wybieranie aplikacji logiki do eksportowania

  1. W programie Visual Studio Code zaloguj się do platformy Azure.

  2. Na pasku działań programu Visual Studio Code wybierz pozycję Azure, aby otworzyć okno platformy Azure (Shift + Alt + A).

    Zrzut ekranu przedstawiający pasek działań programu Visual Studio Code z wybraną ikoną platformy Azure.

  3. Na pasku narzędzi Obszar roboczy z menu Azure Logic Apps wybierz pozycję Eksportuj aplikację logiki.

    Zrzut ekranu przedstawiający okno platformy Azure, pasek narzędzi sekcji obszaru roboczego i wybraną pozycję Eksportuj aplikację logiki.

  4. Po otworze karty Eksportuj wybierz subskrypcję i region platformy Azure, a następnie wybierz pozycję Dalej.

    Zrzut ekranu przedstawiający kartę Eksportuj z wybraną subskrypcją i regionem platformy Azure.

  5. Wybierz aplikacje logiki do wyeksportowania. Każda wybrana aplikacja logiczna pojawia się na liście Wybrane aplikacje logiczne po stronie.

    Wskazówka

    Możesz również wyszukać aplikacje logiki i filtrować według grupy zasobów.

    Zrzut ekranu przedstawiający sekcję

    Narzędzie eksportu rozpoczyna sprawdzanie, czy wybrane aplikacje logiki kwalifikują się do eksportu.

  6. W sekcji Opcje zaawansowane możesz wybrać następujące opcje:

    Opcja Domyślny opis
    Generowanie szablonu infrastruktury Włączone Proces eksportowania tworzy szablony infrastruktury, które obejmują jeden szablon usługi ARM dla standardowej aplikacji logiki i jeden szablon usługi ARM dla każdego wyeksportowanego połączenia zarządzanego przez platformę Azure.
    Klonowanie poświadczeń połączenia Wyłączony Proces eksportowania klonuje poświadczenia z oryginalnego połączenia zarządzanego przez platformę Azure do nowego połączenia zarządzanego przez platformę Azure utworzonego na platformie Azure w ramach wdrożenia. Działa tylko w przypadkach, gdy wyeksportowane połączenie pozostaje połączeniem zarządzanym przez platformę Azure, na przykład połączeniem usługi Office 365 Outlook.

    Ważne: ostrożnie użyj tej opcji. Domyślnie dwa nowe połączenia będą wskazywać na ten sam zasób, co może potencjalnie stworzyć warunki wyścigu.
    Ustaw domyślnie konto integracji jako źródło dla przekształceń i walidacji Wyłączony Referencje do plików mapy i schematu mogą być lokalne lub na koncie integracji. Jeśli to ustawienie jest włączone, nie kopiuj map i schematów do projektu docelowego. Wymaga dodania odwołania do konta integracji w ustawieniu aplikacji dla aplikacji logiki. Domyślnie akcje Przekształć XML i Walidacja XML używają konta integracji jako źródła.
    Eksportowanie łączników niestandardowych jako akcji usługi API Management Wyłączony W przypadku włączenia łączniki niestandardowe są tworzone jako akcje usługi API Management, a nie akcje HTTP, dzięki czemu można zaimplementować akcje niestandardowe jako operacje interfejsu API w usłudze API Management. Aby uzyskać więcej informacji, zobacz Standardowe opcje dla Azure Logic Apps do łączenia się z usługami klienta lub interfejsami API.
  7. Kiedy skończysz, wybierz Dalej.

Przeglądanie wyników walidacji eksportu

  1. Po zakończeniu walidacji eksportu przejrzyj wyniki, rozwiń wpis dla każdej aplikacji logicznej.

    • Aplikacje logiki, które mają błędy, nie kwalifikują się do eksportu. Należy usunąć te aplikacje logiczne z listy eksportu, aż naprawisz je u źródła. Aby usunąć aplikację logiki z listy, wybierz pozycję Wstecz.

      Na przykład element SourceLogicApp2 zawiera błąd i nie można go wyeksportować do czasu naprawienia:

      Zrzut ekranu przedstawiający sekcję Przeglądanie stanu eksportu i stan weryfikacji przepływu pracy aplikacji logiki z błędem.

    • Logiczne aplikacje, które przechodzą walidację z ostrzeżeniami lub bez nich, nadal kwalifikują się do eksportu. Aby kontynuować, wybierz pozycję Eksportuj, jeśli wszystkie aplikacje zweryfikowały poprawność, lub wybierz pozycję Eksportuj z ostrzeżeniami, jeśli aplikacje mają ostrzeżenia.

      Na przykład aplikacja SourceLogicApp3 zawiera ostrzeżenie, ale nadal można kontynuować eksportowanie:

      Zrzut ekranu przedstawia sekcję Przegląd stanu eksportu oraz stan weryfikacji przepływu pracy aplikacji logik z ostrzeżeniem.

    Poniższa tabela zawiera więcej informacji na temat każdej ikony i stanu walidacji:

    Ikona walidacji Stan weryfikacji
    Ikona powodzenia Weryfikacja elementu zakończyła się pomyślnie, więc eksport można kontynuować bez żadnych problemów.
    Ikona błędu Walidacja elementu nie powiodła się, więc eksportowanie nie może kontynuować.

    Wpis weryfikacji elementu, który zakończył się niepowodzeniem, zostanie automatycznie rozszerzony i zawiera informacje o niepowodzeniu walidacji.
    Ikona ostrzeżenia Element przeszedł pomyślnie walidację z ostrzeżeniem, ale eksport może być kontynuowany, wymagając rozwiązania problemu po zakończeniu eksportu.

    Wpis weryfikacji dla elementu, który zawiera ostrzeżenie, jest automatycznie wyświetlany w formie rozszerzonej i dostarcza informacji na temat ostrzeżenia oraz koniecznego do podjęcia korygowania po wyeksportowaniu.
  2. Po pojawieniu się sekcji Zakończ eksportowanie, w polu Lokalizacja eksportu, przejdź do folderu lokalnego dla nowego projektu aplikacji logicznej w wersji standardowej.

    Zrzut ekranu przedstawiający sekcję Zakończ eksportowanie i właściwość Lokalizacja eksportu z wybranym folderem projektu eksportu lokalnego.

  3. Jeśli przepływ pracy ma zarządzane połączenia, które chcesz wdrożyć, co jest zalecane tylko w przypadku środowisk nieprodukcyjnych, wybierz pozycję Wdróż połączenia zarządzane, co pokazuje istniejące grupy zasobów w ramach subskrypcji platformy Azure. Wybierz istniejącą grupę zasobów lub wybierz pozycję Utwórz nową , aby utworzyć grupę zasobów, dla której mają zostać wdrożone połączenia zarządzane.

    Zrzut ekranu przedstawiający sekcję Zakończ eksportowanie z wybranym folderem eksportu lokalnego, wybraną pozycją Wdróż połączenia zarządzane i wybraną docelową grupą zasobów.

  4. W obszarze Po wykonaniu kroków eksportowania przejrzyj wszystkie wymagane kroki po wyeksportowaniu, na przykład:

    Zrzut ekranu przedstawia sekcję Po wykonaniu kroków eksportu i wymagane kroki po wyeksportowaniu, jeśli istnieją.

  5. W zależności od scenariusza wybierz pozycję Eksportuj i zakończ lub Eksportuj z ostrzeżeniami i zakończ.

    Narzędzie eksportu pobiera projekt do wybranej lokalizacji folderu, rozwija projekt w programie Visual Studio Code i wdraża wszystkie połączenia zarządzane, jeśli wybrano tę opcję.

    Zrzut ekranu pokazuje sekcję stanu eksportu z postępem eksportu.

  6. Po zakończeniu tego procesu program Visual Studio Code otworzy nowy obszar roboczy. Teraz możesz bezpiecznie zamknąć okno eksportu.

  7. W swoim projekcie aplikacji logicznej w warstwie standardowej otwórz i przejrzyj plik README.md w celu wykonania wymaganych kroków po wyeksportowaniu.

    Zrzut ekranu przedstawiający nowy projekt aplikacji logicznej w wersji Standard z otwartym plikiem README.

Kroki po wyeksportowania

Kroki rozwiązania problemu

Niektóre wyeksportowane przepływy pracy aplikacji logicznych wymagają wykonania działań korygujących po eksporcie na platformie Standard.

  1. W projekcie aplikacji logiki w warstwie Standardowa otwórz plik README.md i przejrzyj kroki korygowania wyeksportowanych przepływów pracy. Narzędzie eksportu generuje plik README.md, który zawiera wszystkie wymagane kroki po wyeksportowaniu.

  2. Przed wprowadzeniem jakichkolwiek zmian w przepływie pracy aplikacji Logic Apps źródłowej, upewnij się, że testujesz nowy zasób oraz przepływy pracy aplikacji Logic Apps Standard.

Akcje i ustawienia konta integracji

Jeśli eksportujesz akcje zależne od konta integracji, musisz ręcznie skonfigurować aplikację logiki Standard za pomocą linku referencyjnego do konta integracji zawierającego wymagane artefakty. Aby uzyskać więcej informacji, zobacz Połączenie konta integracji ze standardową aplikacją logiczną.

Akcje i ustawienia wsadowe

W przypadku eksportowania akcji, które używają akcji usługi Batch z wieloma konfiguracjami przechowywanymi na koncie integracji, należy ręcznie skonfigurować akcje usługi Batch z poprawnymi wartościami po wyeksportowaniu. Aby dowiedzieć się więcej, przejrzyj Wysyłanie, odbieranie i przetwarzanie wsadowe komunikatów w usłudze Azure Logic Apps.

Struktura folderów projektu

Po zakończeniu procesu eksportu, projekt aplikacji logicznej w warstwie Standard zawiera nowe foldery i pliki, jak również większość innych, które występują w typowym projekcie aplikacji logicznej w warstwie Standard.

W poniższej tabeli opisano te nowe foldery i pliki dodane przez proces eksportowania:

Folder Plik opis
.development\deployment LogicAppStandardConnections.parameters.json Plik parametrów szablonu usługi Azure Resource Manager na potrzeby wdrażania łączników zarządzanych
LogicAppStandardConnections.template.json Definicja szablonu usługi Azure Resource Manager na potrzeby wdrażania łączników zarządzanych
LogicAppStandardInfrastructure.parameters.json Plik parametrów szablonu usługi Azure Resource Manager na potrzeby wdrażania zasobu standardowej aplikacji logiki
LogicAppStandardInfrastructure.template.json Definicja szablonu Azure Resource Manager do wdrażania zasobu aplikacji logiki w warstwie Standard.
.logs\export exportReport.json Eksportowanie pliku pierwotnego podsumowania raportu zawierającego wszystkie kroki wymagane do korygowania po wyeksportowaniu
exportValidation.json Nieprzetworzony plik raportu weryfikacji, który zawiera wyniki walidacji dla każdej wyeksportowanej aplikacji logiki
README.md Plik Markdown z podsumowaniem wyników eksportu, w tym utworzonymi aplikacjami logiki i wszystkimi wymaganymi następnymi krokami