Migre aplicações .NET usando a modernização de aplicações com o GitHub Copilot no Copilot Coding Agent

Este artigo mostra-lhe como migrar aplicações .NET usando do GitHub Copilot para modernização de aplicações no Copilot Coding Agent. O agente trabalha de forma independente em segundo plano para completar tarefas de modernização. Delegar tarefas através de incidentes ou pull requests; o agente executa-as na nuvem para ajudar a sua equipa a modernizar-se eficientemente.

Observação

O Copilot Coding Agent está disponível com os planos GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business e GitHub Copilot Enterprise. O agente está disponível em todos os repositórios do GitHub, exceto aqueles que são detidos por contas de utilizador geridas ou onde está explicitamente desativado.

Pré-requisitos

Agente de Programação Copilot configurado.
Uma subscrição GitHub Copilot Pro, Pro+, Business ou Enterprise.
Um repositório GitHub contendo o código-fonte da tua aplicação.
Um ambiente Copilot com o SDK .NET 10 instalado. Consulte personalizar o ambiente do agente para mais detalhes. Para instalar o SDK .NET 10, adicione estes passos ao copilot-setup-steps.yml:
```
- name: Set up .NET 10
  uses: actions/setup-dotnet@v5
  with:
    dotnet-version: '10.x'

- name: Verify .NET 10
  run: |
    dotnet --info
```

Adicionar o Servidor MCP

Vai às Definições do repositório de destino que queres modernizar (é necessário acesso de administrador).
Selecione Copilot, depois selecione Agente de Programação.

Na secção Model Context Protocol (MCP) em Configuração MCP, adicione a seguinte configuração e selecione Guardar Configuração:

{
  "mcpServers": {
    "DotNetAppModMcpServer-migrate": {
      "type": "local",
      "command": "dnx",
      "tools": [
        "*"
      ],
      "args": [
        "Microsoft.AppModernization.McpServer.DotNet.Migration",
        "--yes",
        "--source",
        "https://api.nuget.org/v3/index.json"
      ]
    }
  }
}

(Opcional) Se forem necessárias variáveis de ambiente, defina-as em Ambiente → Copilot nas definições. Estas variáveis inicializam-se automaticamente na primeira vez que uma tarefa agente é invocada neste repositório.
Guarde a configuração do MCP.

Criar um agente personalizado

Vá ao separador de agentes em https://github.com/copilot/agents.
Na caixa de diálogo, abra o menu suspenso e selecione o repositório onde quer criar o perfil de agente personalizado.
(Opcional) Selecione a agência onde quer criar o perfil do agente. O padrão é o ramo principal.
Seleciona o ícone do Copilot e depois seleciona + Criar um agente. Esta ação abre um perfil de agente modelo nomeado my-agent.agent.md no .github/agents diretório do seu repositório de destino.

Cole o conteúdo abaixo no modelo e renomeie o ficheiro para appmod-dotnet.agent.md.

---
# .NET Modernization Assistant - Custom GitHub Copilot Agent
# This agent helps modernize .NET applications with modern technologies and prepare them for Azure
# For format details, see: https://gh.io/customagents/config

name: dotnet-modernization
description: Expert assistant for modernizing .NET applications with modern technologies (logging, authentication, configuration) and preparing them for Azure migration, with specialized tools for assessment, code analysis, and step-by-step migration guidance.
---

# .NET Modernization Assistant

I am a specialized AI assistant for modernizing .NET applications with modern technologies and preparing them for Azure.

## What I Can Do

- **Migration**: Execute structured migrations to modern technologies (logging, authentication, configuration, data access)
- **Validation**: Run builds, tests, CVE checks, and consistency/completeness verification
- **Tracking**: Maintain migration plans and progress in `.appmod/.migration/` directory
- **Azure Preparation**: Modernize code patterns for cloud-native Azure deployment

## ⚠️ CRITICAL: Migration Workflow

### 1. Planning Phase (REQUIRED FIRST STEP)
**Before any migration work, I MUST call `dotnet_migration_plan_tool` first.**

This tool will provide instructions for generating `plan.md` and `progress.md` files in `.appmod/.migration/`.

### 2. Execution Phase
**I MUST strictly follow the plan and progress files.**

Migration phases in order:
1. **Analysis**: Analyze the solution structure and dependencies
2. **Dependencies**: Update NuGet packages and project references
3. **Configuration**: Migrate config files (app.config/web.config → appsettings.json)
4. **Code**: Transform code to modern .NET patterns
5. **Verification** (MANDATORY - NO SKIPPING):
  - ✅ Build verification (use bash command `dotnet msbuild`)
  - ✅ CVE vulnerability check (`check_cve_vulnerability`)
  - ✅ Consistency check (`migration_consistency`)
  - ✅ Completeness check (`migration_completeness`)
  - ✅ Unit test verification (use bash command `dotnet test`)

### 3. Completion Phase
**Write a brief summary of the migration process**, including:
- What was migrated
- Key changes made
- Verification results
- Any issues encountered and resolved

## Core Principles

1. **Always call tools in real-time** - Never reuse previous results
2. **Follow the plan strictly** - Update `progress.md` after each task
3. **Never skip verification steps** - All checks are mandatory
4. **Use tools, not instructions** - Execute actions directly via tools
5. **Track progress** - Create Git branches and commits for each task

## Important Rules

✅ **DO:**
- Call `dotnet_migration_plan_tool` before any migration
- Follow plan.md and progress.md strictly
- Complete ALL verification steps
- Write migration summary at completion
- Read files before editing them
- Track all changes in Git

❌ **DON'T:**
- Skip the planning tool
- Skip any verification steps
- Reuse previous tool results
- Stop mid-migration for confirmation
- Skip progress tracking

---

**Ready to modernize your .NET applications?** Ask me to start a migration!

Faz o commit do ficheiro e faz o merge para o branch predefinido.
Volte ao separador de agentes e atualize a página se necessário. O seu agente personalizado aparece no menu suspenso quando abre o seletor de agente na caixa de diálogo.

Visite Criar um perfil de agente personalizado num repositório no GitHub para mais informações.

Migre a aplicação .NET para o Azure

Abre o painel de Agentes.
Selecione o seu target repository, selecione o custom agent e introduza o seu prompt.

Depois de o submeteres, o Copilot inicia uma nova sessão e abre um novo pull request. Aparece na lista abaixo da caixa de prompt. O Copilot trabalha na tarefa e adiciona-te como revisor quando termina, ativando uma notificação.

Aqui estão alguns exemplos de prompts para referência:
```
Migrate this project from local file I/O to Azure Blob Storage
Migrate this project from local SQL Server to Azure SQL Database with managed identity
Migrate this project from file-based logging to OpenTelemetry
```
Para detalhes sobre tarefas de migração predefinidas, veja tarefas de migração.
Depois do início da migração, monitorize o progresso:
Por fim, consulte o resumo da migração para obter insights — certifique-se de que a sua aplicação está totalmente migrada e pronta para a cloud.

Desencadear a aplicação .NET para o Azure

Após a migração, implemente diretamente a partir do Coding Agent usando um prompt como:

Deploy this application to Azure

Segue o mesmo fluxo de trabalho da migração – o processo global mantém-se consistente.

Fornecer comentários

Partilhe feedback sobre o GitHub Copilot Coding Agent usando o formulário de feedback do agente GitHub Copilot.

Reference

Usando o Agente de Codificação GitHub Copilot

Comentários

Esta página foi útil?

Last updated on 2025-12-05