Skip to content

Commit e02f74e

Browse files
authored
Ji/appmod dotnet containerization (#48564)
*App mod containerization flow
1 parent 3d79606 commit e02f74e

File tree

4 files changed

+66
-0
lines changed

4 files changed

+66
-0
lines changed
Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
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.
19.8 KB
Loading
31.4 KB
Loading

docs/azure/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,8 @@ items:
3333
- name: Predefined Tasks
3434
href: ./migration/appmod/predefined-tasks.md
3535
- name: Quickstart - Assess and migrate a .NET project
36+
href: ./migration/appmod/containerization.md
37+
- name: Quickstart - Containerize a .NET project
3638
href: ./migration/appmod/quickstart.md
3739
- name: Quickstart - Deploy a .NET project to Azure
3840
href: ./migration/appmod/deploy.md

0 commit comments

Comments
 (0)