Szybki start: ocenianie i migrowanie projektu Java przy użyciu modernizacji aplikacji GitHub Copilot

Ten przewodnik szybkiego startu pokazuje, jak za pomocą modernizacji aplikacji GitHub Copilot ocenić i przenieść projekt w języku Java. W tym przewodniku Szybki start zainstalujesz i skonfigurujesz rozszerzenie, a następnie ocenisz i zmigrujesz przykładowy projekt. Na przykład za pomocą wstępnie zdefiniowanego zadania zaktualizujesz połączenie bazy danych Azure SQL Database, aby użyć tożsamości zarządzanej platformy Azure zamiast nazwy użytkownika i hasła.

W poniższym filmie wideo pokazano, jak modernizacja aplikacji GitHub Copilot korzysta z usługi AppCAT , aby ułatwić ocenę projektu Java na potrzeby migracji na platformę Azure:

Prerequisites

• Konto Azure z aktywną subskrypcją. Utwórz je bezpłatnie.

• Konto usługi GitHub z aktywną subskrypcją narzędzia GitHub Copilot w ramach dowolnego planu.
• Jeden z następujących IDE:
  • Najnowsza wersja programu Visual Studio Code. Musi być w wersji 1.101 lub nowszej.
    • GitHub Copilot w programie Visual Studio Code. Aby uzyskać instrukcje dotyczące konfiguracji, zobacz Konfigurowanie narzędzia GitHub Copilot w programie Visual Studio Code. Pamiętaj, aby zalogować się do konta usługi GitHub w programie Visual Studio Code.
    • Modernizacja aplikacji GitHub Copilot. Uruchom ponownie program Visual Studio Code po zakończeniu instalacji.
  • Najnowsza wersja IntelliJ IDEA. Musi być w wersji 2023.3 lub nowszej.
    • GitHub Copilot. Musi być w wersji 1.5.59 lub nowszej. Aby uzyskać więcej instrukcji, zobacz Konfigurowanie narzędzia GitHub Copilot w środowisku IntelliJ IDEA. Pamiętaj, aby zalogować się do konta usługi GitHub w środowisku IntelliJ IDEA.
    • Modernizacja aplikacji GitHub Copilot. Uruchom ponownie środowisko IntelliJ IDEA po instalacji. Jeśli nie masz zainstalowanego narzędzia GitHub Copilot, możesz zainstalować modernizację aplikacji GitHub Copilot bezpośrednio.
• Java 21 lub nowsza.
• Maven lub Gradle do kompilowania projektów Java.

Uwaga / Notatka

Jeśli używasz narzędzia Gradle, obsługiwana jest tylko wersja wrappera Gradle 5 lub nowsza. Język specyficzny dla domeny Kotlin (DSL) nie jest obsługiwany.

Funkcja My Tasks nie jest jeszcze obsługiwana w środowisku IntelliJ IDEA.

Uaktualnianie zestawu JDK i wersji zależności

Istnieją dwa sposoby uaktualniania wersji zestawu JDK. Oba sposoby korzystają z okienka modernizacji aplikacji GitHub Copilot w programie Visual Studio Code, do którego można uzyskać dostęp z paska bocznego.

Jednym ze sposobów uaktualnienia wersji zestawu JDK jest wybranie opcji Uaktualnij środowisko uruchomieniowe i struktury w sekcji SZYBKI START . Innym sposobem jest uruchomienie zadania Uaktualnione środowisko uruchomieniowe Java w sekcji ZADANIA — uaktualnianie zadań . Aby uzyskać więcej informacji, zobacz Szybki start: uaktualnianie projektu Java przy użyciu modernizacji aplikacji GitHub Copilot.

Aby uaktualnić platformę Spring lub zależność innej firmy, uruchom zadanie Uaktualnianie platformy Java Framework w sekcji ZADANIA — uaktualnianie zadań . Aby uzyskać więcej informacji, zobacz Aktualizacja frameworku Java lub zewnętrznych zależności za pomocą modernizacji aplikacji GitHub Copilot.

Ocena gotowości do chmury

Wykonaj poniższe kroki, aby rozpocząć proces migracji z oceną rozwiązania. Ta ocena pomaga zrozumieć, jakie są wyzwania związane z gotowością do chmury i jak mają one wpływ. Udostępnia również zalecane rozwiązania. Zalecenie dotyczące rozwiązania zawiera odwołania do konfigurowania zasobów platformy Azure, dodawania konfiguracji i wprowadzania zmian w kodzie.

1. Sklonuj repozytorium przykładów migracji języka Java, a następnie przełącz się na gałąź source.

2. W programie Visual Studio Code otwórz folder projektu mi-sql-public-demo w repozytorium przykładów.

3. Na pasku bocznym wybierz panel modernizacji aplikacji GitHub Copilot, gdzie możesz wybrać opcję Migruj do Azure lub Uruchom ocenę w sekcji OCENA.

   

4. Zostanie otwarte okno czatu w usłudze GitHub Copilot z trybem agenta w celu wywołania osoby oceniającej modernizację w celu przeprowadzenia oceny modernizacji aplikacji. Wybierz pozycję Kontynuuj , aby potwierdzić.

5. Kalkulator modernizacji teraz otwiera appcat.log. Ten plik zawiera dzienniki uruchamiania aplikacji AppCAT, które przeprowadza ocenę aplikacji. Wybierz pozycję Kontynuuj , aby potwierdzić ponownie.

6. Osoba oceniająca modernizację najpierw weryfikuje środowisko lokalne. Jeśli serwer AppCAT i jego zależności nie są zainstalowane, agent pomaga je zainstalować. Po zakończeniu instalacji agent wywołuje aplikację AppCAT, aby ocenić bieżący projekt. Wykonanie tego kroku może potrwać kilka minut.

7. Po zakończeniu analizy ocena modernizacji tworzy podzielony na kategorie widok problemów z gotowością do chmury w otwartym raporcie oceny.

   

8. Podczas przeglądania raportu podsumowania możesz wybrać pozycję Migruj do usługi Azure SQL Database (Spring) z listy rozwiązań w obszarze problemu Database Migration (Microsoft SQL). Następnie wybierz pozycję Uruchom zadanie , aby przejść do etapu korygowania kodu.

   

Stosowanie wstępnie zdefiniowanego zadania

W przypadku migracji copilot udostępnia wstępnie zdefiniowane zadania dla typowych scenariuszy migracji, które mogą wystąpić podczas migracji na platformę Azure. Na przykład w przykładzie mi-sql-public-demo zadanie Database Migration (Microsoft SQL) zmienia połączenie bazy danych Azure SQL Database w celu używania tożsamości zarządzanej platformy Azure zamiast nazwy użytkownika i hasła.

Aby zastosować wstępnie zdefiniowane zadanie, wykonaj następujące czynności:

1. W raporcie oceny wybierz pozycję Uruchom zadanie. Okno czatu Copilot otwiera się z wybranym trybem agenta.

2. Agent Copilot używa różnych narzędzi do modernizacji aplikacji, a każde narzędzie może wymagać potwierdzenia, aby kontynuować. plan.md i progress.md są generowane jako pierwsze, a w razie potrzeby możesz przejrzeć plan.md i wprowadzić tam zmiany.

3. Ręcznie wpisz continue, aby potwierdzić i rozpocząć proces migracji.

4. Przed wprowadzeniem jakichkolwiek zmian w kodzie agent sprawdza stan systemu kontroli wersji i sprawdza nową gałąź do migracji.

5. Wielokrotnie wybieraj lub wprowadzaj dane wejściowe Kontynuuj , aby potwierdzić użycie narzędzi lub poleceń i poczekać na zakończenie zmian kodu.

Iteracja walidacji

Po zakończeniu zmian kodu ręcznie wprowadź continue, aby kontynuować walidację i pętlę iteracji. Ta pętla obejmuje następujące pięć części:

• Zastosuj Validate-CVEs narzędzie. To narzędzie próbuje wykryć typowe luki w zabezpieczeniach i ekspozycji (CVE) w bieżących zależnościach i naprawia je.
• Zastosuj Build-Project narzędzie. To narzędzie próbuje usunąć błędy kompilacji.
• Zastosuj Consistency-Validation narzędzie. To narzędzie analizuje kody spójności funkcjonalnej.
• Zastosuj Run-Test narzędzie. To narzędzie analizuje projekt pod kątem niepowodzeń testów jednostkowych i automatycznie generuje plan ich naprawy. Narzędzie Run-Test iteracyjne uruchamia testy jednostkowe i naprawia wszelkie błędy.
• Zastosuj Completeness-Validation narzędzie. To narzędzie przechwytuje elementy migracji pominięte w początkowej migracji kodu i naprawia je.

Po zakończeniu wszystkich procesów wpisz continue, aby wygenerować podsumowanie migracji. Przejrzyj zmiany kodu i potwierdź je, wybierając pozycję Zachowaj.

Generowanie przypadków testów jednostkowych

Aby wygenerować przypadki testów jednostkowych, wykonaj następujące kroki:

1. Na pasku bocznym wybierz okienko modernizacji aplikacji GitHub Copilot .

2. W sekcji ZADANIA otwórz zadania dotyczące jakości i zabezpieczeń, a następnie wybierz pozycję Generuj przypadki testowe jednostkowe.

Agent generuje testy jednostkowe i tworzy raport TestReport w celu wyświetlania wyników testów przed i po wygenerowaniu. Aby uzyskać więcej informacji, zobacz Szybki start: generowanie testów jednostkowych przy użyciu modernizacji aplikacji GitHub Copilot.

Dalsze kroki

• Praca nad oceną
• Szybki start: tworzenie i stosowanie własnych zadań