Create and destroy autoscale groups. Be aware that this interacts with Amazon's
services, and so may incur charges.

This module uses boto, which can be installed via package, or pip.

This module accepts explicit autoscale credentials but can also utilize
IAM roles assigned to the instance through Instance Profiles. Dynamic
credentials are then automatically obtained from AWS API and no further
configuration is necessary. More Information available at:

Ensure myasg exists:boto_asg.present:-name:myasg-launch_config_name:mylc-availability_zones:-us-east-1a-us-east-1b-min_size:1-max_size:1-desired_capacity:1-load_balancers:-myelb-suspended_processes:-AddToLoadBalancer-AlarmNotification-scaling_policies- adjustment_type:ChangeInCapacity- as_name:api-production-iad- cooldown:1800- min_adjustment_step:None- name:ScaleDown- scaling_adjustment:-1-region:us-east-1-keyid:GKTADJGHEIQSXMKKRBJ08H-key:askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs# Using a profile from pillars.Ensure myasg exists:boto_asg.present:-name:myasg-launch_config_name:mylc-availability_zones:-us-east-1a-us-east-1b-min_size:1-max_size:1-desired_capacity:1-load_balancers:-myelb-profile:myprofile# Passing in a profile.Ensure myasg exists:boto_asg.present:-name:myasg-launch_config_name:mylc-availability_zones:-us-east-1a-us-east-1b-min_size:1-max_size:1-desired_capacity:1-load_balancers:-myelb-profile:keyid:GKTADJGHEIQSXMKKRBJ08Hkey:askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghsregion:us-east-1# Deleting an autoscale group with running instances.Ensure myasg is deleted:boto_asg.absent:-name:myasg# If instances exist, we must force the deletion of the asg.-force:True

It's possible to specify cloudwatch alarms that will be setup along with the
ASG. Note the alarm name will be the name attribute defined, plus the ASG
resource name.

You can also use alarms from pillars, and override values from the pillar
alarms by setting overrides on the resource. Note that 'boto_asg_alarms'
will be used as a default value for all resources, if defined and can be
used to ensure alarms are always set for an ASG resource.

Name of the launch config to use for the group. Or, if
launch_config is specified, this will be the launch config
name's prefix. (see below)

launch_config

A dictionary of launch config attributes. If specified, a
launch config will be used or created, matching this set
of attributes, and the autoscale group will be set to use
that launch config. The launch config name will be the
launch_config_name followed by a hyphen followed by a hash
of the launch_config dict contents.
Example:

If any alarm actions include ":self:" this will be replaced with the asg name.
For example, alarm_actions reading "['scaling_policy:self:ScaleUp']" will
map to the arn for this asg's scaling policy named "ScaleUp".
In addition, any alarms that have only scaling_policy as actions will be ignored if
min_size is equal to max_size for this ASG.

alarms_from_pillar:

name of pillar dict that contains alarm settings. Alarms defined for this specific
state will override those from pillar.

region

The region to connect to.

key

Secret key to be used.

keyid

Access key to be used.

profile

A dict with region, key and keyid, or a pillar key (string)
that contains a dict with region, key and keyid.

notification_arn

The AWS arn that notifications will be sent to

notification_arn_from_pillar

name of the pillar dict that contains notifcation_arn settings. A
notification_arn defined for this specific state will override the
one from pillar.

notification_types

A list of event names that will trigger a notification. The list of valid
notification types is:

autoscaling:EC2_INSTANCE_LAUNCH

autoscaling:EC2_INSTANCE_LAUNCH_ERROR

autoscaling:EC2_INSTANCE_TERMINATE

autoscaling:EC2_INSTANCE_TERMINATE_ERROR

autoscaling:TEST_NOTIFICATION

notification_types_from_pillar

name of the pillar dict that contains notifcation_types settings.
notification_types defined for this specific state will override those
from the pillar.

Generated on March 19, 2018 at 07:02:15 MDT.

You are viewing docs for the latest stable release, 2017.7.4. Switch to docs for the previous stable release, 2016.11.9, or to a recent doc build from the develop branch.