AWS Cloud Provider
=====================

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

Make sure you have installed the following on your system:

* aws cli

Create aws resources needed (optional)
--------------------------------------

Find out our default VPC id::

  VPCID=`aws ec2 describe-vpcs | jq -r '.Vpcs[] | select(.IsDefault == true) | .VpcId'`

Make sure there is public ssh access to it::

  aws ec2 create-security-group --group-name SSHAccess --description "Security group for SSH access" --vpc-id $VPCID
  SGID=`aws ec2 describe-security-groups | jq -r '.SecurityGroups[] | select(.GroupName == "SSHAccess") | .GroupId'`
  aws ec2 authorize-security-group-ingress --group-id $SGID --protocol tcp --port 22 --cidr 0.0.0.0/0

Upload our ssh key into AWS::

  aws ec2 import-key-pair --key-name "sysadmin@zbuilder.com" --public-key-material fileb://~/.ssh/id_rsa.pub

Use these ids (security groups, subnet) for configuring *group_vars/all*::

  aws ec2 describe-subnets | jq -r ".Subnets[0] | select(.VpcId == \"$VPCID\") | .SubnetId"
  aws ec2 describe-security-groups | jq -r '.SecurityGroups[] | select(.GroupName == "default" or .GroupName == "SSHAccess") | .GroupId'

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

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

Define *amazon* as a provider of type aws::

  zbuilder config provider amazon type=aws

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

  zbuilder config provider amazon.dns zones=aws.hasiotis.dev
  zbuilder config view

For this to work you need to have your dns zone managed by aws route53

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

Now create and environment from a vagrant template::

  mkdir ZBUILDER_AWS_DEMO
  cd ZBUILDER_AWS_DEMO
  zbuilder init --template aws
  (update security groups and subnet)
  zbuilder build

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

To remove all VMs run::

  zbuilder destroy