Current File : //lib/python2.7/site-packages/salt/states/boto_cfn.pyo
�
���^c @@ s- 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 m
Z
y d d l m Z
e Z Wn e k
r� e Z n Xe j e � Z d Z d � Z d d d d d d d d d d d d d d d d d d d � Z d d d d d � Z d
� Z d d d d d d d � Z d � Z d S(
uh
Connection module for Amazon Cloud Formation
.. versionadded:: 2015.8.0
:depends: boto
:configuration: This module accepts explicit AWS 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
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
keyid: GKTADJGHEIQSXMKKRBJ08H
key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
.. code-block:: yaml
stack-present:
boto_cfn.present:
- name: mystack
- template_body: salt://base/mytemplate.json
- disable_rollback: true
- region: eu-west-1
- keyid: 'AKIAJHTMIQ2ASDFLASDF'
- key: 'fdkjsafkljsASSADFalkfjasdf'
.. code-block:: yaml
stack-absent:
boto_cfn.absent:
- name: mystack
i ( t absolute_importt print_functiont unicode_literalsN( t six( t ElementTreeu boto_cfnc C@ s@ t s t d j t � f Sd t k r) t St d j t � f Sd S( uF
Only load if elementtree xml library and boto are available.
u6 Cannot load {0} state: ElementTree library unavailableu boto_cfn.existsu2 Cannot load {0} state: boto_cfn module unavailableN( t HAS_ELEMENT_TREEt Falset formatt __virtualname__t __salt__t True( ( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_cfn.pyt __virtual__> s
c C@ sZ i | d 6t d 6d d 6i d 6} t | | � } t |
| � }
t |
| � }
x* | |
|
g D] } t | t � r_ | Sq_ Wt | | | | | | � } t j d | � | t k r� | \ } } t | d <d j | | � | d <| St j d | � t d | | | | | � r�t d
| | | | | � } | d d d
j
d d � } t j j
j | � } t j j
j | � } t j j j | | � } | d k r�t j d | � t d r�d j | � | d <d | d <| St d | | | | | | | | | | |
| |
| | | | | � } t | t j � rst | � \ } } t j d | | � t | d <d j | | | � | d <| Sd j | � | d <| | d d <| Sd j | � | d <i | d <| St d r�d j | � | d <d | d <| St d | | | | | | | | | | |
| | | | | � } | rLd j | � | d <| | d d <| St | d <| S( u
Ensure cloud formation stack is present.
name (string) - Name of the stack.
template_body (string) – Structure containing the template body. Can also be loaded from a file by using salt://.
template_url (string) – Location of file containing the template body. The URL must point to a template located in
an S3 bucket in the same region as the stack.
parameters (list) – A list of key/value tuples that specify input parameters for the stack. A 3-tuple (key, value,
bool) may be used to specify the UsePreviousValue option.
notification_arns (list) – The Simple Notification Service (SNS) topic ARNs to publish stack related events.
You can find your SNS topic ARNs using the `SNS_console`_ or your Command Line Interface (CLI).
disable_rollback (bool) – Indicates whether or not to rollback on failure.
timeout_in_minutes (integer) – The amount of time that can pass before the stack status becomes CREATE_FAILED; if
DisableRollback is not set or is set to False, the stack will be rolled back.
capabilities (list) – The list of capabilities you want to allow in the stack. Currently, the only valid capability
is ‘CAPABILITY_IAM’.
tags (dict) – A set of user-defined Tags to associate with this stack, represented by key/value pairs. Tags defined
for the stack are propagated to EC2 resources that are created as part of the stack. A maximum number of 10 tags can
be specified.
on_failure (string) – Determines what action will be taken if stack creation fails. This must be one of:
DO_NOTHING, ROLLBACK, or DELETE. You can specify either OnFailure or DisableRollback, but not both.
stack_policy_body (string) – Structure containing the stack policy body. Can also be loaded from a file by using
salt://.
stack_policy_url (string) – Location of a file containing the stack policy. The URL must point to a policy
(max size: 16KB) located in an S3 bucket in the same region as the stack.If you pass StackPolicyBody and
StackPolicyURL, only StackPolicyBody is used.
use_previous_template (boolean) – Used only when templates are not the same. Set to True to use the previous
template instead of uploading a new one via TemplateBody or TemplateURL.
stack_policy_during_update_body (string) – Used only when templates are not the same. Structure containing the
temporary overriding stack policy body. If you pass StackPolicyDuringUpdateBody and StackPolicyDuringUpdateURL,
only StackPolicyDuringUpdateBody is used. Can also be loaded from a file by using salt://.
stack_policy_during_update_url (string) – Used only when templates are not the same. Location of a file containing
the temporary overriding stack policy. The URL must point to a policy (max size: 16KB) located in an S3 bucket in
the same region as the stack. If you pass StackPolicyDuringUpdateBody and StackPolicyDuringUpdateURL, only
StackPolicyDuringUpdateBody is used.
region (string) - Region to connect to.
key (string) - Secret key to be used.
keyid (string) - Access key to be used.
profile (dict) - A dict with region, key and keyid, or a pillar key (string) that contains a dict with region, key
and keyid.
.. _`SNS_console`: https://console.aws.amazon.com/sns
u nameu resultu u commentu changesu Validate is : %s.u) Template could not be validated.
{0}
{1}u Template %s is valid.u boto_cfn.existsu boto_cfn.get_templateu GetTemplateResponseu GetTemplateResultu TemplateBodyu asciiu ignorei u/ Templates are not the same. Compare value is %su testu Stack {0} is set to be updated.u boto_cfn.update_stacku$ Update error is %s and message is %su) Stack {0} could not be updated.
{1}
{2}.u. Cloud formation template {0} has been updated.u newu Stack {0} exists.u Stack {0} is set to be created.u boto_cfn.createu Stack {0} was created.N( R
t
_get_templatet
isinstancet dictt _validatet logt debugR R R t encodet saltt utilst jsont loadst compatt cmpt __opts__t NoneR t string_typest
_get_error( t namet
template_bodyt template_urlt
parameterst notification_arnst disable_rollbackt timeout_in_minutest capabilitiest tagst
on_failuret stack_policy_bodyt stack_policy_urlt use_previous_templatet stack_policy_during_update_bodyt stack_policy_during_update_urlt regiont keyt keyidt profilet rett it _validt codet messaget templatet _template_bodyt comparet updatedt created( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_cfn.pyt presentK sv B"
c C@ s* i | d 6t d 6d d 6i d 6} t d | | | | | � s_ d j | � | d <i | d <| St d r� d j | � | d <d | d <| St d
| | | | | � } t | t j � r� t | � \ } } d j | | | � | d <t | d <i | d <| S| r&d j | � | d <| | d d
<| Sd S( uu
Ensure cloud formation stack is absent.
name (string) – The name of the stack to delete.
region (string) - Region to connect to.
key (string) - Secret key to be used.
keyid (string) - Access key to be used.
profile (dict) - 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_cfn.existsu Stack {0} does not exist.u testu Stack {0} is set to be deleted.u boto_cfn.deleteu' Stack {0} could not be deleted.
{1}
{2}u Stack {0} was deleted.u deletedN(
R
R R R R R
R R R R ( R R, R- R. R/ R0 t deletedR3 R4 ( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_cfn.pyt absent� s( "
c C@ s� i | d 6t d 6d d 6i d 6} | d k r� d | k r� y t d | � SWq� t k
r� } t j | � d j | � | d <t | d <| SXn | S( Nu nameu resultu u commentu changesu salt://u cp.get_file_stru File {0} not found.( R
R R t IOErrorR R R R ( R5 R R0 t e( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_cfn.pyR � s "
c C@ st t d | | | | | | � } t j d | � t | t j � rp t | � \ } } t j d | | � | | f St S( Nu boto_cfn.validate_templateu Validate result is %s.u' Validate error is %s and message is %s.( R R R R
R R R R
( R R R, R- R. R/ t validateR3 R4 ( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_cfn.pyR s
c C@ sW d j | j d � d � } t j | � } | d d j } | d d j } | | f S( Nu
i i i ( t joint splitt ETt
fromstringt text( t errorR3 R4 ( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_cfn.pyR s
( t __doc__t
__future__R R R t loggingt salt.utils.compatR t salt.utils.jsont salt.extR t salt._compatR RB R
R t ImportErrorR t getLoggert __name__R R R R R: R< R R R ( ( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_cfn.pyt <module>& s*
�%
Mini Shell