Current File : //lib/python2.7/site-packages/salt/states/boto_s3.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 j j
Z
d d l Z e j
e � Z d � Z e d d d d d d
d d d
d d d d g
� Z e d d g � Z e d
d d d g � Z d d d d d d d d d � Z d S( u�
Manage S3 Resources
=================
.. versionadded:: 2018.3.0
Manage S3 resources. Be aware that this interacts with Amazon's services,
and so may incur charges.
This module uses ``boto3``, which can be installed via package, or pip.
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 `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
s3.keyid: GKTADJGHEIQSXMKKRBJ08H
s3.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 s3 object exists:
boto_s3.object_present:
- name: s3-bucket/s3-key
- source: /path/to/local/file
- region: us-east-1
- keyid: GKTADJGHEIQSXMKKRBJ08H
- key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
- profile: my-profile
:depends: boto3
i ( t absolute_importt print_functiont unicode_literalsNc C@ s d t k r t Sd S( u)
Only load if boto is available.
u boto_s3.get_object_metadatau boto_s3( t __salt__t False( ( ( s7 /usr/lib/python2.7/site-packages/salt/states/boto_s3.pyt __virtual__A s u CacheControlu ContentDispositionu ContentEncodingu ContentLanguageu ContentTypeu Expiresu Metadatau ServerSideEncryptionu SSECustomerAlgorithmu SSECustomerKeyMD5u SSEKMSKeyIdu StorageClassu WebsiteRedirectLocationu SSECustomerKeyu RequestPayeru boto_s3_object_extra_argsc
@ s i | d 6d d 6i d 6} | d& k r0 i } n t j t d | i � � }
t d |
| � |
r� t t B} t t j |
� � } | | }
|
r� d j
|
� } i | d 6Sn | s� t d } n y t j
j j | d
| �} Wng t k
r} t | d <d j
| | � | d <| St k
rJ} t | d <d
j
| | � | d <| SXd } |
j d i � | |
d k r�|
d | | k r�t | d <d j
| � | d <| Sn | |
d | <t d � t j |
� D� � � t d � t j |
� D� � } t d | d | d | d | d | d | �� d � k rTt | d <d j
� d � | d <| S� d r�t � � f d � t D� � } | � k r�t | d <d j
| � | d <| Sd } n d& } d } d � } d j t j | | � j t � | � � j t � � � } t d rYd& | d <d j
| | � | d <| d c d! j
| � 7<i | d" 6| d <| St d# | | d |
d | d | d | d | �� d � k r�t | d <d$ j
| � d � | d <| St | d <d% j
| | � | d <| d c d! j
| � 7<i | d" 6| d <| S(' u"
Ensure object exists in S3.
name
The name of the state definition.
This will be used to determine the location of the object in S3,
by splitting on the first slash and using the first part
as the bucket name and the remainder as the S3 key.
source
The source file to upload to S3,
currently this only supports files hosted on the minion's local
file system (starting with /).
hash_type
Hash algorithm to use to check that the object contents are correct.
Defaults to the value of the `hash_type` config option.
extra_args
A dictionary of extra arguments to use when uploading the file.
Note that these are only enforced if new objects are uploaded,
and not modified on existing objects.
The supported args are those in the ALLOWED_UPLOAD_ARGS list at
http://boto3.readthedocs.io/en/latest/reference/customizations/s3.html.
However, Note that the 'ACL', 'GrantFullControl', 'GrantRead',
'GrantReadACP', and 'GrantWriteACL' keys are currently not supported.
extra_args_from_pillar
Name of pillar dict that contains extra arguments.
Extra arguments defined for this specific state will be
merged over those from the pillar.
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 u commentu changesu
config.optionu dictupdate.updateu% extra_args keys {0} are not supportedu erroru hash_typet formu resultu" Could not read local file {0}: {1}u" Could not hash local file {0}: {1}u salt_managed_content_hashu Metadatau] Salt uses the {0} metadata key internally,do not pass it to the boto_s3.object_present state.c s@ s- | ]# \ } } | t k r | | f Vq d S( N( t UPLOAD_ONLY_EXTRA_ARGS( t .0t kt v( ( s7 /usr/lib/python2.7/site-packages/salt/states/boto_s3.pys <genexpr>� s c s@ s- | ]# \ } } | t k r | | f Vq d S( N( t GET_METADATA_EXTRA_ARGS( R R R
( ( s7 /usr/lib/python2.7/site-packages/salt/states/boto_s3.pys <genexpr>� s u boto_s3.get_object_metadatat
extra_argst regiont keyt keyidt profileu) Failed to check if S3 object exists: {0}.c 3@ s? | ]5 } | � k r | � d k r | � d | f Vq d S( u resultN( ( R R ( t desired_metadatat r( s7 /usr/lib/python2.7/site-packages/salt/states/boto_s3.pys <genexpr>� s u S3 object {0} is present.u updateu createc S@ s0 d } t d | � } t d | d t d | �S( u>
Safely dump YAML using a readable flow style
u IndentedSafeOrderedDumperu yaml.get_dumperu yaml.dumpt default_flow_stylet Dumper( t __utils__R ( t attrst dumper_namet dumper( ( s7 /usr/lib/python2.7/site-packages/salt/states/boto_s3.pyt _yaml_safe_dump s u testu S3 object {0} set to be {1}d.u
Changes:
{0}u diffu boto_s3.upload_fileu Failed to {0} S3 object: {1}.u S3 object {0} {1}d.N( t Nonet copyt deepcopyR R t STORED_EXTRA_ARGSR t frozensett sixt iterkeyst formatt __opts__t saltt utilst hashutilst get_hasht IOErrorR t
ValueErrort
setdefaultt dictt iteritemst Truet joint difflibt unified_difft
splitlines( t namet sourcet hash_typeR t extra_args_from_pillarR
R R R t rett combined_extra_argst supported_argst combined_extra_args_keyst
extra_keyst msgt digestt et HASH_METADATA_KEYt metadata_extra_argst s3_metadatat actionR t changes_diff( ( R R s7 /usr/lib/python2.7/site-packages/salt/states/boto_s3.pyt object_presentn s� 8
( t __doc__t
__future__R R R R R. t loggingt salt.ext.sixt extR t salt.utils.hashutilsR# t getLoggert __name__t logR R R R R R RB ( ( ( s7 /usr/lib/python2.7/site-packages/salt/states/boto_s3.pyt <module>2 sL
Mini Shell