|
| 1 | +--- |
| 2 | +title: Containerization 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 | +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 | +# Containerization your project using GitHub Copilot app modernization for .NET |
| 12 | + |
| 13 | +In this quickstart, you learn how to to containerize your project using [GitHub Copilot app modernization for .NET (Preview)](https://aka.ms/appmod-dotnet-marketplace). |
| 14 | +This tool helps you generate dockerfile and build docker image. |
| 15 | + |
| 16 | +## Prerequisites |
| 17 | + |
| 18 | + |
| 19 | +Before you begin, ensure you have the following prerequisites: |
| 20 | + |
| 21 | +- A GitHub account with [GitHub Copilot](https://github.com/features/copilot) enabled (Pro, Pro+, Business, or Enterprise plan required) |
| 22 | +- [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/) version 17.14.7 or later |
| 23 | +- Agent mode enabled for GitHub Copilot in Visual Studio ([Learn how](/visualstudio/ide/copilot-agent-mode)) |
| 24 | + |
| 25 | +### Sign in to GitHub Copilot |
| 26 | + |
| 27 | +GitHub Copilot is required for the App Modernization extension. Make sure you're signed-in to GitHub Copilot inside Visual Studio: |
| 28 | + |
| 29 | +1. Select the Copilot icon at the top of Visual Studio to open the GitHub Copilot pane. |
| 30 | +1. Follow the UI prompts to sign in to Copilot. |
| 31 | + |
| 32 | +For more information, see [Set up GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states). |
| 33 | + |
| 34 | +## Install the GitHub Copilot app modernization extension |
| 35 | + |
| 36 | +To complete the steps in this quickstart, you need to install the GitHub Copilot app modernization for .NET (Preview) Visual Studio extension: |
| 37 | + |
| 38 | +1. Inside Visual Studio, navigate to **Extensions** > **Manage Extensions**. |
| 39 | +1. Search for **GitHub Copilot app modernization for .NET** in the marketplace. |
| 40 | +1. On the extension page, select **Install**. |
| 41 | +1. Follow the notification bar prompts to close Visual Studio and complete the installation. |
| 42 | +1. Relaunch Visual Studio after installation. |
| 43 | + |
| 44 | +You can also view the [GitHub Copilot app modernization for .NET (Preview)](https://aka.ms/appmod-dotnet-marketplace) extension directly in the extension marketplace. |
| 45 | + |
| 46 | +For more information, see [Find, install, and manage extensions for Visual Studio](/visualstudio/ide/finding-and-using-visual-studio-extensions). |
| 47 | + |
| 48 | +## Containerize your project |
| 49 | + |
| 50 | +The App Modernization for .NET containerization feature helps you containerize your project. Follow these step to start the containerization process: |
| 51 | + |
| 52 | +1. In Visual Studio, open your project. |
| 53 | + |
| 54 | +1. Start containerization using one of the following approaches: |
| 55 | + |
| 56 | + - **Conatinerize from Assessment Report**: From the assessment report, click on "Run Task" for the Docker Containerization issue. |
| 57 | + |
| 58 | + :::image type="content" source="media/containerize-assessment-report.png" alt-text="Screenshot showing containerization task in assessment report."::: |
| 59 | + |
| 60 | + - **Use a containerization prompt**: You can input the following prompt in Copilot chat to containerize your project: |
| 61 | + |
| 62 | + *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.* |
| 63 | + |
| 64 | + :::image type="content" source="media/containerization-prompt.png" alt-text="Screenshot showing how to start the containerization process in GitHub Copilot using a prompt."::: |
| 65 | + |
| 66 | + |
| 67 | + |
| 68 | + |
| 69 | + |
| 70 | + |
| 71 | + |
0 commit comments