Current File : //usr/lib/python2.7/site-packages/salt/states/boto_asg.pyc
�
���^c @@ sB d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l j j
Z
d d l Z d d l
m Z d d l m Z e j e � Z d � Z e e e e e e e e e e e d e e d e d e d
e e e e e d e d d
� Z d � Z d � Z d � Z d � Z d � Z e e e e e e d � Z d S( u�
Manage Autoscale Groups
=======================
.. versionadded:: 2014.7.0
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:
.. code-block:: text
http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html
If IAM roles are not used you need to specify them either in a pillar or
in the minion's config file:
.. code-block:: yaml
asg.keyid: GKTADJGHEIQSXMKKRBJ08H
asg.key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
It's also possible to specify key, keyid and region via a profile, either
as a passed in dict, or as a string to pull from pillars or minion config:
.. code-block:: yaml
myprofile:
keyid: GKTADJGHEIQSXMKKRBJ08H
key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
region: us-east-1
.. code-block:: yaml
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: GKTADJGHEIQSXMKKRBJ08H
key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
region: 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.
.. code-block:: yaml
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
- alarms:
CPU:
name: 'ASG CPU **MANAGED BY SALT**'
attributes:
metric: CPUUtilization
namespace: AWS/EC2
statistic: Average
comparison: '>='
threshold: 65.0
period: 60
evaluation_periods: 30
unit: null
description: 'ASG CPU'
alarm_actions: [ 'arn:aws:sns:us-east-1:12345:myalarm' ]
insufficient_data_actions: []
ok_actions: [ 'arn:aws:sns:us-east-1:12345:myalarm' ]
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.
Setting the alarms in a pillar:
.. code-block:: yaml
my_asg_alarm:
CPU:
name: 'ASG CPU **MANAGED BY SALT**'
attributes:
metric: CPUUtilization
namespace: AWS/EC2
statistic: Average
comparison: '>='
threshold: 65.0
period: 60
evaluation_periods: 30
unit: null
description: 'ASG CPU'
alarm_actions: [ 'arn:aws:sns:us-east-1:12345:myalarm' ]
insufficient_data_actions: []
ok_actions: [ 'arn:aws:sns:us-east-1:12345:myalarm' ]
Overriding the alarm values on the resource:
.. code-block:: yaml
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
- alarms_from_pillar: my_asg_alarm
# override CPU:attributes:threshold
- alarms:
CPU:
attributes:
threshold: 50.0
i ( t absolute_importt print_functiont unicode_literalsN( t six( t SaltInvocationErrorc C@ s d t k r d St S( u)
Only load if boto is available.
u boto_asg.existsu boto_asg( t __salt__t False( ( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_asg.pyt __virtual__� s u boto_asg_termination_policiesu boto_asg_scaling_policiesu boto_asg_scheduled_actionsu boto_asg_alarmsu boto_asg_notification_arnu boto_asg_notification_typesc ? , C@ s� | r |
r t d � � n i | d 6t d 6d d 6i d 6} |
r� g } x� |
D]� }! t d d d |! d
| d | d | d
| �}" d |" k r� d j |" d � | d <t | d <| Sd |" k r� d j |! � | d <t | d <| S| j |" d � qP Wn | rAt d | | | | | � }# |# j d � }# t j d | |# � n dY }# t j d | � | r�t
j j j
t | � � }$ | d t j |$ � j � } i | d 6| d 6| d 6| d 6| d 6}% x� t | � D]� \ }& }' d |' k r�|' d }( i |( d 6| d 6| d 6| d 6| d 6}) t d |) � }* |* rA|* d | |& d <n t j d |( � |( | |& d <| |& d =Pq�q�W|# r!t j d! � dY }+ x0 t | � D]" \ }& }' d" |' k r�|& }+ Pq�q�W|+ dY k r!t j d# � t d$ | |+ d" d% |# d
| d | d | d
| �}, |, | |+ d" <q!n x | D] }- |% j |- � q(Wt d& s�t d' |% � }. |. d t k r�|. d r�d( | d k r�i | d d( <n |. d | d d( <q�q�n t d) | | | | | � }/ t | | � } t | | � } t | | � } |/ dY k rt | d <d* | d <n1|/ st d& rId+ }0 |0 | d <dY | d <| St | | | | � \ } } t d, | | | | | | | | | |
| | | | | | | | | | | | | � }1 |1 r�dY | d d- <t d) | | | | | � }/ |/ | d d. <qL t | d <d/ | d <n>t }2 | rGx* | D] }3 d0 |3 k r!dY |3 d0 <q!q!Wn | r�x9 t j | � D]% \ }4 }5 d1 |5 k r]dY |5 d1 <q]q]Wn i | d2 6| d3 6| d4 6| d5 6| d6 6| d7 6| d8 6|
d9 6| d: 6| d; 6| d< 6| d= 6| d> 6| d? 6}6 | sd@ g |6 d< <n | dY k r g |6 d= <n | dY k r9g |6 d> <n | dY k rRi |6 d? <n xX t j | � D]G \ }4 }5 dA |5 k rb|/ d? j |4 i � }7 dA |7 k r�|7 dA =q�qbqbWi }8 x� t j |6 � D]� \ }9 }: |: dY k r�q�n t dB |: � }: |9 |/ k r�t dB |/ |9 � }; |: |; k s|t j dC |: |; � |8 j d- i � j i |; |9 6� |8 j d. i � j i |: |9 6� t }2 q|q�q�W|2 rB t d& r�dD }0 |0 | d <dY | d <|8 | d <| St | | | | � \ } } t dE | | | | | dF | dG | dH | dI | dJ |
dK | dL | dM | dN | dO | dP | dQ | d
| dR | dS | d | d | d
| �\ }< }0 |/ d2 | k r�t dT |/ d2 d
| d | d | d
| �}= |= r�d( | d k r�i | d d( <n |/ d2 | d d( dU <q�n |< r+ |/ | d d- <t d) | | | | | � }/ |/ | d d. <dV | d <qL t | d <|0 | d <n
dW | d <t | | | k | | | | | | � }> t j | d |> d � | d <dX j! | d |> d g � | d <|> d s� |> d | d <n | S(Z u�
Ensure the autoscale group exists.
name
Name of the autoscale group.
launch_config_name
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:
.. code-block:: yaml
my_asg:
boto_asg.present:
- launch_config:
- ebs_optimized: false
- instance_profile_name: my_iam_profile
- kernel_id: ''
- ramdisk_id: ''
- key_name: my_ssh_key
- image_name: aws2015091-hvm
- instance_type: c3.xlarge
- instance_monitoring: false
- security_groups:
- my_sec_group_01
- my_sec_group_02
availability_zones
List of availability zones for the group.
min_size
Minimum size of the group.
max_size
Maximum size of the group.
desired_capacity
The desired capacity of the group.
load_balancers
List of load balancers for the group. Once set this can not be
updated (Amazon restriction).
default_cooldown
Number of seconds after a Scaling Activity completes before any further
scaling activities can start.
health_check_type
The service you want the health status from, Amazon EC2 or Elastic Load
Balancer (EC2 or ELB).
health_check_period
Length of time in seconds after a new EC2 instance comes into service
that Auto Scaling starts checking its health.
placement_group
Physical location of your cluster placement group created in Amazon
EC2. Once set this can not be updated (Amazon restriction).
vpc_zone_identifier
A list of the subnet identifiers of the Virtual Private Cloud.
subnet_names
For VPC, a list of subnet names (NOT subnet IDs) to deploy into.
Exclusive with vpc_zone_identifier.
tags
A list of tags. Example:
.. code-block:: yaml
- key: 'key'
value: 'value'
propagate_at_launch: true
termination_policies
A list of termination policies. Valid values are:
* ``OldestInstance``
* ``NewestInstance``
* ``OldestLaunchConfiguration``
* ``ClosestToNextInstanceHour``
* ``Default``
If no value is specified, the ``Default`` value is used.
termination_policies_from_pillar:
name of pillar dict that contains termination policy settings. Termination policies
defined for this specific state will override those from pillar.
suspended_processes
List of processes to be suspended. see
http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/US_SuspendResume.html
scaling_policies
List of scaling policies. Each policy is a dict of key-values described by
https://boto.readthedocs.io/en/latest/ref/autoscale.html#boto.ec2.autoscale.policy.ScalingPolicy
scaling_policies_from_pillar:
name of pillar dict that contains scaling policy settings. Scaling policies defined for
this specific state will override those from pillar.
scheduled_actions:
a dictionary of scheduled actions. Each key is the name of scheduled action and each value
is dictionary of options. For example:
.. code-block:: yaml
- scheduled_actions:
scale_up_at_10:
desired_capacity: 4
min_size: 3
max_size: 5
recurrence: "0 9 * * 1-5"
scale_down_at_7:
desired_capacity: 1
min_size: 1
max_size: 1
recurrence: "0 19 * * 1-5"
scheduled_actions_from_pillar:
name of pillar dict that contains scheduled_actions settings. Scheduled actions
for this specific state will override those from pillar.
alarms:
a dictionary of name->boto_cloudwatch_alarm sections to be associated with this ASG.
All attributes should be specified except for dimension which will be
automatically set to this ASG.
See the :mod:`salt.states.boto_cloudwatch_alarm` state for information
about these attributes.
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.
uD vpc_zone_identifier and subnet_names are mutually exclusive options.u nameu resultu u commentu changesu boto_vpc.get_resource_idu subnett namet regiont keyt keyidt profileu erroru Error looking up subnet ids: {0}u idu Subnet {0} does not exist.u boto_vpc.get_subnet_associationu vpc_idu2 Auto Scaling Group %s is associated with VPC ID %su, Auto Scaling Group %s has no VPC Associationu -u regionu keyu keyidu profileu
image_nameu ami_nameu boto_ec2.find_imagesi u image_idu0 Couldn't find AMI named `%s`, passing literally.u1 Auto Scaling Group {0} is a associated with a vpcu security_groupsu2 security group associations found in launch configu" boto_secgroup.convert_to_group_idst vpc_idu testu boto_lc.presentu
launch_configu boto_asg.get_configu* Failed to check autoscale group existence.u" Autoscale group set to be created.u boto_asg.createu oldu newu Failed to create autoscale groupu min_adjustment_stepu end_timeu launch_config_nameu availability_zonesu min_sizeu max_sizeu desired_capacityu default_cooldownu health_check_typeu health_check_periodu vpc_zone_identifieru tagsu termination_policiesu suspended_processesu scaling_policiesu scheduled_actionsu Defaultu
start_timeu
boto3.orderedu %s asg_property differs from %su" Autoscale group set to be updated.u boto_asg.updatet desired_capacityt load_balancerst default_cooldownt health_check_typet health_check_periodt placement_groupt vpc_zone_identifiert tagst termination_policiest suspended_processest scaling_policiest scheduled_actionst notification_arnt notification_typesu$ boto_asg.delete_launch_configurationu deletedu Updated autoscale group.u Autoscale group present.u N(" R t TrueR t formatR t appendt gett logt debugt Nonet saltt utilst stringutilst to_bytest strt hashlibt md5t hexdigestt enumeratet warningt updatet __opts__t
__states__t _determine_termination_policiest _determine_scaling_policiest _determine_scheduled_actionst _determine_notification_infoR t iteritemst __utils__t
setdefaultt _alarms_presentt
dictupdatet join(? R t launch_config_namet availability_zonest min_sizet max_sizet
launch_configR R R R R R R t subnet_namesR R t termination_policies_from_pillarR R t scaling_policies_from_pillarR t scheduled_actions_from_pillart alarmst alarms_from_pillarR R
R R R t notification_arn_from_pillarR t notification_types_from_pillart rett it rR
t launch_config_bytest argst indext itemt
image_namet iargst image_idst sg_indext
_group_idst dt lc_rett asgt msgt createdt need_updatet policyt s_namet actiont configt
asg_actiont proposedt asg_propertyt valuet _valuet updatedt deletedt _ret( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_asg.pyt present� s� � "
!
c C@ sB t j t d | g � � } | r> t | � d k r> | } n | S( uN
helper method for present. ensure that termination_policies are set
u
config.optioni ( t copyt deepcopyR t len( R R@ t pillar_termination_policies( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_asg.pyR0 � s
c C@ sB t j t d | i � � } | r> t | � d k r> | } n | S( uJ
helper method for present. ensure that scaling_policies are set
u
config.optioni ( Rf Rg R Rh ( R RA t pillar_scaling_policies( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_asg.pyR1 � s
c C@ s; t j t d | i � � } | r7 t j | | � } n | S( uH
helper method for present, ensure scheduled actions are setup
u
config.option( Rf Rg R R8 R- ( R RB t tmp( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_asg.pyR2 � s
c C@ s� t j t d | i � � } d } t | � d k rA | d } n t j t d | i � � } | ri | n | } | r{ | n | } | | f S( uN
helper method for present. ensure that notification_configs are set
u
config.optioni N( Rf Rg R R" Rh ( R RE R RF t pillar_arn_listt
pillar_arnt pillar_notification_typest arnt types( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_asg.pyR3 � s
c C@ sM t j t d | i � � } | r7 t j | | � } n i | d 6t d 6d d 6i d 6} x�t j | � D]�\ }
} | d | d | d <| d | d d | d d <d
| d k r� i | g d 6| d d
<n t } x� d d
d g D]� }
|
| d k r� g } xb | d |
D]R } d | k r0t } n d | k rZ| j d d j
| � � } n | j | � qW| | d |
<q� q� W| r�| r�qi n i | d d 6| d d 6| d 6| d 6| d 6| d 6} t d | � } | d s�t | d <n | j
d i � i k r"| d | d | d <n d | k ri | d c | d 7<qi qi W| S( uK
helper method for present. ensure that cloudwatch_alarms are set
u
config.optionu nameu resultu u commentu changesu u
attributesu descriptionu
dimensionsu AutoScalingGroupNameu
alarm_actionsu insufficient_data_actionsu
ok_actionsu scaling_policyu :self:u :{0}:u regionu keyu keyidu profileu boto_cloudwatch_alarm.present( Rf Rg R R8 R- R R R4 R t replaceR R R/ R ( R t min_size_equals_max_sizeRC RD R R
R R Rk t merged_return_valuet _t infot scaling_policy_actions_onlyt action_typet new_actionsR[ t kwargst results( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_asg.pyR7 sJ "
c C@ s� i | d 6t d 6d d 6i d 6} t d | | | | | � } | d k ra t | d <d | d <n`| r�t d r� d | d <d | d <| r� d
j | d � } d j | d | g � | d <n | St d
| | | | | | � }
|
r�| rwt d | d | | | | � } | rMd | d k r4i | d d <n | d | d d d <qwt | d <d j | d d g � | d <n | | d d <d | d d <d | d <q�t | d <d | d <n
d | d <| S( u�
Ensure the named autoscale group is deleted.
name
Name of the autoscale group.
force
Force deletion of autoscale group.
remove_lc
Delete the launch config as well.
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.
u nameu resultu u commentu changesu boto_asg.get_configu* Failed to check autoscale group existence.u testu" Autoscale group set to be deleted.u. Launch configuration {0} is set to be deleted.u launch_config_nameu u boto_asg.deleteu$ boto_asg.delete_launch_configurationu
launch_configu deletedu& Failed to delete launch configuration.u oldu newu Deleted autoscale group.u! Failed to delete autoscale group.u Autoscale group does not exist.N( R R R" R R. R R9 ( R t forceR R
R R t remove_lcRG RU RV Rc t
lc_deleted( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_asg.pyt absent6 sF !"
( t __doc__t
__future__R R R R( t loggingRf t salt.utils.dictupdateR$ R8 t salt.utils.stringutilsR# t salt.extR t salt.exceptionsR t getLoggert __name__R R R" Re R0 R1 R2 R3 R7 R R~ ( ( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_asg.pyt <module>� sb
� �
6
Mini Shell