Configuration

Configuration

Wombat uses a Yaml file, defaults to wombat.yml, for its settings. The following table shows the options and what they are used for:

Attribute	Description	Type	Example Value
name	Name of the project. In Azure this is used as the name of the resource group	string	wombat-automate
enterprise	Name of the Automate enterprise	string	mammals
org	Name of the Chef organisation	string	marsupials
certs	Names of certificates to create	string[]	automate, chef, compliance
owner	Name of the person creating the demo. Will be used as a tag in Azure.	string	Russell Seymour
products	This is a named list of the versions of the components to use.	string
build-nodes.count	How many build nodes should be created	integer	1
conf	This is a list of the directories for each of the different components for wombat	hash

Workstation

All of the attributes in the following table are prefixed with workstations.

Attribute	Description	Type	Example Value
platform	Platform to use for the workstations	string	windows
password	Password to set for the admin user	string	123fh6kif
count	How many workstations to create	integer	1

In Azure Windows machines are not allowed to have a user called Administrator. In this case the main user defaults to azure.

The password for the Windows Workstation must meet the minimum password complexity requirments - https://technet.microsoft.com/en-us/library/hh994562(v=ws.11).aspx))

Infrastructure nodes

This is a list of nodes that will be created as infrastructure nodes. It is a hash of information where the name of the hash is the name of the node. Each of the hashes can have the following attributes.

Attribute	Description	Type	Example Value
environment	Environment that the node should belong to	string	web-acceptance
run_list	Array of items to be applied to the node	string[]	recipe[bacon::crispy]

It does not matter if there are no infranodes configured in the wombat.yml file, just the attribute has to exist.

The cookbooks are not uploaded by Wombat so the nodes will initially fail their run, but when prompted by Workflow they will run.

AWS Specific

The following settings are specific to AWS under the aws section.

Attribute	Description	Type	Example Value
az	The Availability zone that should be used	string	us-east-1e
keypair	Key pair to use for SSH authentication	string	my-key-pair
region	Region for the machines	string	us-east-1

A sub section called source_ami is used to set the IDs of the AMIs that should be used for the different operating systems for the machines.

Attribute	Description	Type	Example Value
ubuntu	AMI to use for Ubuntu	string	ami-8e0b9499
windows	AMI to use for Windows	string	ami-1c7ad77c
centos	AMI yo use for Centos machines	ami-6d1c2007

Azure Specific

The following settings are specific to Azure deployments.

Attribute	Description	Type	Example Value
location	Azure location in which to deploy	string	eastus
storage_account	Name of storage account to create. This is used for both the Packer images and machine VHDs	string	ghdsf565dsflkj

A sub section called tags is permissible in this section. This is a simple key/valu pair list of tags to add to the resource group that is created.

azure:
   location: eastus
   storage_account: ghdsf565dsflkj
   tags:
      expiry: 20170215
      inuse: true

A maximum of 14 items is permitted. The list will be truncated if there are more than 14 items.

GCE Specific

There are settings for deploying wombat projects to GCE, but this is not fully working at the moment.