Azure Provider
==============

Initial zbuilder setup
----------------------

Make sure you have installed the following on your system:

* az (Azure cli)

Main configuration
------------------

Configure the source of your templates::

  zbuilder config main templates repo=https://github.com/hasiotis/zbuilder-templates.git
  zbuilder config main templates path=~/.config/zbuilder/templates
  zbuilder config update --yes

Create azure resources needed
-----------------------------

First you need to create a resource group, a vnet (with a subnet) and the dns zone::

  az group create -l westeurope -n zbuilder

  az network vnet create -g zbuilder -n zbuilder-vnet
  az network vnet subnet create -g zbuilder --vnet-name zbuilder-vnet -n zbuilder-subnet --address-prefixes "10.0.0.0/24"

  az network dns zone create -g zbuilder -n azure.hasiotis.dev

In order to authenticate we will create a service principal::

  az ad sp create-for-rbac --name zbuilder-principal

From this command you will find out appId,password and tenant.

You will find the subscriptionId from::

  az account list | jq '.[0].id'

Provider configuration
----------------------

So you can now define *azure* as provider of type azure::

  zbuilder config provider azure type=azure
  zbuilder config provider azure client_id=<appId>
  zbuilder config provider azure client_secret=<password>
  zbuilder config provider azure tenant_id=<tenant>
  zbuilder config provider azure subscription_id=<subscriptionId>

Let zbuilder know that azure provider will also handle the *azure.hasiotis.dev* zone::

  zbuilder config provider azure.dns zones=azure.hasiotis.dev
  zbuilder config view

For this to work you need to have your dns zone managed by azure DNS.

Create your environment
-----------------------

Now create and environment from a vagrant template::

  mkdir ZBUILDER_AZURE_DEMO
  cd ZBUILDER_AZURE_DEMO
  zbuilder init --template azure
  zbuilder build

Cleanup the environment
-----------------------

To remove all VMs run::

  zbuilder destroy