This is a roles for provisioning clouds nodes/vpcs/vnets. It takes a model and creates that architecture in the cloud provider specified by that blueprint.
These playbooks assume that you have your cloud environment setup correctly for authentication. For example, boto is required for AWS.
cloud_model
: The cloud model that you want to deploy into the specified cloud provider (required)cloud_project
: The name of the overall project. (DEFAULT: username)cloud_instance
: The specific instance of the overall project. (DEFAULT:cloud_model
)cloud_provider
: The cloud provider in which to deploy the model. (DEFAULT: aws)cloud_region
: The region of the cloud provider in which to deploy the model (DEFAULT: us-east-1)cloud_cidr
: The private subnet for the deployment in CIDR notation.cloud_site_number
: The site number (DEFAULT: 0)cloud_key_name
: The name of the key used/created (DEFAULT: username)cloud_public_key_file
: The name of the file containing the public keycloud_inventory_root
: The root where the inventories will be created (DEFAULT:./inventory
)cloud_inventory_dir
: The directory where the inventory files will be created (DEFAULT:cloud_inventory_root
/cloud_project
)cloud_inventory_file
: The name of the inventory file (DEFAULT:cloud_inventory_dir
/cloud_instance
)
None.
- hosts: localhost
connection: local
gather_facts: no
tasks:
- assert:
that:
- cloud_model is defined
msg: "You must specify a model, e.g. -e 'cloud_model=csr-spoke1.yml'"
- include_role:
name: cloudbuilder
tasks_from: build
tags:
- build
- include_role:
name: cloudbuilder
tasks_from: facts
tags:
- facts
- debug: var=hostvars
- include_role:
name: cloudbuilder
tasks_from: inventory
tags:
- inventory
## Cloud Models
The cloud model is a cloud-agnostic data model that describes the particlar cloud deployment. It creates the container network (e.g. VPC), the subnets, adds routes, security groups, etc. It also contains instances, but this is mainly to deploy VNFs and service nodes.
### Cloud Model Example
cloud_acls:
host-acl:
- { src_ip: 0.0.0.0/0, dst_ports: 22, proto: tcp }
- { src_ip: 0.0.0.0/0, dst_ports: 443, proto: tcp }
- { src_ip: 0.0.0.0/0, proto: icmp }
rtr-acl:
- { src_ip: 0.0.0.0/0, proto: all }
vpc_list:
- name: "{{ cloud_name }}"
provider: "{{ cloud_provider }}"
region: "{{ cloud_region }}"
project: "{{ cloud_name }}"
cidr: "{{ cloud_cidr }}"
networks:
- name: "outside.{{ cloud_name }}"
cidr: "{{ cloud_cidr | ipsubnet(24, 0) }}"
az: "{{ cloud_region }}a"
- name: "inside.{{ cloud_name }}"
cidr: "{{ cloud_cidr | ipsubnet(24, 1) }}"
az: "{{ cloud_region }}a"
routes:
- cidr: "0.0.0.0/0"
instance: "rtr1.{{ cloud_name }}"
if_index: 2
instances:
- name: "rtr1.{{ cloud_name }}"
size: medium
image: csr-byol
interfaces:
- name: GigabitEthernet1
subnet: "outside.{{ cloud_name }}"
acl: rtr-acl
public_ip: true
private_ip: "{{ cloud_cidr | ipsubnet(24, 0) | ipaddr(-2) | ipaddr('address') }}"
- name: GigabitEthernet2
subnet: "inside.{{ cloud_name }}"
acl: rtr-acl
public_ip: true
private_ip: "{{ cloud_cidr | ipsubnet(24, 1) | ipaddr(-2) | ipaddr('address') }}"
tags:
network_os: ios
groups: network,routers,spoke_routers
user_data: "{{ lookup('file', 'csr.user_data') }}"
- name: "host1.{{ cloud_name }}"
size: micro
image: rhel7
interfaces:
- name: eth0
subnet: "inside.{{ cloud_name }}"
acl: host-acl
private_ip: "{{ cloud_cidr | ipsubnet(24, 2) | ipaddr(10) | ipaddr('address') }}"
tags:
groups: hosts
GPL-3
- Steven Carter