Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 60 additions & 0 deletions docs/azure/migration/appmod/deploy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
title: Deploy your project to Azure by using GitHub Copilot app modernization for .NET
description: Learn how to deploy your migrated .NET project to Azure by using GitHub Copilot app modernization for .NET.
ms.topic: quickstart
ms.custom: devx-track-dotnet
ms.date: 09/17/2025
author: JiDong
ms.author: donji
---

# Deploy your project to Azure by using GitHub Copilot app modernization for .NET

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.

## Prerequisites

- Windows operating system
- [Visual Studio 2022 version 17.14.16 or newer](https://visualstudio.microsoft.com/downloads/)
- [.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:
- GitHub Copilot
- GitHub Copilot app modernization for .NET
- GitHub account with Copilot access and a supported subscription plan:
- [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).
- Supported subscription plans: Copilot Pro, Copilot Pro+, Copilot Business, or Copilot Enterprise.
- If you change subscriptions, restart Visual Studio.

## Deploy your project

The App Modernization for .NET deployment feature helps you deploy your migrated app to Azure. Follow these steps to start the deployment process:

1. In Visual Studio, open your migrated project.

1. Start the deployment with one of the following approaches:

- **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.

:::image type="content" source="media/start-deploy.png" alt-text="Screenshot that shows how to start the deployment process in GitHub Copilot.":::

- **Use a deployment prompt**: You can enter the following prompt in Copilot chat to deploy your project to Azure:

*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.*

:::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.":::

1. After you start the deployment, GitHub Copilot might ask for your approval to use tools or run commands. Grant permission when prompted.

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.

1. You can edit the plan directly or ask GitHub Copilot to edit it to customize your deployment before you proceed.

1. When you're satisfied with the plan, instruct GitHub Copilot to continue.

1. GitHub Copilot follows the plan and runs the deployment process.

1. When deployment finishes, GitHub Copilot provides a summary of the deployment process.

## Notes

- Use Claude Sonnet 4 or later models for the best results.
- Copilot can need a few iterations to fix deployment errors.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions docs/azure/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,8 @@ items:
href: ./migration/appmod/predefined-tasks.md
- name: Quickstart - Assess and migrate a .NET project
href: ./migration/appmod/quickstart.md
- name: Quickstart - Deploy a .NET project to Azure
href: ./migration/appmod/deploy.md
- name: Sample - Contoso University
href: ./migration/appmod/sample.md
- name: Azure Migrate application and code assessment
Expand Down