Skip to content

Prerequisites

Prerequisites

The workshop is divided into separate modules. Each module will guide you through building the solution code step-by-step. Ensure that you finish the modules in the right order as they have dependencies on each other.

Make sure you have your development environment set up and configured.

  1. An Azure account with an active subscription - Create an account for free
  2. .NET SDK 8 or a higher version (we primarily focus on LTS versions) - Install
  3. PowerShell 7.0 or higher version (For Windows Users only!) - Install
  4. Docker Desktop - Install

    As of November 2024, Docker Desktop continues to be free for education purposes. Please consult the Docker Desktop license agreement for any updates.

  5. Visual Studio Code - Install
  6. VS Code Docker extension - Install
  7. Dapr CLI - Install and Initialize
  8. VS Code Dapr extension. Depends on Dapr CLI - Install
  9. Azure CLI - Install
  10. Git CLI - Install
  11. (Optional) A REST client such as Postman or Insomnia or similar.

Set up Git Repository & Variable Scripts

Git Repository

This workshop typically spans several days. As such, you may close your tools, end CLI sessions, reboot, or simply want to persist working implementations in a repository as each module builds upon the one before it. A local Git repository can help.

  • Open a command-line terminal and create a folder for your project, then switch to that folder.

    1
2
    md TasksTracker.ContainerApps
cd TasksTracker.ContainerApps

    1
2
    mkdir ~\TasksTracker.ContainerApps
cd ~\TasksTracker.ContainerApps

  • Initialize the git repository.

    1
    git init

  • Use the code command to launch Visual Studio Code from that directory as shown:

    1
    code .

  • From VS Code's Terminal tab, select New Terminal to open a (PowerShell) terminal in the project folder TasksTracker.ContainerApps.

Note

Throughout the documentation, we may refer to the TasksTracker.ContainerApps directory as root to keep documentation simpler.

  • In the root create a .gitignore file. This ensures we keep our git repo clean of build assets and other artifacts.

    1
2
3
4
    # Exclude build artifacts
**/obj/
**/bin/
**/dist/

  • Commit the .gitignore file.

    1
2
    git add .\.gitignore
git commit -m "Add .gitignore"

Set-Variables & Variables Script

  • In the root create a new file called Set-Variables.ps1.

  • Copy the Set-Variables.ps1 script into the newly-created Set-Variables.ps1 file and save it.

  • Execute the script. You will do this repeatedly throughout the modules. The output of the script will inform you how many variables are written out. As we have not yet defined any variables, the output will indicate that the script has exited (without writing out to the file). This is intentional and expected at this stage.

    1
    .\Set-Variables.ps1

  • Commit the Set-Variables.ps1 file.

    1
2
    git add .\Set-Variables.ps1
git commit -m "Add Set-Variables.ps1"

This completes the basic setup for Git and the variables to be used. You are ready to proceed to Module 1!

Jump Ahead

If you don't want to build the solution code from scratch, you can clone the source code repository final version by utilizing below command, and you can use the modules to deploy Azure resources using the provided Azure CLI commands.

1
git clone https://github.com/Azure/aca-dotnet-workshop.git