Skip to content

Commit 3d79606

Browse files
authored
App Mod .NET deploy doc. (#48226)
* New App Mod deployment workflow
1 parent e2202af commit 3d79606

File tree

4 files changed

+62
-0
lines changed

4 files changed

+62
-0
lines changed
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
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.
133 KB
Loading
57.9 KB
Loading

docs/azure/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,8 @@ items:
3434
href: ./migration/appmod/predefined-tasks.md
3535
- name: Quickstart - Assess and migrate a .NET project
3636
href: ./migration/appmod/quickstart.md
37+
- name: Quickstart - Deploy a .NET project to Azure
38+
href: ./migration/appmod/deploy.md
3739
- name: Sample - Contoso University
3840
href: ./migration/appmod/sample.md
3941
- name: Azure Migrate application and code assessment

0 commit comments

Comments
 (0)