Szybki start: tworzenie i stosowanie własnych zadań na potrzeby modernizacji aplikacji GitHub Copilot

W tym szybkim przewodniku pokazano, jak utworzyć i zastosować własne zadania podczas korzystania z GitHub Copilot do modernizacji aplikacji.

W przypadku tworzenia kodu przedsiębiorstwa często mają różne procesy i mechanizmy kontroli w celu przestrzegania zasad organizacyjnych i potrzeb biznesowych. W tym obszarze pojawiają się Moje Zadania (Niestandardowe). Twoje zadanie jest generowane przez analizowanie zatwierdzeń kodu z już zmigrowanego kodu. Następnie zadanie przeprowadzi Copilota w celu skorygowania kodu zgodnie ze wzorcem ustalonym przez już zmigrowany kod.

W poniższym filmie wideo pokazano, jak za pomocą modernizacji aplikacji GitHub Copilot utworzyć i zastosować własne zadanie niestandardowe w celu przeprowadzenia migracji projektu Java na platformę Azure:

Prerequisites

• Konto usługi GitHub z aktywną subskrypcją narzędzia GitHub Copilot w ramach dowolnego planu.
• Jedno 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.

Tworzenie własnego zadania

Teraz obsługujemy trzy sposoby dodawania odwołań: zatwierdzeń usługi Git, linków zewnętrznych i plików tekstowych. Jednocześnie można użyć jednej lub kilku metod.

Korzystanie z zatwierdzeń usługi Git

W poniższych krokach przedstawiono przykład tworzenia własnego zadania przy użyciu zatwierdzeń w Git jako punktów odniesienia.

1. Sklonuj repozytorium przykładów migracji języka Java.

2. W programie Visual Studio Code otwórz rabbitmq-sender folder projektu z sklonowanego repozytorium. Następnie przejdź do gałęzi źródłowej .

3. Na pasku bocznym Działanie otwórz okienko rozszerzenia modernizacji aplikacji GitHub Copilot , umieść kursor nad sekcją ZADANIA , a następnie wybierz pozycję Utwórz zadanie niestandardowe.

   

4. Otwiera się plik task.md. W polu Nazwa zadania wprowadź niestandardowe zadanie migracji rabbitmq. W polu Pole z poleceniem zadania wprowadź Jesteś asystentem dewelopera platformy Spring Boot, postępuj zgodnie z commit, aby przeprowadzić migrację z RabbitMQ do ServiceBus.

   

5. Wybierz pozycję Dodaj odwołania, a następnie wybierz pozycję Zatwierdzenia Git w oknie dialogowym.

   

6. Wyszukaj commit migrujący RabbitMQ, wpisując migracja rabbitmq do usługi Service Bus. Wybierz odpowiednie zatwierdzenie, a następnie wybierz przycisk OK.

   

7. Wybierz Zapisz. Twoje zadanie niestandardowe do migracji rabbitmq teraz pojawia się w sekcji ZADANIA — Moje zadania.

   

Używanie linków zewnętrznych i plików tekstowych

W poniższych krokach pokazano przykład tworzenia własnego zadania przy użyciu linków zewnętrznych i plików tekstowych jako odwołań:

1. task.md Otwórz plik, wykonując wstępnie zdefiniowane kroki w rozszerzeniu modernizacji aplikacji GitHub Copilot.

2. W otwartym task.md pliku wprowadź następujące informacje:

   • Nazwa zadania: uwidacznia punkt końcowy kondycji za pomocą siłownika Spring Boot.
   • Polecenie zadania: jesteś asystentem dewelopera Spring Boot, postępuj zgodnie z dokumentacją Actuator Spring Boot, aby dodać podstawowe punkty końcowe kondycji dla wdrożenia usługi Azure Container Apps.

   

3. Wybierz pozycję Dodaj odwołania. W oknie podręcznym wybierz pozycję Linki zewnętrzne, a następnie wklej następujący adres URL: https://docs.spring.io/spring-boot/reference/actuator/endpoints.html i naciśnij Enter , aby potwierdzić.

   

4. Utwórz plik zawierający następującą zawartość:

   In this migration, only expose the health endpoints over web, use the following property:
   management.endpoints.web.exposure.include=health
   

5. Ponownie wybierz pozycję Dodaj odwołania , a tym razem wybierz pozycję Pliki tekstowe. Znajdź utworzony plik, a następnie wybierz pozycję Wybierz plik.

6. Powinny zostać wyświetlone dwa dodane odwołania: jeden link zewnętrzny i jeden plik tekstowy. Wybierz pozycję Zapisz , aby zakończyć i utworzyć zadanie.

   

Udostępnianie własnego zadania

Aby udostępnić zadanie innym osobom, wykonaj następujące czynności:

1. Skopiuj folder znajdujący się w folderze .github/appmod/custom-tasks zawierającym utworzone zadanie i udostępnij go zamierzonemu adresatowi.

   

2. Po stronie adresata utwórz katalog .github/appmod/custom-tasks w ścieżce źródłowej projektu.

   

3. Wklej folder zadań do tego katalogu, a następnie wybierz pozycję Odśwież zadanie w okienku rozszerzenia.

   

4. Zadanie jest teraz wyświetlane w sekcji ZADANIA — Moje zadania gotowe do użycia.

   

Zastosuj własne zadanie

Aby zastosować własne zadanie, wykonaj następujące czynności:

1. Wybierz pozycję Uruchom w dolnej części pliku. Możesz też znaleźć własne zadanie w sekcji ZADANIA — Moje zadania w okienku modernizacji aplikacji GitHub Copilot i uruchomić zadanie, wybierając pozycję Uruchom zadanie.

   

2. Okno czatu Copilot otwiera się w trybie agenta i automatycznie wykonuje następujące kroki:

   • Tworzy plan.md i progress.md.
   • Sprawdza stan kontroli wersji i sprawdza nową gałąź migracji.
   • Wykonuje migrację kodu.
   • Uruchamia walidacje: kompilacja, testy, CVE, spójność i kompletność.
   • Generuje plik summary.md .

3. Jeśli agent przestanie czekać na potwierdzenie lub zostanie przerwany podczas wykonywania, wprowadź przycisk Kontynuuj , aby kontynuować.

4. Po zakończeniu wszystkich kroków przejrzyj zmiany kodu, a następnie wybierz pozycję Zachowaj , aby potwierdzić w oknie czatu.

Aktualizowanie lub usuwanie własnego zadania

Znajdź pozycję Niestandardowe zadanie migracji RabbitMQ w sekcji ZADANIA - Moje zadania, a następnie kliknij prawym przyciskiem myszy, aby otworzyć menu kontekstowe i wybrać jedną z następujących opcji:

• Edytuj , aby zaktualizować zadanie.
• Usuń , aby usunąć zadanie.

Następny krok

Wstępnie zdefiniowane zadania dotyczące modernizacji aplikacji GitHub Copilot