|
| 1 | +--- |
| 2 | +title: Containerize your project using GitHub Copilot app modernization for .NET |
| 3 | +description: Learn how to containerize your .NET project using GitHub Copilot app modernization for .NET. |
| 4 | +#customer intent: As a .NET developer, I want to containerize my project using GitHub Copilot App Modernization so that I can modernize my application efficiently. |
| 5 | +ms.topic: quickstart |
| 6 | +ms.custom: devx-track-dotnet |
| 7 | +ms.date: 09/17/2025 |
| 8 | +author: JiDong |
| 9 | +ms.author: donji |
| 10 | +--- |
| 11 | + |
| 12 | +# Quickstart: Containerize your project using GitHub Copilot app modernization for .NET |
| 13 | + |
| 14 | +In this quickstart, you learn how to containerize your project using GitHub Copilot app modernization for .NET. The app modernization tooling uses GitHub Copilot's AI capabilities to: |
| 15 | + |
| 16 | +- Analyze your project structure and dependencies |
| 17 | +- Generate Dockerfile configurations |
| 18 | +- Create build-ready Docker images |
| 19 | +- Guide you through the containerization process |
| 20 | + |
| 21 | +## Prerequisites |
| 22 | + |
| 23 | +Before you begin, make sure you have: |
| 24 | + |
| 25 | +- Windows operating system |
| 26 | +- [Visual Studio 2022 version 17.14.16 or newer](https://visualstudio.microsoft.com/downloads/) |
| 27 | +- [.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: |
| 28 | + - GitHub Copilot |
| 29 | + - GitHub Copilot app modernization for .NET |
| 30 | +- GitHub account with Copilot access and a supported subscription plan: |
| 31 | + - [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). |
| 32 | + - Supported subscription plans: Copilot Pro, Copilot Pro+, Copilot Business, or Copilot Enterprise. |
| 33 | + - If you change subscriptions, restart Visual Studio. |
| 34 | + |
| 35 | +## Containerize your project |
| 36 | + |
| 37 | +The GitHub Copilot app modernization for .NET containerization feature helps you containerize your project. To start the containerization process, complete the following steps: |
| 38 | + |
| 39 | +1. Open your project in Visual Studio. |
| 40 | + |
| 41 | +1. Start containerization by using one of these approaches: |
| 42 | + |
| 43 | + - **Containerize from Assessment Report**: In the assessment report, select **Run Task** for the Docker Containerization issue. |
| 44 | + |
| 45 | + :::image type="content" source="media/containerize-assessment-report.png" alt-text="Screenshot that shows containerization task in assessment report."::: |
| 46 | + |
| 47 | + - **Use a containerization prompt**: You can input the following prompt in Copilot chat to containerize your project: |
| 48 | + |
| 49 | + *Scan my project and help me plan how to containerize my application using the #appmod-get-containerization-plan tool. Execute the plan. The end goal is to have Dockerfiles that are able to be built.* |
| 50 | + |
| 51 | + :::image type="content" source="media/containerization-prompt.png" alt-text="Screenshot that shows how to start the containerization process in GitHub Copilot using a prompt."::: |
| 52 | + |
| 53 | +1. After you start the process, GitHub Copilot can ask for your approval to use tools or run commands. Grant permission when prompted. |
| 54 | + |
| 55 | +1. GitHub Copilot analyzes your project and generates a plan. The plan includes a breakdown of your project and steps for containerizing your project. |
| 56 | + |
| 57 | +1. GitHub Copilot follows the steps to generate a Dockerfile and validate that your Docker image builds successfully. |
| 58 | + |
| 59 | +1. When GitHub Copilot finishes containerizing your project, it provides a summary of what it did. |
| 60 | + |
| 61 | +## Notes |
| 62 | + |
| 63 | +- Use Claude Sonnet 4 or later models for the best results. |
| 64 | +- Copilot might take a few iterations to fix containerization errors. |
0 commit comments