1-setup.md

Machine Setup

This workshop will be using the following tools:

• .NET 9 SDK
• OR .NET 8 SDK with .NET Aspire Workload
• Docker Desktop or Podman
• Visual Studio 2022 or Visual Studio Code with C# Dev Kit

For the best experience, we recommend using Visual Studio 2022 with the .NET Aspire workload. However, you can use Visual Studio Code with the C# Dev Kit and .NET Aspire workload. Below are setup guides for each platform.

Windows with Visual Studio

• Install Visual Studio 2022 version 17.12 or newer.
  • Any edition will work including the free to use Visual Studio Community
  • Select the following ASP.NET and web development workload.

Note: .NET Aspire 8.0 required installing a separate .NET Aspire workload. In .NET 9, this workload is no longer required and can be uninstalled.

Mac, Linux, & Windows without Visual Studio

• Install the latest .NET 9 SDK

• Install Visual Studio Code with C# Dev Kit

Note: When running on Mac with Apple Silicon (M series processor), Rosetta 2 for grpc-tools.

Test Installation

To test your installation, see the Build your first .NET Aspire project for more information.

Open Workshop Start Solution

To start the workshop open start-with-api/MyWeatherHub.sln in Visual Studio 2022. If you are using Visual Studio code open the start-with-api folder and when prompted by the C# Dev Kit which solution to open, select MyWeatherHub.sln.

Next: Module #2 - Service Defaults