Task 02 - Install prerequisite software

Introduction

If you are using a GitHub Codespace, the development environment is already pre-configured and you can skip this task. If you are working on your local machine, you will need to install the necessary software to complete the workshop exercises.

Description

In this task, you will install the minimum software requirements on your local machine. There are also optional tools for the full workshop experience.

Success Criteria

You have installed all minimum required software.
(Optional) You have installed Docker Desktop or Rancher for the full experience.

Learning Resources

Key Tasks

01: Install the Microsoft Authenticator app

You will need the Microsoft Authenticator app on your mobile phone for multi-factor authentication when signing into Azure.

Expand this section to view the solution

Download and install Microsoft Authenticator from your mobile device’s app store:

02: Install Azure CLI and Azure Developer CLI (azd)

The Azure CLI is used for managing Azure resources, and the Azure Developer CLI (azd) simplifies the development workflow for Azure applications.

Expand this section to view the solution

Install Azure CLI:

On Windows, download and run the MSI installer from the Azure CLI installation page. Alternatively, you can install it via winget:

winget install -e --id Microsoft.AzureCLI

On macOS:

brew update && brew install azure-cli

On Linux:

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Install Azure Developer CLI (azd):

On Windows:

winget install microsoft.azd

On macOS:

brew tap azure/azd && brew install azd

On Linux:

curl -fsSL https://aka.ms/install-azd.sh | bash

03: Install Node.js

Node.js v20 or later is required. Version 22 (LTS) is recommended.

Expand this section to view the solution

Download and install Node.js from the official downloads page. Select the LTS version (v22 recommended).

Alternatively, use a package manager:

On Windows:

winget install OpenJS.NodeJS.LTS

On macOS:

brew install node@22

On Linux (via NodeSource):

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

Verify the installation:

node --version

You should see a version number of v20.x.x or later.

04: Install Python

Python 3.12 or later is required. Version 3.14 is recommended.

Expand this section to view the solution

Download and install Python from the official downloads page. Make sure to check the Add Python to PATH option during installation on Windows.

On Windows:

winget install -e --id Python.Python.3.14

On macOS:

brew install python@3.14

On Linux:

sudo apt-get update
sudo apt-get install -y python3 python3-pip python3-venv

Verify the installation:

python --version

You should see a version number of 3.12.x or later.

05: Install Visual Studio Code and extensions

Visual Studio Code is the recommended editor for this workshop. You will also need several extensions for Azure development.

Expand this section to view the solution

Download and install Visual Studio Code from the official downloads page.

After installation, open VS Code and install the following extensions from the Extensions Marketplace (Ctrl+Shift+X):

AI Foundry (TeamsDevApp.vscode-ai-foundry)
Azure Storage (ms-azuretools.vscode-azurestorage)
Bicep (ms-azuretools.vscode-bicep)
Azure MCP Server (ms-azuretools.vscode-azure-mcp-server)
Azure Resource Groups (ms-azuretools.vscode-azureresourcegroups)
Python (ms-python.python)

You can also install these extensions from the command line:

code --install-extension TeamsDevApp.vscode-ai-foundry
code --install-extension ms-azuretools.vscode-azurestorage
code --install-extension ms-azuretools.vscode-bicep
code --install-extension ms-azuretools.vscode-azure-mcp-server
code --install-extension ms-azuretools.vscode-azureresourcegroups
code --install-extension ms-python.python

06: (Optional) Install Docker Desktop or Rancher

Docker Desktop or Rancher Desktop is optional but recommended for the full workshop experience, particularly for containerization and CI/CD exercises.

Expand this section to view the solution

Docker Desktop:

Download and install Docker Desktop from the official website.

On Windows:

winget install -e --id Docker.DockerDesktop

On macOS:

brew install --cask docker

Rancher Desktop (alternative):

Download and install Rancher Desktop from the official website.

On Windows:

winget install -e --id suse.RancherDesktop

After installation, start Docker Desktop or Rancher Desktop and ensure that the Docker engine is running.

Verify the installation:

docker --version

07: (Optional) Create a personal GitHub account

A personal GitHub account is needed for the CI/CD portion of the workshop. If you already have one, you can skip this step.

Expand this section to view the solution

Navigate to GitHub and select Sign up. Follow the prompts to create a free personal account.

You will need a personal GitHub account (not an enterprise managed account) to fork the repository and configure GitHub Actions workflows.