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. dotnet 6.0 or a higher version - Install
  3. PowerShell 7.0 or higher version (For Windows Users only!) - Install
  4. Docker Desktop - Install
  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

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.

    md TasksTracker.ContainerApps
cd TasksTracker.ContainerApps

    mkdir ~\TasksTracker.ContainerApps
cd ~\TasksTracker.ContainerApps

  • Initialize the git repository.

    git init

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

    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.

    # Exclude build artifacts
**/obj/
**/bin/
**/dist/

  • Commit the .gitignore file.

    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.

  • Perform an initial commit of the Set-Variables.ps1 file.

    git add .\Set-Variables.ps1
git commit -m "Initialize Set-Variables.ps1"

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

    .\Set-Variables.ps1

  • Perform an initial commit of the variables file.

    git add .\Variables.ps1
git commit -m "Initialize 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.

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