Quickstart

Introduction

This guide explains how to set up the Azure emulator and interact with it using the az CLI. In this guide, you will run some basic Azure CLI commands to manage resource groups in an local Azure development environment without connecting to the real cloud services.

Prerequisites

• localstack CLI
• azlocal CLI
• LocalStack for Azure

Instructions

Before you begin, make sure that the Emulator is running - see the Installation Instructions.

Setup the authentication

To authenticate with the Azure emulator, run the following command:

$ azlocal login

You don’t need to provide real credentials because the Azure emulator doesn’t connect to the real Azure cloud.

The following output would be displayed:

[
  {
    "cloudName": "AzureCloud",
    "homeTenantId": "some-other-generated-id",
    "id": "some-generated-id",
    "isDefault": true,
    "managedByTenants": [],
    "name": "Azure subscription 1",
    "state": "Enabled",
    "tenantId": "any-tenant",
    "user": {
      "name": "any-app",
      "type": "servicePrincipal"
    }
  }
]

Create a resource group

To create a resource group, run the following command:

$ azlocal group create --name MyResourceGroup --location westeurope

The following output would be displayed:

{
  "id": "/subscriptions/some-generated-id/resourceGroups/MyResourceGroup",
  "location": "westeurope",
  "managedBy": null,
  "name": "MyResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Check & list resource groups

To check the resource group details, run the following command:

$ azlocal group show --name MyResourceGroup

To list all the resource groups, run the following command:

$ azlocal group list

Delete the resource group

To delete the resource group, run the following command:

$ azlocal group delete --name MyResourceGroup --yes

FAQ

azlocal throws an SSL error - now what?

Please delete the cached SSL certificate in $HOME/.localstack/azure, and try again.