Get ready for a game-changer with the Azure Migrate application and code assessment tool for .NET, affectionately known as AppCAT! This powerhouse tool takes your .NET source code, configurations, and binaries on a thrilling journey, uncovering potential opportunities and addressing any hiccups that might pop up during your app's migration to the Azure cloud.
AppCAT
AppCAT isn't just about migration; it's your trusty sidekick in enhancing performance, scalability, and security. Picture it as your app's superhero, swooping in to suggest cutting-edge, cloud-native solutions that will not only solve existing issues but also catapult your application to new heights! Embrace the excitement of seamless Azure migration and elevate your app's potential with AppCAT!
![APPCAT]()
Ready for the magic after running the analysis? Brace yourself for a comprehensive report that's your golden ticket to a seamless transition from on-premises to the dazzling world of Azure!
AppCAT, the ultimate detective of application compatibility, employs static code analysis to unearth every nook and cranny of your code and its dependencies. But here's the kicker: it doesn't just stop at highlighting potential hiccups. This superhero tool takes you straight to the lines that need your superhero's attention. With the ability to mark issues as fixed, save progress, and collaborate effortlessly with your team, AppCAT ensures that you're always in control of the migration superhero saga!
But that's not all! Dive deep into the nitty-gritty with precise estimates of the effort needed to fix each issue, unravel the mysteries of your app components and projects, and get detailed, step-by-step guidance on issue resolution. Plus, AppCAT conveniently links you directly to the treasure trove of Microsoft documentation.
![Azure Compatibility Report]()
Ready for the grand reveal? AppCAT comes in not one, but two exciting 'flavours' – as a Visual Studio extension and a .NET CLI tool. Your journey to Azure migration has never been this thrilling!
Install Visual Studio extension
Prerequisites
- Windows operating system
- Visual Studio 2022 version 17.1 or later
Installation steps
Embarking on the journey to harness the power of Azure Migrate within Visual Studio? Buckle up for a hassle-free installation ride! Here are two routes to bring this magic into your world:
Option 1. Install from Visual Studio
- Open Visual Studio and navigate to Extensions > Manage Extensions. Witness the gateway to a world of possibilities as the Manage Extensions window unfolds.
![Extensions]()
- In this window, type "Azure Migrate" into the search box, igniting the spark of transformation. Behold as the Azure Migrate application and code assessment for .NET VSIX emerges.
![Azure migration application]()
- Select the magical item itself - the Azure Migrate application and code assessment. Feel the excitement building up? Now, hit that Download button.
- As the extension graces your system, bid Visual Studio farewell for a moment. This marks the beginning of a beautiful partnership.
- In the VSIX Installer dialog that appears, choose Modify and let the installation unfold. Follow the prompts to seamlessly integrate the extension into your Visual Studio realm.
Option 2. Visual Studio Marketplace Adventure
- Alternatively, for a different flavor of installation, venture into the Visual Studio Marketplace.
- Search for "Azure Migrate" and embrace the array of options presented. Your desired gem, the Azure Migrate application and code assessment, will shine bright.
- With a click, initiate the Download and let the extension find its home on your system.
- Once downloaded, revel in the simplicity of installation by following the prompts.
And there you have it! Azure Migrate is now part of your Visual Studio toolkit, ready to elevate your coding experience.
Install the CLI tool
Ready to supercharge your coding experience with the Azure Migrate application and code assessment tool through the command line? Buckle up and follow these swift and easy steps!
Step 1. Install the Tool
In your CLI, unleash the power with this command.
dotnet tool install -g dotnet-appcat
Watch as the magic unfolds and the tool seamlessly integrates into your environment.
Step 2. Update for Peak Performance
Stay on the cutting edge by updating the tool with this sleek command.
dotnet tool update -g dotnet-appcat
Now, you're armed with the latest and greatest features to elevate your coding game.
Note. Handle NuGet Feed Challenges Like a Pro.
Encountering hiccups due to additional NuGet feed sources? Fear not! Use this command with the --ignore-failed-sources parameter.
dotnet tool install -g --ignore-failed-sources dotnet-appcat
Consider those challenges mere warnings, not roadblocks on your journey to coding greatness.
Get ready to conquer the coding cosmos with Azure Migrate – your command line companion for a seamless experience.
Analyze applications with .NET CLI
Step 1. Launch the Magic
After installing the Visual Studio extension, your gateway to analysis awaits. Simply right-click on any project or solution in the Solution Explorer window, and witness the magic unfold as you select 'Re-platform to Azure.'
![]()
Step 2. Embrace the AppCAT Interface
Behold the tool's window, offering you the choice to create a new report or open an existing one.
![]()
Step 3. Craft Your Report
- Creating a New Report: Choose the projects in your solution you want to analyze. Web projects get a head start, but you're in control—tweak the selection as needed. The tool doesn't stop there; it dives into analyzing dependencies your chosen projects rely on.
![]()
- Fine-tune Your Analysis: Decide whether you want to analyze just your source code and settings or explore all binary dependencies your code embraces.
![]()
Step 4. Unleash the Analysis
With a triumphant click on the 'Analyze' button, watch as the tool works its magic. Once the analysis is complete, brace yourself for a visual feast—results displayed in a dashboard format that can be saved in various formats (HTML, CSV, and JSON).
Analyze applications with .NET CLI
Ready to take the reins and analyze your application like a coding maestro through the mighty CLI tool? Let's dive into the command-line adventure!
Step 1. Unleash the Power
With the CLI tool securely installed, your journey begins. In your command-line interface, type the following command to kickstart the analysis.
appcat analyze <APPLICATION_PATH>
Step 2. Craft Your Report
But wait, there's more! Tailor the report file to your liking by specifying a path and format.
appcat analyze <APPLICATION_PATH> --report MyAppReport --serializer html
Choose your own adventure with formats like .html, .json, or .csv to make the report uniquely yours. Your application, your rules!
Ready to see the magic unfold? Hit enter and watch as the CLI tool weaves its analysis wizardry. Your comprehensive report is just a command away.
Interpret results
Step 1. Behold the AppCAT Report
Take a moment to appreciate the HTML report – a visual spectacle reminiscent of the dashboard you'd encounter in Visual Studio after a spellbinding analysis.
![]()
Step 2. Dive into the Details
What awaits you in this report? Brace yourself for an information-rich journey:
- Insights into the number of projects analyzed.
- A comprehensive breakdown of issues and incidents.
- An evaluation of the effort required to fix each incident, issue, and project.
![]()
Step 3. Navigate the AppCAT Universe
Embark on a journey through different views.
- Aggregated Issues View: A panoramic overview of grouped incidents, categorized by severity.
- Get Help and Dive Into Code: Access detailed information on incidents, learn how to fix them, and seamlessly jump to your code.
Step 4. Unleash Your Coding Prowess
Ready to interpret and conquer? Dive into the 'Interpret the Results' guide for an in-depth understanding of the different report components and how to harness the insights for coding greatness.
Conclusion
Embarking on the journey of Azure migration is not just a task; it's a thrilling adventure made possible by the powerful Azure Migrate application and code assessment tool, affectionately known as AppCAT. From seamless installations in Visual Studio and the CLI to conducting thorough analyses, this tool is your trusty sidekick in the quest for optimized, cloud-native applications.
Whether you choose the Visual Studio extension or the command-line interface, AppCAT doesn't just analyze – it empowers you to elevate your coding game. The reports, available in HTML, CSV, and JSON formats, showcase a visual spectacle akin to a dashboard, providing insights into project numbers, issues, and efforts needed for fixes.
As you navigate the AppCAT universe through different views, from aggregated issues to detailed code exploration, you're equipped to conquer any coding challenge that comes your way. The journey doesn't end with the analysis; it's a continuous quest for improvement and excellence.
Azure Migrate and AppCAT are not just tools; they're enablers of innovation, efficiency, and coding mastery. Dive into the 'Interpret the Results' guide for an in-depth understanding, and let the optimization journey begin. Happy coding, and welcome to the future of Azure-powered applications!
Reference