Current File : //lib/python2.7/site-packages/salt/states/boto_rds.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 m Z d d l m
Z
d d l Z e j
e � Z d � Z d d d d d d d d d d d d d d d d d d d 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 d d d d d d d d d �
Z d d d d d d d d � Z d d d e d
d d d d d � Z d d d d d d � Z d d
d d d d d d � Z d S( u�
Manage RDSs
===========
.. versionadded:: 2015.8.0
Create and destroy RDS instances. 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 rds 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
rds.keyid: GKTADJGHEIQSXMKKRBJ08H
rds.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
Ensure myrds RDS exists:
boto_rds.present:
- name: myrds
- allocated_storage: 5
- storage_type: standard
- db_instance_class: db.t2.micro
- engine: MySQL
- master_username: myuser
- master_user_password: mypass
- region: us-east-1
- keyid: GKTADJGHEIQSXMKKRBJ08H
- key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
- tags:
key: value
.. code-block:: yaml
Ensure parameter group exists:
create-parameter-group:
boto_rds.parameter_present:
- name: myparametergroup
- db_parameter_group_family: mysql5.6
- description: "parameter group family"
- parameters:
- binlog_cache_size: 32768
- binlog_checksum: CRC32
- region: eu-west-1
:depends: boto3
i ( t absolute_importt print_functiont unicode_literalsN( t six( t SaltInvocationErrorc C@ s# d t k r d St t j d � f S( u)
Only load if boto is available.
u boto_rds.existsu boto_rds( t __salt__t Falset missing_fun_string( ( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_rds.pyt __virtual__U s c+ - , C@ s� i | d 6t d 6d d 6i d 6}+ t d | | |" |$ |% |* � }, |, j d � s�t d r{ d j | � |+ d <d |+ d <|+ St d
| | | | | | | | | |
| | |
| | | | | | | | | | | | | | | | | | | | |# |! |& |' |( |" |) |$ |% |* �+ }, |, j d � sAt |+ d <d j |, d
d � |+ d <|+ Si d d 6|+ d d <i t d d | d d d |" d |$ d |% d |* � d 6|+ d d <d j | � |+ d <n d j | � |+ d <|+ S( u�
Ensure RDS instance exists.
name
Name of the RDS state definition.
allocated_storage
The amount of storage (in gigabytes) to be initially allocated for the
database instance.
db_instance_class
The compute and memory capacity of the Amazon RDS DB instance.
engine
The name of the database engine to be used for this instance. Supported
engine types are: MySQL, mariadb, oracle-se1, oracle-se, oracle-ee, sqlserver-ee,
sqlserver-se, sqlserver-ex, sqlserver-web, postgres and aurora. For more
information, please see the ``engine`` argument in the Boto3 RDS
`create_db_instance`_ documentation.
master_username
The name of master user for the client DB instance.
master_user_password
The password for the master database user. Can be any printable ASCII
character except "/", '"', or "@".
db_name
The meaning of this parameter differs according to the database engine you use.
See the Boto3 RDS documentation to determine the appropriate value for your configuration.
https://boto3.readthedocs.io/en/latest/reference/services/rds.html#RDS.Client.create_db_instance
storage_type
Specifies the storage type to be associated with the DB instance.
Options are standard, gp2 and io1. If you specify io1, you must also include
a value for the Iops parameter.
db_security_groups
A list of DB security groups to associate with this DB instance.
vpc_security_group_ids
A list of EC2 VPC security group IDs to associate with this DB instance.
vpc_security_groups
A list of EC2 VPC security groups (IDs or Name tags) to associate with this DB instance.
availability_zone
The EC2 Availability Zone that the database instance will be created
in.
db_subnet_group_name
A DB subnet group to associate with this DB instance.
preferred_maintenance_window
The weekly time range (in UTC) during which system maintenance can
occur.
db_parameter_group_name
A DB parameter group to associate with this DB instance.
db_cluster_identifier
If the DB instance is a member of a DB cluster, contains the name of
the DB cluster that the DB instance is a member of.
tde_credential_arn
The ARN from the Key Store with which the instance is associated for
TDE encryption.
tde_credential_password
The password to use for TDE encryption if an encryption key is not used.
storage_encrypted
Specifies whether the DB instance is encrypted.
kms_keyid
If storage_encrypted is true, the KMS key identifier for the encrypted
DB instance.
backup_retention_period
The number of days for which automated backups are retained.
preferred_backup_window
The daily time range during which automated backups are created if
automated backups are enabled.
port
The port number on which the database accepts connections.
multi_az
Specifies if the DB instance is a Multi-AZ deployment. You cannot set
the AvailabilityZone parameter if the MultiAZ parameter is set to true.
engine_version
The version number of the database engine to use.
auto_minor_version_upgrade
Indicates that minor engine upgrades will be applied automatically to
the DB instance during the maintenance window.
license_model
License model information for this DB instance.
iops
The amount of Provisioned IOPS (input/output operations per second) to
be initially allocated for the DB instance.
option_group_name
Indicates that the DB instance should be associated with the specified
option group.
character_set_name
For supported engines, indicates that the DB instance should be
associated with the specified CharacterSet.
publicly_accessible
Specifies the accessibility options for the DB instance. A value of
true specifies an Internet-facing instance with a publicly resolvable
DNS name, which resolves to a public IP address. A value of false
specifies an internal instance with a DNS name that resolves to a
private IP address.
wait_status
Wait for the RDS instance to reach a desired status before finishing
the state. Available states: available, modifying, backing-up
tags
A dict of tags.
copy_tags_to_snapshot
Specifies whether tags are copied from the DB instance to snapshots of
the DB instance.
region
Region to connect to.
domain
The identifier of the Active Directory Domain.
key
AWS secret key to be used.
keyid
AWS access key to be used.
monitoring_interval
The interval, in seconds, between points when Enhanced Monitoring
metrics are collected for the DB instance.
monitoring_role_arn
The ARN for the IAM role that permits RDS to send Enhanced Monitoring
metrics to CloudWatch Logs.
domain_iam_role_name
Specify the name of the IAM role to be used when making API calls to
the Directory Service.
promotion_tier
A value that specifies the order in which an Aurora Replica is
promoted to the primary instance after a failure of the existing
primary instance. For more information, see Fault Tolerance for an
Aurora DB Cluster .
profile
A dict with region, key and keyid, or a pillar key (string) that
contains a dict with region, key and keyid.
.. _create_db_instance: https://boto3.readthedocs.io/en/latest/reference/services/rds.html#RDS.Client.create_db_instance
u nameu resultu u commentu changesu boto_rds.existsu existsu testu" RDS instance {0} would be created.u boto_rds.createu createdu" Failed to create RDS instance {0}.u erroru messageu instanceu oldu boto_rds.describe_db_instancest namet jmespathu DBInstances[0]t regiont keyt keyidt profileu newu RDS instance {0} created.u RDS instance {0} exists.N( t TrueR t gett __opts__t formatt NoneR (- R t allocated_storaget db_instance_classt enginet master_usernamet master_user_passwordt db_namet storage_typet db_security_groupst vpc_security_group_idst vpc_security_groupst availability_zonet db_subnet_group_namet preferred_maintenance_windowt db_parameter_group_namet db_cluster_identifiert tde_credential_arnt tde_credential_passwordt storage_encryptedt kms_keyidt backup_retention_periodt preferred_backup_windowt portt multi_azt engine_versiont auto_minor_version_upgradet
license_modelt iopst option_group_namet character_set_namet publicly_accessiblet wait_statust tagst copy_tags_to_snapshotR t domainR R
t monitoring_intervalt monitoring_role_arnt domain_iam_role_namet promotion_tierR t rett r( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_rds.pyt present^ sd �
c C@ s9 i | d 6t d 6d d 6i d 6} t d | | |
| | |
� } | j d � sCt d r{ d j | � | d <d | d <| St d
| | | | | | | | | | |
| | |
� } | r#d j | � | d <i d d 6| d d
<i t d d | d d d |
d | d | d |
� d 6| d d <q5t | d <d j | � | d <n� d } t d d | d | d |
d | d | d |
� } t | � r�| d n d } | | k rt d d | d | d |
d | d | d |
� } | s�t | d <d j | � | d <n | | d d
<| | d d <n t | d <d j | � | d <| S( u�
Ensure RDS replica exists.
.. code-block:: yaml
Ensure myrds replica RDS exists:
boto_rds.create_replica:
- name: myreplica
- source: mydb
u nameu resultu u commentu changesu boto_rds.existsu existsu testu* RDS read replica {0} is set to be created u boto_rds.create_read_replicau RDS replica {0} created.u instanceu oldu boto_rds.describe_db_instancesR R
u DBInstances[0]R R R
R u newu! Failed to create RDS replica {0}.u8 DBInstances[0].DBParameterGroups[0].DBParameterGroupNamei u boto_rds.modify_db_instanceR! u5 Failed to update parameter group of {0} RDS instance.u RDS replica {0} exists.N( R R R R R R R t len( R t sourceR R R) R, R. R/ R1 R3 R R R
R R! R: t replica_existst createdR
t pmg_namet modified( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_rds.pyt replica_presentl s\
$
c C@ s7 t j j j | | f � s* t d � � n i | d 6t d 6d d 6i d 6} | s[ g } n | rx� | D]� }
t d d d |
d
| d | d | d
| �} d | k r� d j | d d � | d <t | d <| S| d d k rd j |
� | d <t | d <| S| j
| d � qh Wn t d d | d | d
| d | d | d
| � } | j d � s t d r�d j | � | d <d | d <| St d d | d | d | d | d
| d | d | d
| � }
|
s�t | d <d j | � | d <| Sd | d d <| | d d <d j | � | d <| Sd j | � | d <| Sd S(! u�
Ensure DB subnet group exists.
name
The name for the DB subnet group. This value is stored as a lowercase string.
subnet_ids
A list of the EC2 Subnet IDs for the DB subnet group.
Either subnet_ids or subnet_names must be provided.
subnet_names
A list of The EC2 Subnet names for the DB subnet group.
Either subnet_ids or subnet_names must be provided.
description
Subnet group description.
tags
A dict of tags.
region
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.
uB One (but not both) of subnet_ids or subnet_names must be provided.u nameu resultu u commentu changesu boto_vpc.get_resource_idu subnetR R R R
R u erroru Error looking up subnet ids: {0}u messageu idu Subnet {0} does not exist.u boto_rds.subnet_group_existsR3 u existsu testu& Subnet group {0} is set to be created.u boto_rds.create_subnet_groupt descriptiont
subnet_idsu" Failed to create {0} subnet group.u oldu newu Subnet {0} created.u Subnet {0} present.N(
t saltt utilst datat exactly_oneR R R R R R t appendR R ( R RD RE t subnet_namesR3 R R R
R R: t iR; t existsR@ ( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_rds.pyt subnet_group_present� s^ $
"
i� c
C@ s< i | d 6t d 6d d 6i d 6}
t d d | d | d | d
| d | � } t | � sz t |
d <d j | � |
d <|
St d
r� d j | � |
d <d |
d <|
St d | | | | | | | | | | �
} | s� t |
d <d j | � |
d <|
Si | d d 6|
d d <i d d 6|
d d <d j | � |
d <|
S( u�
Ensure RDS instance is absent.
name
Name of the RDS instance.
skip_final_snapshot
Whether a final db snapshot is created before the instance is deleted.
If True, no snapshot is created.
If False, a snapshot is created before deleting the instance.
final_db_snapshot_identifier
If a final snapshot is requested, this is the identifier used for that
snapshot.
tags
A dict of tags.
wait_for_deletion (bool)
Wait for the RDS instance to be deleted completely before finishing
the state.
timeout (in seconds)
The amount of time that can pass before raising an Exception.
region
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_rds.describe_db_instancesR R R R
R u {0} RDS already absent.u testu RDS {0} would be removed.u boto_rds.deleteu Failed to delete {0} RDS.i u instanceu oldu newu RDS {0} deleted.N( R R R= R R R R (
R t skip_final_snapshott final_db_snapshot_identifierR3 t wait_for_deletiont timeoutR R R
R R: t currentt deleted( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_rds.pyt absent s4 )
!
c
C@ s i | d 6t d 6d d 6i d 6} t d d | d | d | d
| d | d | � } | sz t | d <d
j | � | d <| St d r� d j | � | d <d | d <| St d | | | | | � } | s� t | d <d j | � | d <| S| | d d <d | d d <d j | � | d <| S( Nu nameu resultu u commentu changesu boto_rds.subnet_group_existsR R3 R R R
R u$ {0} RDS subnet group does not exist.u testu* RDS subnet group {0} is set to be removed.u boto_rds.delete_subnet_groupu& Failed to delete {0} RDS subnet group.u oldu newu RDS subnet group {0} deleted.( R R R R R R ( R R3 R R R
R R: RM RT ( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_rds.pyt subnet_group_absentV s.
"
u pending-rebootc
C@ s i | d 6t d 6d d 6i d 6}
t d d | d | d | d
| d | d | � } | j d
� st d r� d j | � |
d <d+ |
d <|
St d d | d | d | d | d | d
| d | d | � } | s� t |
d <d j | � |
d <|
S| |
d d <d j | � |
d <n d j | � |
d <| d+ k ri }
i } xi | D]a } xX | j � D]J \ } } t | � t k r�| r�d n d |
| <qZt
j | � |
| <qZWqGWt j
d |
� t d d | d | d
| d | d | � } | j d � s-t |
d <t j j |
d d j | � g � |
d <|
Sx� | d j � D]� } | d |
k r>|
j | d � t
j | d � k r>t j
d | d |
j | d � | d � |
j | d � | | d <q>q>Wt | � d k r�t d r t j j |
d d! j | | � g � |
d <d+ |
d <|
St d" | d# | d$ | d | d | d
| d | d | �} d% | k r�t |
d <t j j |
d d& j | | � | d% d' g � |
d <|
S| |
d d( <t j j |
d d) j | | � g � |
d <qt j j |
d d* j |
| � g � |
d <n |
S(, u�
Ensure DB parameter group exists and update parameters.
name
The name for the parameter group.
db_parameter_group_family
The DB parameter group family name. A
DB parameter group can be associated with one and only one DB
parameter group family, and can be applied only to a DB instance
running a database engine and engine version compatible with that
DB parameter group family.
description
Parameter group description.
parameters
The DB parameters that need to be changed of type dictionary.
apply_method
The `apply-immediate` method can be used only for dynamic
parameters; the `pending-reboot` method can be used with MySQL
and Oracle DB instances for either dynamic or static
parameters. For Microsoft SQL Server DB instances, the
`pending-reboot` method can be used only for static
parameters.
tags
A dict of tags.
region
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_rds.parameter_group_existsR R3 R R R
R u existsu testu) Parameter group {0} is set to be created.u boto_rds.create_parameter_groupt db_parameter_group_familyRD u% Failed to create {0} parameter group.u New Parameter Groupu Parameter group {0} created.u Parameter group {0} present.u onu offu Parameters from user are : %s.u boto_rds.describe_parametersu' Faled to get parameters for group {0}.u
parametersu
ParameterNameu ParameterValueu0 Values that are being compared for %s are %s:%s.i u3 Parameters {0} for group {1} are set to be changed.u boto_rds.update_parameter_groupt
parameterst apply_methodu erroru. Failed to change parameters {0} for group {1}:u messageu
Parametersu) Parameters {0} for group {1} are changed.u) Parameters {0} for group {1} are present.N( R R R R R R R t itemst typet boolR t text_typet logt debugt ost linesept joint valuesR= ( R RW RD RX RY R3 R R R
R R: t resR@ t paramst changedRZ t kt valuet optionst parametert update( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_rds.pyt parameter_presents st -
"
+
)6 "
,
%
7//( t __doc__t
__future__R R R t loggingR` t salt.extR t salt.exceptionsR t salt.utils.dataRF t getLoggert __name__R^ R R R< RC RN R RU RV Rl ( ( ( s8 /usr/lib/python2.7/site-packages/salt/states/boto_rds.pyt <module>F sx � > ] F
Mini Shell