From bc2dfafca1c6071134701fb4712aa763239fb777 Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 23 Sep 2025 11:18:26 -0700 Subject: [PATCH 1/8] Updates --- .openpublishing.redirection.azure.json | 8 + docs/azure/migration/appmod/deploy.md | 10 +- docs/azure/migration/appmod/faq.md | 160 ------------------ docs/azure/migration/appmod/overview.md | 90 ---------- docs/azure/toc.yml | 4 +- ...thub-copilot-app-modernization-overview.md | 31 ++-- .../how-to-upgrade-with-github-copilot.md | 22 +-- .../github-copilot-how-to-initiate.md | 17 ++ .../includes/github-copilot-suggestion.md | 7 + .../github-copilot-app-mod-prereqs.md | 29 ++++ 10 files changed, 77 insertions(+), 301 deletions(-) delete mode 100644 docs/azure/migration/appmod/faq.md delete mode 100644 docs/azure/migration/appmod/overview.md create mode 100644 docs/core/porting/includes/github-copilot-how-to-initiate.md create mode 100644 docs/includes/github-copilot-app-mod-prereqs.md diff --git a/.openpublishing.redirection.azure.json b/.openpublishing.redirection.azure.json index d097c330c79c3..59f009f27949f 100644 --- a/.openpublishing.redirection.azure.json +++ b/.openpublishing.redirection.azure.json @@ -16,6 +16,14 @@ "source_path_from_root": "/docs/azure/dotnet-howto-migrate-vm.md", "redirect_url": "/dotnet/azure/migration/vm" }, + { + "source_path_from_root": "/docs/azure/migration/appmod/overview.md", + "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization-overview?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json" + }, + { + "source_path_from_root": "/docs/azure/migration/appmod/faq.md", + "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization-faq?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json" + }, { "source_path_from_root": "/docs/azure/dotnet-quickstart-vs.md", "redirect_url": "/visualstudio/deployment/quickstart-deploy-aspnet-web-app" diff --git a/docs/azure/migration/appmod/deploy.md b/docs/azure/migration/appmod/deploy.md index 5ee2948f9a997..8095816a4b1e4 100644 --- a/docs/azure/migration/appmod/deploy.md +++ b/docs/azure/migration/appmod/deploy.md @@ -14,15 +14,7 @@ In this quickstart, you learn how to deploy your project to Azure with GitHub Co ## 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. +[!INCLUDE[github-copilot-app-mod-prereqs](../../../includes/github-copilot-app-mod-prereqs.md)] ## Deploy your project diff --git a/docs/azure/migration/appmod/faq.md b/docs/azure/migration/appmod/faq.md deleted file mode 100644 index 3c6b5ef300864..0000000000000 --- a/docs/azure/migration/appmod/faq.md +++ /dev/null @@ -1,160 +0,0 @@ ---- -title: GitHub Copilot app modernization for .NET (Preview) FAQ -description: Discover answers to common questions about GitHub Copilot app modernization for .NET -ms.topic: concept-article -ms.custom: devx-track-dotnet -ms.date: 7/15/2025 -author: alexwolfmsft -ms.author: alexwolf ---- - -# Frequently Asked Questions for GitHub Copilot app modernization for .NET (Preview) - -This page answers common questions about [GitHub Copilot app modernization for .NET (Preview)](overview.md). - -## Which version of Visual Studio should I use? - -Upgrade to Visual Studio 2022 version 17.14.11 or later for the best experience with both GitHub Copilot and App Modernization for .NET (Preview). - -## Which model should I use in GitHub Copilot agent mode? - -Based on our benchmark, GitHub Copilot and App Modernization for .NET work best with Claude Sonnet 4.0 then Claude Sonnet 3.7. - -## What is the MCP Server, and why is there sometimes an initial delay when running a command? - -The GitHub Copilot app modernization for .NET (Preview) extension uses an MCP Server to provide Azure-related knowledge bases as tools. - -- **Automatic setup:** - On the first invocation of any App Modernization command, the extension checks for a configuration file at `%USERPROFILE%\.mcp.json`. If it's missing or the server isn't running, the extension writes the default settings and launches the MCP Server automatically. - -- **First-run delay:** - Starting and initializing the MCP Server can take anywhere from a few milliseconds up to about 20 seconds. - -- **Subsequent invocations:** - Once the MCP Server is running locally, you should not see that startup delay again. - -- **Using MCP tools in the VS Copilot Agent (outside the extension):** - You can also access the same MCP-based knowledge tools inside the built-in VS Copilot Agent. Just run **Configure MCP Server**, and the full suite of MCP tools appears under the Copilot agent's tools dropdown. - -## What should I do if configuring the MCP Server fails? - -If the MCP Server doesn't start correctly, try the following steps: - -1. Retry the **Configure MCP Server** command. -2. If it still fails, manually restart the MCP Server: - 1. Switch GitHub Copilot to **Agent** mode. - 2. Click the **Tools** icon in the pane. - 3. Expand the **appModernization** section by clicking the arrow icon next to it. - 4. Click **Restart** to relaunch the MCP Server. - -## Why is there an error in the "appModernization" group under Tools in GitHub Copilot Agent mode after uninstalling the extension, and how can I fix it? - -When the extension is installed, it adds a configuration entry to `%USERPROFILE%\.mcp.json` to register the `appModernization` tool with GitHub Copilot Agent in Visual Studio. This enables the `Tools → appModernization` group within Copilot Agent mode. -After the extension is uninstalled, this configuration remains. Since the associated command no longer exists, GitHub Copilot Agent mode displays a red error indicator next to the `appModernization` group. - -To resolve this: - -- **Edit `%USERPROFILE%\.mcp.json`** - - Open the file in a text editor and remove the `"appModernization"` entry from the `"servers"` section. - Save the file after removing this block. -- **Or delete the file entirely** - - If `.mcp.json` contains no other important configuration, you may simply delete the file. - -Once cleaned up, the error in the `Tools → appModernization` group will no longer appear. - -## How can I monitor assessment progress? - -While the assessment is running, you can monitor its progress by viewing the command-line output: - -1. In Visual Studio, go to **View** > **Output** to open the Output window. -2. In the Output window, find the **Show output from:** dropdown. -3. Select **AppModernizationExtension** from the dropdown list. -4. The command-line output from the assessment tool appears here, showing real-time progress. - -You can also access the Output window using the keyboard shortcut **Ctrl+Alt+O**. - -## What should I do if Visual Studio fails to install AppCAT? - -If you see an AppCAT installation failure in the command-line output when the extension tries to install it automatically, you can install AppCAT manually: - -1. Open a command prompt or PowerShell as Administrator. -2. Run the appropriate command based on your shell: - - **For Command Prompt:** - - ```cmd - dotnet tool install dotnet-appcat --tool-path "%LOCALAPPDATA%\Microsoft\VisualStudio\AppModernizationExtension\Tools" - ``` - - **For PowerShell:** - - ```powershell - dotnet tool install dotnet-appcat --tool-path "$env:LOCALAPPDATA\Microsoft\VisualStudio\AppModernizationExtension\Tools" - ``` - -3. After successful installation, run the assessment again. - -> [!IMPORTANT] -> Installing this tool may fail if you've configured additional NuGet feed sources. Use the `--ignore-failed-sources` parameter to treat those failures as warnings instead of errors. - -### What should I do if Visual Studio fails to upgrade AppCAT? - -If Visual Studio fails to automatically upgrade AppCAT when a new version is available, you can upgrade it manually: - -1. Open a command prompt or PowerShell as Administrator. -2. Run the appropriate command based on your shell: - - **For Command Prompt:** - - ```cmd - dotnet tool update dotnet-appcat --tool-path "%LOCALAPPDATA%\Microsoft\VisualStudio\AppModernizationExtension\Tools" - ``` - - **For PowerShell:** - - ```powershell - dotnet tool update dotnet-appcat --tool-path "$env:LOCALAPPDATA\Microsoft\VisualStudio\AppModernizationExtension\Tools" - ``` - -3. After successful upgrade, run the assessment again. - -## What should I do if I see "Command failed: No .NET SDKs were found" errors? - -This error occurs when AppCAT cannot find a compatible .NET SDK, even if you have other .NET SDKs installed. AppCAT requires the .NET 9.0 SDK to run properly. - -To fix this error: - -1. Download and install the .NET 9.0 SDK from . -2. Restart Visual Studio. -3. Run the assessment again. - -> [!NOTE] -> The GitHub Copilot app modernization for .NET extension can automatically help you install or upgrade to .NET 9. If you have an older version of the extension, update to the latest version for automatic installation assistance for the required .NET 9.0 SDK. - -## Does the tool store my source code? - -No. The tool uses GitHub Copilot in the same way you use it to modify code, and doesn't retain code snippets beyond the immediate session. Telemetry metrics are collected and analyzed to track feature usage and effectiveness. - -For more information, see the [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839). - -## What are the intended uses of GitHub Copilot app modernization for .NET (Preview)? - -GitHub Copilot app modernization for .NET (Preview) is designed to help enterprises migrate their .NET applications to Azure. It assesses application code issues that need to be addressed for migration and provides code remediation patterns that can be applied with AI. - -## How was GitHub Copilot app modernization for .NET (Preview) evaluated? What metrics are used to measure performance? - -GitHub Copilot app modernization for .NET (Preview) was evaluated through extensive manual and automated testing. Additional evaluation was performed using custom datasets for offensive and malicious prompts (user questions) and responses. The tool is also continuously evaluated with user feedback. - -## What are the limitations of GitHub Copilot app modernization for .NET (Preview)? - -GitHub Copilot app modernization for .NET (Preview) can be used on application source code written in .NET Framework or .NET Core. Applications in other languages are not supported. - -## What operational factors and settings allow for effective and responsible use of GitHub Copilot app modernization for .NET (Preview)? - -You can choose the model to make code changes at the bottom of the GitHub Copilot chat box. Different models may produce different results and have varying token consumption. For more information, see [Manage Copilot usage and models](/visualstudio/ide/copilot-usage-and-models). - -## How do I provide feedback on GitHub Copilot app modernization for .NET (Preview)? - -We value your feedback—share [your thoughts here](https://aka.ms/AM4DFeedback) to help us continue improving the product. diff --git a/docs/azure/migration/appmod/overview.md b/docs/azure/migration/appmod/overview.md deleted file mode 100644 index aa358a626dd62..0000000000000 --- a/docs/azure/migration/appmod/overview.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: Overview of GitHub Copilot app modernization for .NET (Preview) -description: Learn about essential concepts for GitHub Copilot app modernization for .NET -ms.topic: concept-article -ms.custom: devx-track-dotnet -ms.date: 7/15/2025 -author: alexwolfmsft -ms.author: alexwolf ---- - -# GitHub Copilot app modernization for .NET (Preview) overview - -[GitHub Copilot app modernization for .NET (Preview)](https://aka.ms/appmod-dotnet-marketplace) helps you migrate .NET applications to Azure quickly and confidently by guiding you through assessment, solution recommendations, code fixes, and validation - all in one tool. - -With this assistant, you can: - -- Assess your application's code, configuration, and dependencies. -- Plan and set up the right Azure resource -- Fix issues and apply best practices for cloud migration -- Validate that your app builds and tests successfully - -This process streamlines modernization and boosts developer productivity and confidence. App Modernization for .NET is an all-in-one migration assistant that uses AI to improve developer velocity, quality, and results. - -App Modernization for .NET is provided as a Visual Studio extension and relies on the following tools to be installed and configured for the full experience: - -- [A GitHub account with GitHub Copilot enabled](https://github.com/features/copilot) (Pro, Pro+, Business, or Enterprise plan required) -- [The GitHub Copilot extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) for Visual Studio (latest version recommended) -- [Azure Migrate application and code assessment for .NET](../appcat/install.md) for assessment features - -For a complete walkthrough of setting up and using GitHub Copilot app modernization for .NET, see [Quickstart: Assessing an application and applying code changes](quickstart.md). - -## Key concepts - -GitHub Copilot app modernization for .NET supports end-to-end migration to Azure, including assessment, planning, code remediation, build fixes, and unit test fixes. It uses GitHub Copilot AI capabilities to help you migrate and run your applications on Azure with confidence, accelerating the entire modernization lifecycle. - -The tool also relies on [Azure Migrate application and code assessment (AppCAT)](../appcat/app-code-assessment-toolkit.md) to analyze your code and identify modernization opportunities. You can use GitHub Copilot app modernization for .NET to get an overview of cloud readiness migration issues, including: - -- Best practice recommendations -- Suggestions for changing your application code - -When code changes are needed, the tool guides you through remediation using predefined tasks for common issues, such as: - -- Switching from password-based authentication to managed identities -- Moving from AWS S3 to Azure Blob Storage - -For more information, see [Predefined tasks](predefined-tasks.md). - -### Upgrading .NET projects - -Upgrading .NET apps is a common task that requires substantial time and resources. GitHub Copilot app modernization is an AI-based solution designed to assist with updating your .NET apps. For more information, see [GitHub Copilot app modernization](../../../core/porting/github-copilot-app-modernization-overview.md). - -## Common use cases - -App Modernization for .NET (Preview) supports the following scenarios: - -- **Assessment of modernization issue** - - Evaluates your application's readiness for Azure migration in Visual Studio, powered by [AppCAT for .NET](../appcat/install.md). - - ![Assessment](media/overview-assessment.png) - -- **Solution recommendations** - - Recommends target Azure services for your application's resource dependencies, tailored to each category of assessed issues. - - ![Solution](media/overview-solution.png) - -- **Code remediation for common issues** - - Accelerates code changes for [common modernization issues](predefined-tasks.md) by applying predefined tasks that represent expert best practices. - - ![Apply Task](media/overview-remediation.png) - -- **Automatic fixes for compilation errors:** - - Automatically discovers and fixes compilation errors introduced by code changes. - -## Feedback and privacy - -- **Feedback:** We value your feedback—share [your thoughts here](https://aka.ms/AM4DFeedback) to help us improve the product. -- **License:** This extension is licensed under the [GitHub Copilot Product Specific Terms](https://github.com/customer-terms/github-copilot-product-specific-terms). -- **Trademarks:** This project might contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos is subject to those third parties' policies. -- **Privacy:** App Modernization for .NET (Preview) uses GitHub Copilot in the same way you use it to modify code, and doesn't retain code snippets beyond the immediate session. Telemetry metrics are collected and analyzed to track feature usage and effectiveness. Review the [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839) for more information. -- **Transparency:** App Modernization for .NET (Preview) uses GitHub Copilot to make code changes, and AI might sometimes make mistakes. Carefully review and test any code changes made by the tool before using them in your production environment. - -## Next Steps - -- [Quickstart: Assessing an application and applying code changes](quickstart.md) -- [Common modernization issues with predefined tasks](predefined-tasks.md) -- [Frequently Asked Questions](faq.md) diff --git a/docs/azure/toc.yml b/docs/azure/toc.yml index cbd97e033c01d..b92abe92f9705 100644 --- a/docs/azure/toc.yml +++ b/docs/azure/toc.yml @@ -27,9 +27,9 @@ items: - name: GitHub Copilot app modernization for .NET items: - name: Overview - href: ../core/porting/github-copilot-app-modernization-overview.md + href: ../core/porting/github-copilot-app-modernization-overview.md?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json - name: FAQ - href: ../core/porting/github-copilot-app-modernization-faq.yml + href: ../core/porting/github-copilot-app-modernization-faq.yml?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json - name: Predefined Tasks href: ./migration/appmod/predefined-tasks.md - name: Quickstart - Assess and migrate a .NET project diff --git a/docs/core/porting/github-copilot-app-modernization-overview.md b/docs/core/porting/github-copilot-app-modernization-overview.md index 53082daab9250..8d1627a5ffb48 100644 --- a/docs/core/porting/github-copilot-app-modernization-overview.md +++ b/docs/core/porting/github-copilot-app-modernization-overview.md @@ -5,13 +5,13 @@ titleSuffix: "" author: adegeo ms.author: adegeo ms.topic: overview -ms.date: 09/15/2025 +ms.date: 09/23/2025 -#customer intent: As a developer, I want to upgrade my project or migrate the project to Azure so that I can take advantage of the latest features. +#customer intent: As a developer, I want to learn about what the GitHub Copilot app modernziation is, so that I understand its capabilities and how I can take advantage of it. --- -# GitHub Copilot app modernization +# What is GitHub Copilot app modernization? GitHub Copilot app modernization is a GitHub Copilot agent that helps upgrade projects to newer versions of .NET and migrate .NET applications to Azure quickly and confidently by guiding you through assessment, solution recommendations, code fixes, and validation - all within Visual Studio. @@ -27,33 +27,24 @@ With this assistant, you can: - Fix issues and apply best practices for cloud migration. - Validate that your app builds and tests successfully. +> [!IMPORTANT] +> Starting with Visual Studio 2022 17.14.16, the GitHub Copilot Modernization agent is included with Visual Studio. If you're using an older version of Visual Studio 2022, upgrade to the latest release. + ## Provide feedback Feedback is important to Microsoft and the efficiency of this agent. Use the [Suggest a feature](/visualstudio/ide/suggest-a-feature) and [Report a problem](/visualstudio/ide/report-a-problem) features of Visual Studio to provide feedback. ## Prerequisites -- Windows Operating System -- [Visual Studio 2022 version 17.14.16 or newer](https://visualstudio.microsoft.com/downloads/). (To be released) -- [.NET desktop development workload](/visualstudio/install/modify-visual-studio?view=vs-2022&preserve-view=true#change-workloads-or-individual-components) with the following optional components enabled: - - - GitHub Copilot - - GitHub Copilot app modernization for .NET - -- Copilot license and 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). +The following items are required before you can use GitHub Copilot app modernization: - Supported subscription plans: +[!INCLUDE[github-copilot-app-mod-prereqs](../../includes/github-copilot-app-mod-prereqs.md)] - - Copilot Pro - - Copilot Pro+ - - Copilot Business - - Copilot Enterprise +## How to start an upgrade or migration - (If you change subscriptions, you must restart Visual Studio.) +To start an upgrade or migration, interact with GitHub Copilot, following these steps: -- Code must be written in C#. +[!INCLUDE[github-copilot-how-to-initiate](./includes/github-copilot-how-to-initiate.md)] ## Upgrade .NET projects diff --git a/docs/core/porting/how-to-upgrade-with-github-copilot.md b/docs/core/porting/how-to-upgrade-with-github-copilot.md index bf9d77776124e..6689a5a1f8712 100644 --- a/docs/core/porting/how-to-upgrade-with-github-copilot.md +++ b/docs/core/porting/how-to-upgrade-with-github-copilot.md @@ -21,31 +21,13 @@ The modernization agent analyzes your projects and dependencies, creates an upgr Before you begin, ensure you have the following requirements: -- Windows Operating System -- [Visual Studio 2022 version 17.14.16 or newer](https://visualstudio.microsoft.com/downloads/) (To be released) -- [.NET desktop development workload](/visualstudio/install/modify-visual-studio?view=vs-2022&preserve-view=true#change-workloads-or-individual-components) with the following optional components enabled: - - GitHub Copilot - - GitHub Copilot app modernization for .NET -- GitHub account with Copilot access and 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, you must restart Visual Studio -- A .NET project written in C# that you want to upgrade +[!INCLUDE[github-copilot-app-mod-prereqs](../../includes/github-copilot-app-mod-prereqs.md)] ## Start the upgrade process The first step to upgrading is generating a plan by interacting with GitHub Copilot. Follow these steps to initiate the upgrade: -1. Open your .NET project or solution in Visual Studio. -1. Access the GitHub Copilot app modernization agent using one of these methods: - - Right-click on the solution or project in **Solution Explorer** and select **Modernize**. - - —or— - - Open the **GitHub Copilot Chat** window and type `@modernize` followed by your upgrade request. - -1. Tell the `@modernize` agent what you want to upgrade. +[!INCLUDE[github-copilot-how-to-initiate](./includes/github-copilot-how-to-initiate.md)] ## Generate an upgrade plan diff --git a/docs/core/porting/includes/github-copilot-how-to-initiate.md b/docs/core/porting/includes/github-copilot-how-to-initiate.md new file mode 100644 index 0000000000000..128a593a792ea --- /dev/null +++ b/docs/core/porting/includes/github-copilot-how-to-initiate.md @@ -0,0 +1,17 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 09/23/2025 +ms.topic: include +--- + +1. Open your .NET project or solution in Visual Studio. +1. Access the GitHub Copilot app modernization agent using one of these methods: + + Right-click on the solution or project in **Solution Explorer** and select **Modernize**. + + —or— + + Open the **GitHub Copilot Chat** window and type `@modernize` followed by your upgrade or migration request. + +1. Tell the `@modernize` agent what you want to upgrade or migrate. diff --git a/docs/core/porting/includes/github-copilot-suggestion.md b/docs/core/porting/includes/github-copilot-suggestion.md index 84484c3bbec7c..80440322bdcbb 100644 --- a/docs/core/porting/includes/github-copilot-suggestion.md +++ b/docs/core/porting/includes/github-copilot-suggestion.md @@ -1,2 +1,9 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 09/23/2025 +ms.topic: include +--- + > [!IMPORTANT] > Try the [GitHub Copilot app modernization chat agent](../github-copilot-app-modernization-overview.md). This agent analyzes your projects and dependencies, produces a step-by-step migration plan with targeted recommendations and automated code fixes, and commits each change so you can validate or roll back. It automates common porting tasks—updating project files, replacing deprecated APIs, and resolving build issues—so you can modernize faster with less manual effort. For more information, see [What is GitHub Copilot app modernization](../github-copilot-app-modernization-overview.md). diff --git a/docs/includes/github-copilot-app-mod-prereqs.md b/docs/includes/github-copilot-app-mod-prereqs.md new file mode 100644 index 0000000000000..9e0ccb631f9df --- /dev/null +++ b/docs/includes/github-copilot-app-mod-prereqs.md @@ -0,0 +1,29 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 09/23/2025 +ms.topic: include +# Shared by Azure.NET app mod and .NET app mod +--- + +- 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 the following optional components enabled: + + - GitHub Copilot + - GitHub Copilot app modernization for .NET + +- Copilot license and 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 + - Copilot Enterprise + + (If you change subscriptions, you must restart Visual Studio.) + +- Code must be written in C#. From 575118970d3074c581a717cf6c8d8260e4b7697a Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 23 Sep 2025 11:23:35 -0700 Subject: [PATCH 2/8] Redirect old install article --- .openpublishing.redirection.core.json | 4 ++ ...ithub-copilot-app-modernization-install.md | 71 ------------------- 2 files changed, 4 insertions(+), 71 deletions(-) delete mode 100644 docs/core/porting/github-copilot-app-modernization-install.md diff --git a/.openpublishing.redirection.core.json b/.openpublishing.redirection.core.json index 7297db8b7c105..196fae9c5b7db 100644 --- a/.openpublishing.redirection.core.json +++ b/.openpublishing.redirection.core.json @@ -926,6 +926,10 @@ "redirect_url": "/dotnet/core/deploying/index", "redirect_document_id": true }, + { + "source_path_from_root": "/docs/core/deploying/github-copilot-app-modernization-install.md", + "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization-overview" + }, { "source_path_from_root": "/docs/core/preview3/tools/csproj.md", "redirect_url": "/dotnet/core/project-sdk/msbuild-props", diff --git a/docs/core/porting/github-copilot-app-modernization-install.md b/docs/core/porting/github-copilot-app-modernization-install.md deleted file mode 100644 index e919c6e8633c3..0000000000000 --- a/docs/core/porting/github-copilot-app-modernization-install.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Install GitHub Copilot app modernization -description: "Learn how to install the GitHub Copilot app modernization Visual Studio extension. App modernization assists you when upgrading projects to the latest dependencies or when upgrading to a new version of .NET" -titleSuffix: "" -author: adegeo -ms.author: adegeo -ms.topic: install-set-up-deploy -ms.date: 09/15/2025 - -#customer intent: As a developer, I want to install GitHub Copilot App Modernization so that I can upgrade my projects. - ---- - -# Install GitHub Copilot app modernization - -This article guides you through installing the GitHub Copilot app modernization extension in Visual Studio. - -> [!IMPORTANT] -> The GitHub Copilot Modernization agent is included in Visual Studio, starting with Visual Studio 2022 17.14.16 and Visual Studio 2026. - -## Prerequisites - -- Windows operating system -- [Visual Studio 2022 version 17.14.15 or earlier](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) - -While not required to _install_ the extension, to use the extension you must [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 GitHub Copilot subscription plans are: - -- Copilot Pro -- Copilot Pro+ -- Copilot Business -- Copilot Enterprise - -(If you change subscriptions, you must restart Visual Studio.) - -## Visual Studio extension - -The following steps install the Visual Studio extension. - -> [!TIP] -> As an alternative to using the **Manage Extensions** feature of Visual Studio, you can download and run the extensions installer from the [Visual Studio Marketplace](https://aka.ms/ghcp-appmod/dotnet-upgrade-vsix). - -01. Open Visual Studio. - - If the **Open Recent \ Get Started** window opens, select the **Continue without code** link. - -01. Select the **Extensions** > **Manage Extensions** menu to open **Extension Manager**. -01. Select the **Browse** tab. -01. Enter `GitHub Copilot app modernization` into the search box. -01. Select **GitHub Copilot app modernization**, and then select **Install**. - - :::image type="content" source="media/github-copilot-app-modernization-install/visual-studio-manage-extensions.png" alt-text="The manage extensions window in Visual Studio, showing GitHub Copilot app modernization."::: - -01. Once the extension finishes downloading, close Visual Studio to automatically start the installation. - - :::image type="content" source="media/github-copilot-app-modernization-install/install-prompt.png" alt-text="A prompt to install the GitHub Copilot App Modernization extension."::: - -01. Select **Modify** and follow the instructions to install the extension. - -## Validation - -There are two ways to determine if GitHub Copilot App Modernization is installed as a Visual Studio extension: - -- The quickest way is to right-click on any .NET or .NET Framework project in **Solution Explorer** and check for an **Upgrade with GitHub Copilot** menu item. -- Another way is to select the **Extensions** > **Manage Extensions** menu to open the **Extension Manager** window. Then, select the **Installed** tab and find it in the list of installed extensions. - -## Related content - -- [What is GitHub Copilot app modernization?](github-copilot-app-modernization-overview.md) From 8e1364fa088a467a34228277374df08e80ad49bd Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 23 Sep 2025 11:26:54 -0700 Subject: [PATCH 3/8] Add prereqs to the other appmod --- docs/azure/migration/appmod/containerization.md | 10 +--------- docs/azure/migration/appmod/quickstart.md | 10 +--------- 2 files changed, 2 insertions(+), 18 deletions(-) diff --git a/docs/azure/migration/appmod/containerization.md b/docs/azure/migration/appmod/containerization.md index e6dcefcc6a0b7..6ae086ad208d6 100644 --- a/docs/azure/migration/appmod/containerization.md +++ b/docs/azure/migration/appmod/containerization.md @@ -22,15 +22,7 @@ In this quickstart, you learn how to containerize your project using GitHub Copi Before you begin, make sure you have: -- 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. +[!INCLUDE[github-copilot-app-mod-prereqs](../../../includes/github-copilot-app-mod-prereqs.md)] ## Containerize your project diff --git a/docs/azure/migration/appmod/quickstart.md b/docs/azure/migration/appmod/quickstart.md index fae8a35d304ba..07bd901da6117 100644 --- a/docs/azure/migration/appmod/quickstart.md +++ b/docs/azure/migration/appmod/quickstart.md @@ -19,15 +19,7 @@ In this quickstart, you assess and migrate a .NET project by using GitHub Copilo ## 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. +[!INCLUDE[github-copilot-app-mod-prereqs](../../../includes/github-copilot-app-mod-prereqs.md)] ## Assess app readiness From 3990178380b2af1814f5eac6cd44f401d800c5cf Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 23 Sep 2025 11:29:11 -0700 Subject: [PATCH 4/8] Fix build errs --- .openpublishing.redirection.core.json | 2 +- docs/azure/migration/appmod/quickstart.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.openpublishing.redirection.core.json b/.openpublishing.redirection.core.json index 196fae9c5b7db..6533ed21ccc4f 100644 --- a/.openpublishing.redirection.core.json +++ b/.openpublishing.redirection.core.json @@ -927,7 +927,7 @@ "redirect_document_id": true }, { - "source_path_from_root": "/docs/core/deploying/github-copilot-app-modernization-install.md", + "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization-install.md", "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization-overview" }, { diff --git a/docs/azure/migration/appmod/quickstart.md b/docs/azure/migration/appmod/quickstart.md index 07bd901da6117..1f8707728439d 100644 --- a/docs/azure/migration/appmod/quickstart.md +++ b/docs/azure/migration/appmod/quickstart.md @@ -108,4 +108,4 @@ You can choose one of the predefined options and send it in the chat: ## Next Steps - [Predefined Tasks](predefined-tasks.md) -- [Frequently Asked Questions](faq.md) +- [Frequently Asked Questions](../../../core/porting/github-copilot-app-modernization-faq.yml) From c40efab44848ea7546d74c06f2eff1121724624a Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 23 Sep 2025 13:26:02 -0700 Subject: [PATCH 5/8] Clarify asp.net (core) --- docs/core/porting/github-copilot-app-modernization-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/porting/github-copilot-app-modernization-overview.md b/docs/core/porting/github-copilot-app-modernization-overview.md index 8d1627a5ffb48..3c8d4fdbcdfca 100644 --- a/docs/core/porting/github-copilot-app-modernization-overview.md +++ b/docs/core/porting/github-copilot-app-modernization-overview.md @@ -50,7 +50,7 @@ To start an upgrade or migration, interact with GitHub Copilot, following these The modernization agent supports upgrading projects coded in C#. The following types of projects are supported: -- ASP.NET and related technologies such as MVC, Razor Pages, Web API +- ASP.NET and ASP.NET Core (including related technologies such as MVC, Razor Pages, and Web API) - Blazor - Azure Functions - Windows Presentation Foundation From 6ecfef9793747567d06868c0cd107cf4f5dcbb76 Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 23 Sep 2025 13:44:46 -0700 Subject: [PATCH 6/8] Update wording around uninstall --- .../core/porting/github-copilot-app-modernization-overview.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/core/porting/github-copilot-app-modernization-overview.md b/docs/core/porting/github-copilot-app-modernization-overview.md index 3c8d4fdbcdfca..4a880afe98198 100644 --- a/docs/core/porting/github-copilot-app-modernization-overview.md +++ b/docs/core/porting/github-copilot-app-modernization-overview.md @@ -28,7 +28,9 @@ With this assistant, you can: - Validate that your app builds and tests successfully. > [!IMPORTANT] -> Starting with Visual Studio 2022 17.14.16, the GitHub Copilot Modernization agent is included with Visual Studio. If you're using an older version of Visual Studio 2022, upgrade to the latest release. +> Starting with Visual Studio 2022 17.14.16, the GitHub Copilot app modernization agent is included with Visual Studio. If you're using an older version of Visual Studio 2022, upgrade to the latest release. +> +> If you previously installed the GitHub Copilot app modernization for .NET Visual Studio extension, uninstall it before using the version now included in Visual Studio. ## Provide feedback From 8e38dc70edd2a5d70cd365f57db1960d98f0be7b Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 23 Sep 2025 13:55:07 -0700 Subject: [PATCH 7/8] Feedback --- .../porting/github-copilot-app-modernization-overview.md | 6 +++++- docs/includes/github-copilot-app-mod-prereqs.md | 3 ++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization-overview.md b/docs/core/porting/github-copilot-app-modernization-overview.md index 4a880afe98198..a0ff1a98d2005 100644 --- a/docs/core/porting/github-copilot-app-modernization-overview.md +++ b/docs/core/porting/github-copilot-app-modernization-overview.md @@ -30,7 +30,11 @@ With this assistant, you can: > [!IMPORTANT] > Starting with Visual Studio 2022 17.14.16, the GitHub Copilot app modernization agent is included with Visual Studio. If you're using an older version of Visual Studio 2022, upgrade to the latest release. > -> If you previously installed the GitHub Copilot app modernization for .NET Visual Studio extension, uninstall it before using the version now included in Visual Studio. +> If you installed any of the previously released upgrade extensions published by Microsoft, uninstall them before using the version now included in Visual Studio. +> +> - .NET Upgrade Assistant +> - GitHub Copilot App Modernization – Upgrade for .NET +> - Azure Migrate Application and Code Assessment for .NET ## Provide feedback diff --git a/docs/includes/github-copilot-app-mod-prereqs.md b/docs/includes/github-copilot-app-mod-prereqs.md index 9e0ccb631f9df..c8d3832c08cc4 100644 --- a/docs/includes/github-copilot-app-mod-prereqs.md +++ b/docs/includes/github-copilot-app-mod-prereqs.md @@ -24,6 +24,7 @@ ms.topic: include - Copilot Business - Copilot Enterprise - (If you change subscriptions, you must restart Visual Studio.) + > [!IMPORTANT] + > If you change subscriptions, you must restart Visual Studio. - Code must be written in C#. From 64831965ad96062b1b6eaba9db16754c25dcdd3b Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 23 Sep 2025 13:55:45 -0700 Subject: [PATCH 8/8] Minor alter --- docs/core/porting/github-copilot-app-modernization-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/porting/github-copilot-app-modernization-overview.md b/docs/core/porting/github-copilot-app-modernization-overview.md index a0ff1a98d2005..5b0c55c67f2cd 100644 --- a/docs/core/porting/github-copilot-app-modernization-overview.md +++ b/docs/core/porting/github-copilot-app-modernization-overview.md @@ -30,7 +30,7 @@ With this assistant, you can: > [!IMPORTANT] > Starting with Visual Studio 2022 17.14.16, the GitHub Copilot app modernization agent is included with Visual Studio. If you're using an older version of Visual Studio 2022, upgrade to the latest release. > -> If you installed any of the previously released upgrade extensions published by Microsoft, uninstall them before using the version now included in Visual Studio. +> If you installed any of the following extensions published by Microsoft, uninstall them before using the version now included in Visual Studio: > > - .NET Upgrade Assistant > - GitHub Copilot App Modernization – Upgrade for .NET