|
| 1 | +--- |
| 2 | +title: Deploy your project to Azure by using GitHub Copilot app modernization for .NET |
| 3 | +description: Learn how to deploy your migrated .NET project to Azure by using GitHub Copilot app modernization for .NET. |
| 4 | +ms.topic: quickstart |
| 5 | +ms.custom: devx-track-dotnet |
| 6 | +ms.date: 09/17/2025 |
| 7 | +author: JiDong |
| 8 | +ms.author: donji |
| 9 | +--- |
| 10 | + |
| 11 | +# Deploy your project to Azure by using GitHub Copilot app modernization for .NET |
| 12 | + |
| 13 | +In this quickstart, you learn how to deploy your project to Azure with GitHub Copilot app modernization for .NET. This tool lets you deploy migrated projects to Azure and automatically fixes deployment errors during the process. |
| 14 | + |
| 15 | +## Prerequisites |
| 16 | + |
| 17 | +- Windows operating system |
| 18 | +- [Visual Studio 2022 version 17.14.16 or newer](https://visualstudio.microsoft.com/downloads/) |
| 19 | +- [.NET desktop development workload](/visualstudio/install/modify-visual-studio?view=vs-2022&preserve-view=true#change-workloads-or-individual-components) with these optional components enabled: |
| 20 | + - GitHub Copilot |
| 21 | + - GitHub Copilot app modernization for .NET |
| 22 | +- GitHub account with Copilot access and a supported subscription plan: |
| 23 | + - [Sign in to Visual Studio using a GitHub account](/visualstudio/ide/work-with-github-accounts) with [Copilot access](https://docs.github.com/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot). |
| 24 | + - Supported subscription plans: Copilot Pro, Copilot Pro+, Copilot Business, or Copilot Enterprise. |
| 25 | + - If you change subscriptions, restart Visual Studio. |
| 26 | + |
| 27 | +## Deploy your project |
| 28 | + |
| 29 | +The App Modernization for .NET deployment feature helps you deploy your migrated app to Azure. Follow these steps to start the deployment process: |
| 30 | + |
| 31 | +1. In Visual Studio, open your migrated project. |
| 32 | + |
| 33 | +1. Start the deployment with one of the following approaches: |
| 34 | + |
| 35 | + - **Deploy after migration**: Deploy your project after completing your migration task. GitHub Copilot asks if you'd like to deploy your project to Azure upon completing a migration task. Instructing Copilot to continue starts the deployment process. |
| 36 | + |
| 37 | + :::image type="content" source="media/start-deploy.png" alt-text="Screenshot that shows how to start the deployment process in GitHub Copilot."::: |
| 38 | + |
| 39 | + - **Use a deployment prompt**: You can enter the following prompt in Copilot chat to deploy your project to Azure: |
| 40 | + |
| 41 | + *Scan my project to identify all Azure-relevant resources, programming languages, frameworks, dependencies, and configuration files needed for deployment, and develop an architecture diagram for me using #appmod-generate-architecture-diagram. Based on that diagram, help me develop and execute a plan using #appmod-get-plan to deploy my project to Azure. deployTool: azcli, hosting service: non-aks.* |
| 42 | + |
| 43 | + :::image type="content" source="media/start-deploy-prompt.png" alt-text="Screenshot that shows how to start the deployment process in GitHub Copilot by using a prompt."::: |
| 44 | + |
| 45 | +1. After you start the deployment, GitHub Copilot might ask for your approval to use tools or run commands. Grant permission when prompted. |
| 46 | + |
| 47 | +1. GitHub Copilot creates a plan. The plan explains the deployment strategy, including deployment goals, project information, Azure resource architecture, Azure resources, and execution steps. |
| 48 | + |
| 49 | +1. You can edit the plan directly or ask GitHub Copilot to edit it to customize your deployment before you proceed. |
| 50 | + |
| 51 | +1. When you're satisfied with the plan, instruct GitHub Copilot to continue. |
| 52 | + |
| 53 | +1. GitHub Copilot follows the plan and runs the deployment process. |
| 54 | + |
| 55 | +1. When deployment finishes, GitHub Copilot provides a summary of the deployment process. |
| 56 | + |
| 57 | +## Notes |
| 58 | + |
| 59 | +- Use Claude Sonnet 4 or later models for the best results. |
| 60 | +- Copilot can need a few iterations to fix deployment errors. |
0 commit comments