Getting started

Configure the local environment

Most of the work we will do will involve using the Azure Command-Line Interface (CLI). Detailed documentation on installing the Azure CLI for Windows, macOS, and Linux is available in Azure documentation. These examples will be based on macOS. Additionally, sample code, templates, and other resources are provided in a repository for this workshop. You are encouraged to clone or fork this repository as we will reference that content throughout these exercises.

Install Homebrew

If you don't already have it, install Homebrew then install the Azure CLI with the following command:

brew update && brew install azure-cli

Authenticate with the Azure CLI

Once installed, you will need to sign in to your Azure account from the CLI. Run the following command:

az login

The CLI will attempt to open your default browser and load the Azure login page. Provide your Azure account credentials in the browser and upon successful authentication you will see the following response in your browser window:

You should also see output similar to the following in your terminal:

"cloudName": "AzureCloud",
"homeTenantId": "<guid>",
"id": "<guid>",
"isDefault": true,
"state": "Enabled",
"tenantId": "<guid>",
"user": {
"name": "",
"type": "user"

If you encounter a problem, please review the Install Azure CLI on macOS documentation pages for additional guidance.