Skip to content

quickstart.md

Latest commit

 

History

History
89 lines (62 loc) · 2.19 KB

quickstart.md

File metadata and controls

89 lines (62 loc) · 2.19 KB
title Quickstart
description Get started with LocalStack for Azure in a few simple steps.
template doc
sidebar
order
2

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

Instructions

Before you begin, make sure that the Emulator is running, see the installation instructions.

Setup the azlocal tool

To instruct the regular az CLI tool to communicate with the Azure emulator, run the following command:

$ azlocal start-interception

You may see some warnings about experimental commands, you can safely ignore these.

Create a resource group

To create a resource group, you can now the same az command as you would normally:

$ az 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:

$ az 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:

$ az group delete --name myResourceGroup --yes

Teardown

When you're done using the Azure Emulator, you can run the following command:

$ azlocal stop-interception

All invocations of the az CLI tool will now talk to the real Azure Cloud again.