Szybki start: Automatyzowanie migracji projektów integracyjnych do usługi Azure Logic Apps Standard

Dotyczy: Azure Logic Apps (Standard)

Gdy zespół musi migrować obciążenia ze starszych platform, takich jak BizTalk Server do chmury, może okazać się, że proces jest złożony, czasochłonny i trudny. Aby uprościć to zadanie, Agent migracji Azure Logic Apps w Visual Studio Code automatyzuje ten proces poprzez pięć kroków z przewodnikiem.

W tym przewodniku szybkiego startu pokazano, jak przeprowadzić migrację przykładowego obciążenia integracji z BizTalk Server do przepływów pracy w wersji Standard w Azure Logic Apps przy użyciu agenta migracji Azure Logic Apps w programie Visual Studio Code. Dowiesz się, jak zainstalować rozszerzenie, otworzyć projekt źródłowy i postępować zgodnie z agentem, przechodząc przez etapy migracji: odnajdywanie, planowanie, konwersję, walidację i wdrażanie.

Aby uzyskać więcej informacji, zobacz Automatyzacja migracji z platform integracyjnych do Azure Logic Apps.

Wymagania wstępne

Agent migracji wymaga komponentów i narzędzi do różnych etapów, które uruchamiasz. Wymagania mogą się zmieniać między kolejnymi wydaniami rozszerzenia.

Przed rozpoczęciem upewnij się, że spełnisz następujące wymagania:

1. Instalowanie rozszerzenia agenta migracji

1. Otwórz program Visual Studio Code.

   Opcjonalnie, ale zalecane, otwórz Visual Studio Code z folderu lub katalogu, w którym istnieją projekty integracji, na przykład C:\Migration\<project-folders>.

   

2. Na pasku działań wybierz pozycję Rozszerzenia. (Klawiatura: Ctrl+Shift+X)

3. W polu wyszukiwania Extensions: Marketplace znajdź Agent migracji Azure Logic Apps i wybierz Zainstaluj.

   

   Po zakończeniu instalacji na pasku działań zostanie wyświetlona ikona Azure Logic Apps Migration Agent ().

2. Wybierz folder źródłowy

1. W Visual Studio Code na pasku działań wybierz ikonę Azure Logic Apps Migration Agent ().

2. W oknie Azure Logic Apps Migration Agent, w sekcji Wyniki wyszukiwania, wybierz Wybierz folder źródłowy.

   Wskazówka

   Aby uruchomić tę akcję jako polecenie, otwórz paletę poleceń (Klawiatura: Ctrl+Shift+P). Wprowadź i uruchom Azure Logic Apps Migration Agent: Wybierz folder źródłowy.

3. Znajdź i wybierz folder źródłowy, w którym znajdują się Twoje projekty BizTalk Server, MuleSoft Anypoint lub TIBCO BusinessWorks, a następnie wybierz Wybierz Source Project Folder lub MSI.

   

   Rozszerzenie automatycznie wykrywa platformę źródłową i rozpoczyna przepływ pracy migracji, począwszy od etapu odnajdywania.

4. Postępuj za agentem, który przeprowadzi Cię przez poszczególne etapy migracji, zaczynając od etapu odkrywania.

Etap migracji 1. Odnajdywanie

Na tym etapie agent migracji znajduje i kataloguje artefakty integracji w projekcie źródłowym. Podczas etapu odkrywania agent migracji wykonuje następujące czynności w opisanej kolejności, przy okazjonalnym wkładzie z Twojej strony. Aby uzyskać więcej informacji, zobacz Agent migracji: Etap odnajdywania.

Krok 1. Wykrywanie platformy źródłowej

Agent migracji określa Twoją platformę źródłową na podstawie wzorców plików. Przykładami są pliki BizTalk Server (.btproj, ), .odxMuleSoft Anypoint (pom.xml, mule-*.xml), oraz pliki TIBCO BusinessWorks (tibco.xml, module.bwm, ), .process

Poniższy zrzut ekranu przedstawia zidentyfikowaną platformę z przykładowymi wykrytymi artefaktami i zależnościami:

Krok 2. Skanowanie plików źródłowych

Agent migracji skanuje wykryte pliki źródłowe, używając wbudowanego analizatora dla twojej platformy. Po zakończeniu skanowania agent @migration-analyser Copilot analizuje odnalezione artefakty i wykrywa grupy przepływów logicznych, będące zestawami artefaktów współdziałających ze sobą.

Poniższy zrzut ekranu przedstawia sposób mapowania każdego przykładowego projektu integracji na grupę przepływów logicznych:

Wygenerowane przepływy logiczne nie zawsze odzwierciedlają relację 1:1 ze starszymi aplikacjami integracji. Agent migracji wykrywa przepływy, które najlepiej odzwierciedlają elementy integracji starszego systemu, takie jak obciążenia BizTalk, w postaci standardowych przepływów pracy w Azure Logic Apps.

Krok 3. Analizowanie projektu źródła

Po tym, jak agent migracji zakończy skanowanie i wyświetli rezultaty grup przepływów logicznych, wykonaj następujące kroki:

1. Na karcie Narzędzia główne dla żądanej grupy przepływów logicznych wybierz pozycję Analizuj projekt źródła, na przykład:

   

   Agent wykonuje następujące zadania:

   1. Tworzy inwentarz artefaktów, który obejmuje orkiestracje, schematy, mapy, potoki i powiązania.

   2. Generuje wykres zależności, który pokazuje relacje między artefaktami.

      Aby wygenerować graf zależności, agent migracji uruchamia następujące zadania:

      • Generuje diagramy architektury (Mermaid), które pokazują przepływy i składniki komunikatów.
      • Identyfikuje brakujące zależności.
      • Wykonuje analizę luk w funkcjach.
      • Wykrywa wzorce integracji, takie jak publish-subscribe, request-reply i batch.
      • Tworzenie mapowań dla Azure Logic Apps lub innych alternatywnych usług.
      • Generuje raport odkryć na podstawie ustaleń.

      Po pomyślnym wygenerowaniu grafu zależności przez agenta migracji zostanie otwarty wizualizator przepływu i zostanie wyświetlonych następujące karty interaktywne:

      • Diagram architektury
      • Przepływ komunikatów
      • Składniki
      • Brakujące zależności
      • Analiza luk
      • Wzorce
      • Poznaj usługę BizTalk

      W poniższym przykładzie przedstawiono przykładową wygenerowaną wizualizację przepływu:

      

      Aby uzyskać więcej informacji, zobacz Analiza projektu źródłowego i wyniki.

2. Aby przejrzeć wyniki analizy, wybierz kartę, aby przejrzeć powiązane informacje.

Krok 4. Aktualizowanie lub eksportowanie analizy

1. Po przejrzeniu wyników analizy na pasku tytułu wizualizatora przepływu wybierz jedną z następujących akcji:

   Action	Description
   Sugerowanie zmiany	Zażądaj bezpośrednich zmian w analizie. Tip: Aby omówić potencjalne aktualizacje lub poprawki dla dowolnej grupy przepływów, w wizualizatorze przepływu użyj okna czatu Copilot. Wybierz grupę przepływową i zadaj agentowi @migration-analyser pytania na temat wykrytej architektury. Podaj informacje o brakujących lukach, a następnie ponownie wygeneruj analizę.
   Ponowne generowanie analizy	Po zaktualizowaniu analizy, takiej jak dodanie brakującej zależności, artefaktu lub specyfikacji, uruchom ponownie analizę.
   Eksportowanie raportu	Wygeneruj raport z wynikami odnajdywania w formacie udostępnionym.

   Aby przeanalizować więcej przepływów, wybierz kartę Narzędzia główne lub ikonę strony głównej.

2. Po zakończeniu przejdź do następnej sekcji etapu Planowania.

Etap migracji 2: Planowanie

Po zakończeniu analizy rozpocznij etap planowania, tworząc plan migracji do wykonania. Aby uzyskać więcej informacji, zobacz Etap 2: Planowanie agenta migracji.

1. Na karcie Strona główna wybierz odpowiednią grupę przepływów logicznych, a następnie wybierz Zaplanuj projekt aplikacji Logic App.

   

   Agent @migration-planner generuje plan migracji, który zwykle zawiera następujące sekcje:

   • Architektura
   • Dodatkowe komponenty Azure
   • Mapowanie operacji
   • Dyspozycje artefaktów
   • Luki w migracji
   • Wzorce integracji
   • Podsumowanie

   Poniższy przykład przedstawia przykładowy wygenerowany plan migracji:

   

   Aby uzyskać więcej informacji, zobacz Planowanie akcji etapu.

2. Przed przejściem do etapu Konwersja dokładnie przejrzyj każdy plan. Wprowadź wszelkie aktualizacje zgodnie z potrzebami.

   Dokładność planu znacznie wpływa na jakość wyniku konwersji.

   Aby ułatwić określenie, czy plan wymaga aktualizacji, nawiąż interakcję z agentem GitHub Copilot na czacie Copilot w celu wykonania następujących zadań:

   • Zadaj pytania dotyczące określonych mapowań.
   • Zażądaj alternatywnych metod rozwiązywania luk.
   • Zażądaj modyfikacji planu przed przejściem do konwersji.

3. Gdy będziesz gotowy, przejdź do etapu Konwersji, wybierając pozycję Strona główna lub wracając do karty Home.

Etap migracji 3. Konwersja

Jeśli plan migracji jest zadowalający, uruchom etap konwersji, aby utworzyć i uruchomić zadania konwersji, które przekształcają artefakty źródłowe w standardowe przepływy pracy, połączenia i inne pliki pomocnicze dla Azure Logic Apps.

3.1: Tworzenie zadań konwersji

1. Na karcie Narzędzia główne, dla procesu logicznego wybierz pozycję Utwórz zadania konwersji.

   

   Agent @migration-converter tworzy zadania konwersji, które różnią się w zależności od określonej logicznej grupy przepływów. Poniższa lista zawiera opis przykładowych zadań konwersji dla logicznej grupy przepływów o nazwie Method Call Processing:

   Step	Zadanie	Description
   1	Utwórz szkielet projektu usługi Logic Apps	Tworzy strukturę projektu aplikacji logiki Standardowej z wymaganą hierarchią katalogów i plikami.
   2	Konwertowanie schematu wejściowego	Migruje plik InputSchema.xsd z formatu BizTalk, który jest utF-16 z adnotacjami BizTalk, do standardowego XSD, czyli UTF-8 bez adnotacji BizTalk.
   3	Konwertowanie schematu wyjściowego	Migruje plik OutputSchema.xsd z formatu BizTalk, który jest utF-16 z adnotacjami BizTalk, do standardowego XSD, czyli UTF-8 bez adnotacji BizTalk.
   4	Generowanie < połączeń o nazwie> łącznika	Tworzy lub aktualizuje plik connections.json zawierający konfiguracje dla każdego wymaganego połączenia.
   5	Generowanie <przepływu pracy —> przepływ pracy	Tworzy plik workflow.json zawierający definicję standardowego przepływu pracy w Azure Logic Apps dla grupy przepływu logicznego.
   6	Generowanie funkcji lokalnych (<nazw> funkcji)	Tworzy lokalne funkcje .NET 8 dla logiki niestandardowej w kodzie źródłowym.
   7	Zweryfikuj środowisko uruchomieniowe (func start)	Weryfikuje projekt aplikacji logiki, uruchamiając polecenie func start , aby potwierdzić, że wszystkie funkcje i przepływy pracy są gotowe.
   8	Testowanie E2E (ścieżka sukcesu i ścieżka błędów)	Uruchamia kompleksowe testy na potrzeby weryfikacji szczęśliwej ścieżki, ścieżki błędu i weryfikacji na poziomie pola.
   9	Testy czarnoskrzynkowe (opcjonalne)	Uruchamia testy korzystające z danych testowych zewnętrznych, które podajesz.
   10	Wdrażanie i testowanie w chmurze (opcjonalnie)	Wdraża w Azure i uruchamia testy E2E w chmurze.

   W poniższym przykładzie przedstawiono przykładowe wygenerowane zadania konwersji dla logicznej Method Call Processing grupy przepływów:

   

2. W następnej sekcji wybierz stronę główną lub wróć do karty Narzędzia główne .

3.2: Uruchamianie zadań konwersji

1. Aby wykonać pojedyncze zadanie konwersji, wybierz Wykonaj. Aby wykonać wszystkie wymagane zadania konwersji i lokalnej walidacji w kolejności zależności, wybierz Wykonaj Wszystko. Ta opcja działa tak samo jak wybór Wykonaj Zadania Konwersyjne na zakładce Strona . Opcjonalne zadanie Wdrażanie i Testowanie w chmurze nie jest zawarte w Wykonaj wszystko i wymaga osobnej akcji.

   Note

   Podczas wykonywania zadania konwersji agent może poprosić o dostęp lub uprawnienia do edytowania plików. Przejrzyj dostępne opcje i odpowiednio odpowiedz.

2. W następnej sekcji wybierz stronę główną lub wróć do karty Narzędzia główne .

3.3 Sprawdzanie danych wyjściowych pod kątem kompletności i jakości

Agent @migration-converter tworzy gotowe do uruchomienia standardowe definicje przepływu pracy i możliwe do wdrożenia artefakty projektu. Ten agent używa funkcji no-stubs-code-generation, aby upewnić się, że cały wygenerowany kod jest kompletny, w pełni funkcjonalny i że nie istnieją przykładowe implementacje, kod tymczasowy lub komentarze TODO.

Aby przygotować wygenerowane dane wyjściowe na etapie walidacji, w którym lokalnie uruchamiasz przepływy pracy do testowania, upewnij się, że ręcznie sprawdzisz definicje, połączenia i wszystkie wygenerowane .NET lokalne funkcje pod kątem niedokładności.

Aby przejrzeć wygenerowane dane wyjściowe, wykonaj następujące kroki:

1. Na karcie Home dla przepływu logicznego wybierz pozycję Otwórz w Visual Studio Code.

2. W folderze migracji przejdź do katalogu out i wybierz folder wygenerowanego rozwiązania, na przykład:

   

3. Sprawdź każdy workflow.json plik, aby zweryfikować, czy wyzwalacz i akcje odpowiadają zachowaniu źródłowemu.

   Wskazówka

   Aby zadać pytania dotyczące wygenerowanych danych wyjściowych, modyfikacji żądań lub ponownego generowania określonych przepływów pracy, należy wchodzić w interakcje z agentem @migration-converter przy użyciu czatu Copilot.

4. Sprawdź connections.json plik, aby uzyskać prawidłowe konfiguracje łącznika.

5. Przejrzyj wszystkie wygenerowane funkcje lokalne .NET pod kątem poprawności.

Etap migracji 4. Walidacja

Na etapie walidacji przetestuj wygenerowane przepływy pracy względem specyfikacji źródłowych. Możesz przynieść własne przypadki testowe i specyfikacje. Agent zapewnia wskazówki dotyczące walidacji i testowania w czasie rzeczywistym. Twoim celem jest potwierdzenie, że przekonwertowane przepływy pracy działają zgodnie z oczekiwaniami i są zgodne z zachowaniem przepływu źródłowego.

Na przykład plan migracji zapewnia możliwość opcjonalnego testowania czarnej skrzynki przy użyciu zewnętrznych danych wejściowych.

Wymagania dotyczące lokalnego testowania przepływów pracy

Przed rozpoczęciem kroków weryfikacji upewnij się, że na potrzeby testowania są zainstalowane następujące wymagania:

Lokalne testowanie przepływów pracy

Aby lokalnie uruchomić wygenerowane przepływy pracy, wykonaj następujące kroki:

1. Na karcie Home dla przepływu logicznego wybierz pozycję Otwórz w Visual Studio Code.

2. W folderze migracji przejdź do katalogu out i wybierz wygenerowany folder rozwiązania.

3. Otwórz folder projektu wygenerowanej aplikacji logiki.

4. Sprawdź, czy program Docker Desktop jest uruchomiony.

5. W menu Run wybierz pozycję Uruchom debugowanie (Klawiatura: F5), aby lokalnie uruchomić środowisko uruchomieniowe dla Azure Logic Apps.

   Środowisko uruchomieniowe zostanie uruchomione, a przepływy pracy staną się dostępne w lokalnych punktach końcowych.

6. Użyj przykładowych danych wejściowych, aby wysyłać żądania testowe lub wyzwalać przepływ pracy.

7. Porównaj wygenerowane zachowanie przepływu pracy z zachowaniem źródła, aby zidentyfikować wszelkie rozbieżności lub niedokładności.

   Poniższa lista kontrolna opisuje zachowania, które należy zweryfikować:

   • Wszystkie wyzwalacze są poprawnie uruchamiane z oczekiwanymi formatami wejściowymi.
   • Sekwencje akcji są uruchamiane w odpowiedniej kolejności.
   • Przekształcenia danych generują oczekiwane dane wyjściowe.
   • Logika warunkowa poprawnie rozgałęzia się z oczekiwanymi wynikami na podstawie danych wejściowych.
   • Konstrukcje pętli przetwarzają wszystkie elementy zgodnie z oczekiwaniami.
   • Zakresy obsługi błędów odpowiednio przechwytują wyjątki i obsługują je.
   • Konfiguracje połączeń prowadzą do prawidłowych punktów końcowych.
   • .NET funkcje lokalne zwracają oczekiwane wyniki.

8. Zbadaj i rozwiąż wszelkie rozbieżności lub problemy, które znajdziesz.

   Wskazówka

   Aby ułatwić ci proces rozwiązywania problemu, należy omówić rozbieżność lub problem z agentem @migration-converter za pośrednictwem czatu Copilot.

   1. W czacie Copilot opisz oczekiwane zachowanie w porównaniu z rzeczywistym zachowaniem.
   2. Przejrzyj sugerowane poprawki agenta.
   3. Jeśli zaakceptujesz zalecenia agenta i wprowadzisz zmiany, poproś agenta o ponowne wygenerowanie zaktualizowanych części przepływu pracy.

Etap 5 migracji: Wdrażanie

Etap wdrażania wdraża zmigrowane rozwiązanie Standard w Azure Logic Apps w portalu Azure.

Wymagania dotyczące wdrażania przepływów pracy

Przed rozpoczęciem kroków wdrażania upewnij się, że spełnisz następujące wymagania:

Upewnij się, że ukończyłeś etapy agenta migracji od 1 (odkrywanie) do 4 (walidacja), w tym lokalne uruchamianie wygenerowanych przepływów pracy i potwierdzenie, że ich działanie jest zgodne z działaniem źródła.

Krok 1. Konfigurowanie ustawień rozszerzenia dla wdrożenia

1. W Visual Studio Code otwórz ustawienia rozszerzenia. W menu File przejdź do Preferences>Settings>Extensions>Azure Logic Apps Migration Agent.

2. Zaktualizuj następujące wartości ustawień wdrożenia zgodnie z potrzebami:

   Nazwa ustawień	Nazwa JSON	Description	Wartość domyślna	Action
   Lokalizacja	logicAppsMigrationAgent.azure.location	Region Azure na potrzeby udostępniania zasobów.	eastus	Zmień tę wartość na żądany region.
   Grupa zasobów	logicAppsMigrationAgent.azure.resourceGroup	Grupa zasobów Azure do aprowizowania i testowania.	integration-migration-tool-test-rg	Zmień tę wartość na nazwę grupy zasobów.
   Identyfikator subskrypcji	logicAppsMigrationAgent.azure.subscriptionId	Id subskrypcji Azure do wdrożenia.	(puste)	Wprowadź identyfikator GUID subskrypcji Azure.
   Model wdrażania	logicAppsMigrationAgent.deploymentModel	Docelowy model wdrożenia dla Azure Logic Apps Standard.	workflow-service-plan	Zachowaj wartość domyślną. Chociaż App Service Environment v3 i Hybrid są wymienione jako przyszłe opcje, wersja 1.12.1 nie obsługuje tych opcji.

Krok 2. Rozpoczęcie procesu wdrażania

Aby rozpocząć wdrażanie do Azure, wykonaj następujące kroki:

1. Zaloguj się do Azure CLI przy użyciu subskrypcji Azure, na przykład:

   az login
   

2. W oknie Agenta Migracji Azure Logic Apps przejdź do planu migracji i uruchom zadanie Wdrażanie w chmurze oraz Testowanie, wybierając Uruchom:

   

   Agent migracji generuje szablon ARM lub Bicep i wykorzystuje Azure CLI do udostępniania Planu Obsługi Przepływu, Standardowej aplikacji logicznej, przechowywania oraz innych wymaganych zasobów. Agent następnie przesyła zawartość workflow do udostępniania Azure Files aplikacji logic i restartuje aplikację logic.

   Poniższy przykład przedstawia przykładowe rozwiązanie całkowicie zmigrowane:

   

Krok 3. Weryfikowanie wdrożenia

Po zakończeniu wdrażania sprawdź, czy przepływy pracy w warstwie Standardowa są wyświetlane w portalu Azure.

1. W portalu Azure wprowadź logic apps, a następnie wybierz pozycję Aplikacja logiki.

2. Na stronie Aplikacje logiki wybierz zasób standardowej aplikacji logiki.

3. Na pasku bocznym aplikacji logiki w obszarze Przepływy pracy rozwiń Przepływy pracy. Na stronie Przepływy pracy upewnij się, że są wyświetlane wszystkie oczekiwane przepływy pracy. Upewnij się, że ich stan jest włączony.

   Note

   W przypadku wyłączenia przepływu pracy zaznacz jego pole wyboru. Na pasku narzędzi Przepływy pracy wybierz pozycję Włącz.

4. Przetestuj każdy przepływ pracy przy użyciu przykładowych danych wejściowych, aby upewnić się, że działają zgodnie z oczekiwaniami.

5. Jeśli osobno skonfigurowałeś Application Insights dla swojej aplikacji logicznej Standard, użyj tej funkcji, aby znaleźć błędy w czasie działania lub problemy z wydajnością.

   1. Na pasku bocznym aplikacji logiki w obszarze Monitorowanie wybierz pozycję Application Insights.

   2. W obszarze Połącz z zasobem usługi Application Insights wybierz link do zasobu usługi Application Insights.

   Aby uzyskać więcej informacji, zobacz Wyświetlanie metryk przepływu pracy w usłudze Application Insights.

Resetowanie migracji

Migrację można ponownie uruchomić od początku. Następujące polecenie czyści stan migracji i umożliwia ponowne rozpoczęcie od etapu Discovery.

1. W Visual Studio Code otwórz paletę poleceń (Klawiatura: Ctrl+Shift+P).

2. Po wyświetleniu monitu wprowadź Azure Logic Apps Agent migracji: Resetuj migrację.

Treści powiązane

• Automatyzacja migracji z platform integracyjnych do Azure Logic Apps
• Agent migracji - Etap 1: Discovery
• Etap 2 agenta migracji: Planowanie
• Etap 3 agenta migracji: Konwersja
• Etap 4 agenta migracji: walidacja
• Etap 5 agenta migracji: Wdrożenie
• Rozszerzanie agenta migracji przez utworzenie niestandardowych analizatorów dla nieobsługiwanych platform integracji