Guida introduttiva: Creare e applicare attività personalizzate per la modernizzazione delle app GitHub Copilot

Questa guida introduttiva illustra come creare e applicare attività personalizzate quando si usa la modernizzazione delle app di GitHub Copilot.

Nello sviluppo di codice, le aziende hanno spesso processi e controlli diversi per rispettare i criteri e le esigenze aziendali dell'organizzazione. Questa area è dove vengono fornite Le mie attività (Personalizzate). La tua attività viene generata analizzando i commit di codice dal codice che è già stato migrato. L'attività guida quindi Copilot a rimodellare il codice, seguendo il modello stabilito dal codice già migrato.

Il video seguente illustra l'uso della modernizzazione dell'app GitHub Copilot per creare e applicare un'attività personalizzata per eseguire la migrazione di un progetto Java ad Azure:

Prerequisites

• Un account GitHub con una sottoscrizione di GitHub Copilot attiva in qualsiasi piano.
• Uno degli IDE seguenti:
  • Versione più recente di Visual Studio Code. Deve essere la versione 1.101 o successiva.
    • GitHub Copilot in Visual Studio Code. Per istruzioni sulla configurazione, vedere Configurare GitHub Copilot in Visual Studio Code. Assicurarsi di accedere all'account GitHub in Visual Studio Code.
    • Modernizzazione delle app Copilot di GitHub. Riavviare Visual Studio Code dopo l'installazione.
  • La versione più recente di IntelliJ IDEA. Deve essere la versione 2023.3 o successiva.
    • GitHub Copilot. Deve essere la versione 1.5.59 o successiva. Per altre istruzioni, vedere Configurare GitHub Copilot in IntelliJ IDEA. Assicurarsi di accedere all'account GitHub all'interno di IntelliJ IDEA.
    • Modernizzazione delle app Copilot di GitHub. Riavviare IntelliJ IDEA dopo l'installazione. Se GitHub Copilot non è installato, è possibile installare direttamente la modernizzazione dell'app GitHub Copilot.
• Java 21 o versione successiva.
• Maven o Gradle per compilare progetti Java.

Annotazioni

Se si usa Gradle, è supportato solo il wrapper Gradle versione 5+. Il linguaggio DSL (Domain Specific Language) di Kotlin non è supportato.

La funzione My Tasks non è ancora supportata per IntelliJ IDEA.

Creare un'attività personalizzata

Sono ora supportati tre modi per aggiungere riferimenti: commit Git, collegamenti esterni e file di testo. È possibile usare uno o più metodi alla volta.

Utilizzare i commit Git

I passaggi seguenti forniscono un esempio di creazione di attività personalizzate usando i commit Git come riferimenti:

1. Clonare il repository di esempi di copilot per la migrazione Java .

2. In Visual Studio Code aprire la cartella del rabbitmq-sender progetto dal repository clonato. Passare quindi al ramo di origine .

3. Nella barra laterale Attività aprire il riquadro Dell'estensione per la modernizzazione dell'app GitHub Copilot , passare il puntatore del mouse sulla sezione ATTIVITÀ e quindi selezionare Crea un'attività personalizzata.

   

4. Verrà aperto un task.md file. Nel campo Nome attività immettere Custom task migrate rabbitmq. Nel campo Prompt delle attività immettere Sei un assistente sviluppatore di Spring Boot, segui il commit per migrare da RabbitMQ a ServiceBus.

   

5. Selezionare Aggiungi riferimenti e quindi selezionare Commit Git nella finestra di dialogo popup.

   

6. Cercare il commit che esegue la migrazione di RabbitMQ digitando migrate rabbitmq al bus di servizio. Selezionare il commit corrispondente e quindi selezionare OK.

   

7. Seleziona Salva. L'attività personalizzata per la migrazione rabbitmq viene ora visualizzata nella sezione ATTIVITÀ - Attività personali .

   

Usare collegamenti esterni e file di testo

I passaggi seguenti illustrano un esempio di creazione di un'attività personalizzata usando collegamenti esterni e file di testo come riferimenti:

1. Aprire il task.md file seguendo i passaggi predefiniti nell'estensione di modernizzazione dell'app GitHub Copilot.

2. Nel file aperto task.md immettere le informazioni seguenti:

   • Nome attività: esporre l'endpoint di integrità tramite l'attuatore Spring Boot.
   • Prompt delle attività: Sei un assistente per sviluppatori Spring Boot, segui la documentazione di Spring Boot per aggiungere endpoint di salute di base per la distribuzione delle App container di Azure.

   

3. Selezionare Aggiungi riferimenti. Nella finestra popup selezionare Collegamenti esterni, quindi incollare l'URL seguente: https://docs.spring.io/spring-boot/reference/actuator/endpoints.html e premere INVIO per confermare.

   

4. Creare un file contenente il contenuto seguente:

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

5. Selezionare di nuovo Aggiungi riferimenti e questa volta selezionare File di testo. Individuare il file creato e quindi Seleziona file.

6. Verranno ora visualizzati due riferimenti: un collegamento esterno e un file di testo. Selezionare Salva per finalizzare e creare l'attività.

   

Condividi la tua attività

Usare la procedura seguente per condividere l'attività con altri utenti:

1. Copiare la cartella che si trova in .github/appmod/custom-tasks contenente l'attività creata e condividerla con il destinatario previsto.

   

2. Sul lato del destinatario creare una directory .github/appmod/custom-tasks nel percorso di origine del progetto.

   

3. Incollare la cartella attività in questa directory e quindi selezionare Aggiorna attività nel riquadro dell'estensione.

   

4. L'attività viene ora visualizzata nella sezione ATTIVITÀ - Attività personali, pronta per l'uso.

   

Applica la tua attività

Per applicare un compito personalizzato, seguire questa procedura.

1. Selezionare Esegui nella parte inferiore del file. In alternativa, trovare un'attività personalizzata nella sezione ATTIVITÀ - Attività personali del riquadro di modernizzazione dell'app GitHub Copilot ed eseguire l'attività selezionando Esegui attività.

   

2. La finestra della chat di Copilot viene visualizzata in modalità agente ed esegue automaticamente i passaggi seguenti:

   • Crea plan.md e progress.md.
   • Controlla lo stato del controllo della versione ed effettua il checkout di un nuovo ramo di migrazione.
   • Esegue la migrazione del codice.
   • Esegue le convalide: compilazione, test, CVE, coerenza e completezza.
   • Genera un file summary.md .

3. Se l'agente si ferma durante l'attesa della tua conferma o viene interrotto durante l'esecuzione, immettere Continua.

4. Al termine di tutti i passaggi, esaminare le modifiche al codice e quindi selezionare Mantieni per confermare nella finestra di chat.

Aggiornare o eliminare un'attività personalizzata

Individuare l'attività personalizzata 'migrate rabbitmq' nella sezione ATTIVITÀ - le mie Attività, quindi cliccare con il tasto destro del mouse per aprire il menu contestuale e scegliere una delle opzioni seguenti:

• Modifica per aggiornare l'attività.
• Elimina per rimuovere l'attività.

Passo successivo

Attività predefinite per la modernizzazione delle app Copilot di GitHub