Current File : //lib/python2.7/site-packages/salt/states/boto_route53.pyc
�
���^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 Z d d l
m Z d d l m
Z
e j e � Z d � Z d � Z d d d d d d e e e d � Z d � Z d d d d d e e e d
� Z d e d d d d d d d d d d � Z d d d d d d
� Z d S( uG
Manage Route53 records
.. versionadded:: 2014.7.0
Create and delete Route53 records. 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 route53 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 `here
<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 file or
in the minion's config file:
.. code-block:: yaml
route53.keyid: GKTADJGHEIQSXMKKRBJ08H
route53.key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
It's also possible to specify ``key``, ``keyid`` and ``region`` via a profile, either
passed in as a 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
mycnamerecord:
boto_route53.present:
- name: test.example.com.
- value: my-elb.us-east-1.elb.amazonaws.com.
- zone: example.com.
- ttl: 60
- record_type: CNAME
- region: us-east-1
- keyid: GKTADJGHEIQSXMKKRBJ08H
- key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
# Using a profile from pillars
myarecord:
boto_route53.present:
- name: test.example.com.
- value: 1.1.1.1
- zone: example.com.
- ttl: 60
- record_type: A
- region: us-east-1
- profile: myprofile
# Passing in a profile
myarecord:
boto_route53.present:
- name: test.example.com.
- value: 1.1.1.1
- zone: example.com.
- ttl: 60
- record_type: A
- region: us-east-1
- profile:
keyid: GKTADJGHEIQSXMKKRBJ08H
key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
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_route53.get_recordu boto_route53( t __salt__t False( ( ( s< /usr/lib/python2.7/site-packages/salt/states/boto_route53.pyt __virtual__X s c O@ s
t | | � S( N( t present( t argst kwargs( ( s< /usr/lib/python2.7/site-packages/salt/states/boto_route53.pyt
rr_present_ s c
C@ s� i | d 6t d 6d d 6i d 6}
t | t � rC d j | � } ng| j d � sa | j d � r�| j d d
� d
} d0 } t d d | d t d | d | � } t | � d
k r� d j | � |
d <t |
d <|
St | � d
k rd j | � |
d <t |
d <|
S| d } t
| d d1 � } t
| d d1 � } | j d � ra| } t j
d | | � q�| d1 k r�d j | � |
d <t |
d <|
S| } t j
d | | � n y2 t d | | | t | | | | | | | � } Wn1 t k
r} d j | � |
d <t |
d <|
SXt | t � r| rt d rQd j | � |
d <d1 |
d <|
St d! | | | | | | | | | | |
| | �
} | r�d1 |
d d" <i | d 6| d# 6| d$ 6| d% 6| d& 6|
d d' <d( j | � |
d <q�t |
d <d) j | � |
d <|
Sn�| r�t } g | j d � D] } | j d* � ^ q } g | d# j d � D] } | j d* � ^ qO} | j � | j � | | k r�t } n | r�| | d& k r�t } n | r�t j | � t j | d% � k r�t } n | r�t d rd+ j | � |
d <d1 |
d <|
St d, | | | | | | | | | | |
| | �
} | r�| |
d d" <i | d 6| d# 6| d$ 6| d% 6| d& 6|
d d' <d- j | � |
d <q�t |
d <d. j | � |
d <q�d/ j | � |
d <n |
S(2 uT
Ensure the Route53 record is present.
name
Name of the record.
value
Value of the record. As a special case, you can pass in:
`private:<Name tag>` to have the function autodetermine the private IP
`public:<Name tag>` to have the function autodetermine the public IP
zone
The zone to create the record in.
record_type
The record type (A, NS, MX, TXT, etc.)
ttl
The time to live for the record.
identifier
The unique identifier to use for this record.
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.
wait_for_sync
Wait for an INSYNC change status from Route53 before returning success.
split_dns
Route53 supports parallel public and private DNS zones with the same name.
private_zone
If using split_dns, specify if this is the private zone.
u nameu resultu u commentu changesu ,u private:u public:u :i u pendingu rebootingu runningu stoppingu stoppedu boto_ec2.find_instancest namet return_objst in_statest profileu+ Error: instance with Name tag {0} not foundu2 Error: Name tag {0} matched more than one instancei u private_ip_addressu
ip_addressu# Found private IP %s for instance %su6 Error: No Public IP assigned to instance with Name {0}u" Found public IP %s for instance %su boto_route53.get_recordu
Error: {0}u testu# Route53 record {0} set to be added.u boto_route53.add_recordu oldu valueu record_typeu ttlu
identifieru newu Added {0} Route53 record.u! Failed to add {0} Route53 record.u .u% Route53 record {0} set to be updated.u boto_route53.update_recordu Updated {0} Route53 record.u$ Failed to update {0} Route53 record.u {0} exists.( u pendingu rebootingu runningu stoppingu stoppedN( t Truet
isinstancet listt joint
startswitht splitR t lent formatR t getattrt Nonet logt infoR t dictt __opts__t rstript sortR t text_type( R t valuet zonet record_typet ttlt
identifiert regiont keyt keyidR t
wait_for_synct split_dnst private_zonet rett name_tagR t rt instancet
private_ipt public_ipt recordt errt addedt need_to_updatet xt _valuest _r_valuest updated( ( s< /usr/lib/python2.7/site-packages/salt/states/boto_route53.pyR c s� /"
+/
(
c O@ s
t | | � S( N( t absent( R R
( ( s< /usr/lib/python2.7/site-packages/salt/states/boto_route53.pyt rr_absent s c
C@ s! i | d 6t d 6d d 6i d 6} t d | | | t | | | | | |
| � } | r
t d r� d j | � | d <d | d <| St d | | | | t | | | | | | |
� }
|
r� | | d d
<d | d d <d j | � | d <q t | d <d
j | � | d <n d j | � | d <| S( u
Ensure the Route53 record is deleted.
name
Name of the record.
zone
The zone to delete the record from.
record_type
The record type (A, NS, MX, TXT, etc.)
identifier
An identifier to match for deletion.
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.
wait_for_sync
Wait for an INSYNC change status from Route53.
split_dns
Route53 supports a public and private DNS zone with the same
names.
private_zone
If using split_dns, specify if this is the private zone.
u nameu resultu u commentu changesu boto_route53.get_recordu testu% Route53 record {0} set to be deleted.u boto_route53.delete_recordu oldu newu Deleted {0} Route53 record.u$ Failed to delete {0} Route53 record.u {0} does not exist.N( R R R R R R ( R R" R# R% R& R' R( R R) R* R+ R, R2 t deleted( ( s< /usr/lib/python2.7/site-packages/salt/states/boto_route53.pyR: s4 2"
u c C@ s� | r | n | } i | d 6t d 6d d 6i d 6} | rzt j j j | | f � sd t d � � n t d d | d | d
| d | d |
d
| � j d g � }
| r� |
r� g |
D] } | d | k r� | ^ q� }
n |
s
d } t j | � | | d <t
| d <| St |
� d k rGt j d g |
D] } | d ^ q,� d* S|
d } | rd| d } n | sz| d } qzn t d d | d
| d | d |
d
| � } t
} | s�t } n� t j j
j | d d d � | k r�t } nb | rLxY | j d i � j � D]< \ } } | d | k r?| d | k r?t
} Pq t } q Wn | shd j | � | d <n t j d | � | r�| d* k r�t j t j � � } n t d r�d j | � | d <d* | d <| St d! d | d" | d# | d$ | d | d% | d
| d | d |
d
| �
} | rad& j | � } t j | � | | d <d* | d d' <| | d d( <q�d) j | � | d <t
| d <n | S(+ u�
Ensure a hosted zone exists with the given attributes. Note that most
things cannot be modified once a zone is created - it must be deleted and
re-spun to update these attributes:
- private_zone (AWS API limitation).
- comment (the appropriate call exists in the AWS API and in boto3, but has
not, as of this writing, been added to boto2).
- vpc_id (same story - we really need to rewrite this module with boto3)
- vpc_name (really just a pointer to vpc_id anyway).
- vpc_region (again, supported in boto3 but not boto2).
If you need the ability to update these attributes, please use the newer
boto3_route53 module instead.
name
The name of the state definition.
domain_name
The name of the domain. This must be fully-qualified, terminating with a period. This is
the name you have registered with your domain registrar. It is also the name you will
delegate from your registrar to the Amazon Route 53 delegation servers returned in response
to this request. Defaults to the value of name if not provided.
private_zone
Set True if creating a private hosted zone.
caller_ref
A unique string that identifies the request and that allows create_hosted_zone() calls to be
retried without the risk of executing the operation twice. This helps ensure idempotency
across state calls, but can cause issues if a zone is deleted and then an attempt is made
to recreate it with the same caller_ref. If not provided, a unique UUID will be generated
at each state run, which avoids the risk of the above (transient) error. This option is
generally not needed. Maximum length of 128.
comment
Any comments you want to include about the hosted zone.
vpc_id
When creating a private hosted zone, either the VPC ID or VPC Name to associate with is
required. Exclusive with vpe_name. Ignored when creating a non-private zone.
vpc_name
When creating a private hosted zone, either the VPC ID or VPC Name to associate with is
required. Exclusive with vpe_id. Ignored when creating a non-private zone.
vpc_region
When creating a private hosted zone, the region of the associated VPC is required. If not
provided, an effort will be made to determine it from vpc_id or vpc_name, where possible.
If this fails, you'll need to provide an explicit value for this option. Ignored when
creating a non-private zone.
u nameu resultu u commentu changesuC Either vpc_name or vpc_id is required when creating a private zone.u boto_vpc.describe_vpcst vpc_idR R& R' R( R u vpcsu regionuC Private zone requested but a VPC matching given criteria not found.i uJ Private zone requested but multiple VPCs matching given criteria found: %su idi u" boto_route53.describe_hosted_zonest domain_nameu
HostedZoneu Configu PrivateZoneu VPCsu VPCIdu VPCRegionu' Hostd Zone {0} already in desired stateu� A Hosted Zone with name %s already exists, but with different settings. Will attempt to create the one requested on the assumption this is what is desired. This may fail...u testu( Route53 Hosted Zone {0} set to be added.u boto_route53.create_hosted_zonet
caller_reft commentR+ t
vpc_regionu$ Hosted Zone {0} successfully createdu oldu newu Creating Hosted Zone {0} failedN( R t saltt utilst datat exactly_oneR R t getR t errorR R R t jsont loadst itemsR R R R t uuidt uuid4R ( R R> R+ R? R@ R= t vpc_nameRA R& R' R( R R, t vpcst vt msgt vpct deetst createt dt res( ( s< /usr/lib/python2.7/site-packages/salt/states/boto_route53.pyt hosted_zone_presentX s� 7"
,
%
c C@ s* | r | n | } i | d 6t d 6d d 6i d 6} t d d | d | d | d
| d | � } | s� d j | � | d <t j | d � | St d
r� d j | � | d <d | d <| St d d | d | d | d
| d | � r&d j | � | d <t j | d � | | d d <d | d d <n | S( u
Ensure the Route53 Hostes Zone described is absent
name
The name of the state definition.
domain_name
The FQDN (including final period) of the zone you wish absent. If not
provided, the value of name will be used.
u nameu resultu u commentu changesu" boto_route53.describe_hosted_zonesR> R& R' R( R u Hosted Zone {0} already absentu testu* Route53 Hosted Zone {0} set to be deleted.u boto_route53.delete_zoneR" u Route53 Hosted Zone {0} deletedu oldu newN( R R R R R R R ( R R> R& R' R( R R, RR ( ( s< /usr/lib/python2.7/site-packages/salt/states/boto_route53.pyt hosted_zone_absent� s,
"
( t __doc__t
__future__R R R t loggingRK t salt.utils.dataRB t salt.utils.jsont salt.extR t salt.exceptionsR t getLoggert __name__R R R R R R R R; R: RV RW ( ( ( s< /usr/lib/python2.7/site-packages/salt/states/boto_route53.pyt <module>H s4 � F �
Mini Shell