Current File : //usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.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
Z d d l m Z
d d l m Z e j e � Z d Z y� d d l Z d d l m Z d d l m Z e e d � r� e
e j � e
e � k r� e � � n e j d
� j e j � e Z Wn e k
r%e Z n Xd � Z! d � Z" d
� Z# d � Z$ d d � Z& d � Z' d � Z( d � Z) d � Z* d � Z+ d d � Z, d d � Z- d d � Z. d � Z/ d � Z0 d � Z1 d d � Z2 d d � Z3 d � Z4 d � Z5 d d � Z6 d � Z7 d! � Z8 d" � Z9 d d# � Z: d$ � Z; d% � Z< d& � Z= d' � Z> d( � Z? d) � Z@ d* � ZA d+ � ZB d, � ZC d- � ZD d S(. u
Apache Libcloud Compute Management
==================================
Connection module for Apache Libcloud Compute management for a full list
of supported clouds, see http://libcloud.readthedocs.io/en/latest/compute/supported_providers.html
Clouds include Amazon EC2, Azure, Google GCE, VMware, OpenStack Nova
.. versionadded:: 2018.3.0
:configuration:
This module uses a configuration profile for one or multiple cloud providers
.. code-block:: yaml
libcloud_compute:
profile_test1:
driver: google
key: service-account@googlecloud.net
secret: /path/to.key.json
profile_test2:
driver: arm
key: 12345
secret: mysecret
:depends: apache-libcloud
i ( t absolute_importt unicode_literalst print_functionN( t LooseVersion( t sixu 2.0.0( t
get_driver( t Nodeu __version__u libcloudc C@ s# t s d j t � } t | f St S( u0
Only load if libcloud libraries exist.
uA A apache-libcloud library with version at least {0} was not found( t HAS_LIBCLOUDt formatt REQUIRED_LIBCLOUD_VERSIONt Falset True( t msg( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyt __virtual__? s
c C@ s t j j j t � d S( N( t saltt utilst compatt pack_dundert __name__( t opts( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyt __init__J s c C@ s� t d d � | } t | d � } | j � } | d =| j d � | d <| j d d � | d <| d d k rz | d =n | j d t � | d <| j d d � | d <| j d d � | d <| | � S( Nu
config.optionu libcloud_computeu driveru keyu secretu secureu hostu port( t __salt__R t copyt gett NoneR ( t profilet configt clst args( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyt _get_driverN s
c K@ sa t d | � } t j j j | � } | j | � } g } x! | D] } | j t | � � q@ W| S( u>
Return a list of nodes
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's list_nodes method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.list_nodes profile1
R ( R R R R t clean_kwargst
list_nodest appendt _simple_node( R t libcloud_kwargst connt nodest rett node( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR ] s
c K@ s� t d | � } t j j j | � } | d k r� g | j � D] } | j | k r= | ^ q= } t | � d k r t d � � q� | j
d | d | � } n | j
| � } g } x! | D] } | j t | � � q� W| S( u�
Return a list of node sizes
:param profile: The profile key
:type profile: ``str``
:param location_id: The location key, from list_locations
:type location_id: ``str``
:param libcloud_kwargs: Extra arguments for the driver's list_sizes method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.list_sizes profile1
salt myminion libcloud_compute.list_sizes profile1 us-east1
R i u Location not foundt locationN(
R R R R R R t list_locationst idt lent
ValueErrort
list_sizesR t _simple_size( R t location_idR" R# t loct locationst sizesR% t size( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR, v s .
c K@ sa t d | � } t j j j | � } | j | � } g } x! | D] } | j t | � � q@ W| S( uY
Return a list of locations for this cloud
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's list_locations method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.list_locations profile1
R ( R R R R R R( R t _simple_location( R R" R# R0 R% R/ ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR( � s
c K@ s7 t d | � } t | j | � | � } | j | | � S( u�
Reboot a node in the cloud
:param node_id: Unique ID of the node to reboot
:type node_id: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's reboot_node method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.reboot_node as-2346 profile1
R ( R t
_get_by_idR t reboot_node( t node_idR R" R# R& ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR5 � s c K@ s7 t d | � } t | j | � | � } | j | | � S( u�
Destroy a node in the cloud
:param node_id: Unique ID of the node to destroy
:type node_id: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's destroy_node method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.destry_node as-2346 profile1
R ( R R4 R t destroy_node( R6 R R" R# R& ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR7 � s c K@ sa t d | � } t j j j | � } | j | � } g } x! | D] } | j t | � � q@ W| S( u[
Return a list of storage volumes for this cloud
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's list_volumes method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.list_volumes profile1
R ( R R R R R t list_volumesR t _simple_volume( R R" R# t volumesR% t volume( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR8 � s
c K@ sy t d | � } t j j j | � } t | j � | � } | j | | � } g } x! | D] } | j t | � � qX W| S( u�
Return a list of storage volumes snapshots for this cloud
:param volume_id: The volume identifier
:type volume_id: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's list_volume_snapshots method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.list_volume_snapshots vol1 profile1
R (
R R R R R R4 R8 t list_volume_snapshotsR t _simple_volume_snapshot( t volume_idR R" R# R; t snapshotsR% t snapshot( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR< � s
c K@ sv t d | � } t j j j | � } | d k rH t | j � | � } n d } | j | | | d d | �} t | � S( u�
Create a storage volume
:param size: Size of volume in gigabytes (required)
:type size: ``int``
:param name: Name of the volume to be created
:type name: ``str``
:param location_id: Which data center to create a volume in. If
empty, undefined behavior will be selected.
(optional)
:type location_id: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's list_volumes method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.create_volume 1000 vol1 profile1
R R@ N(
R R R R R R R4 R( t
create_volumeR9 ( R2 t nameR R. R" R# R' R; ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRA s c K@ s[ t d | � } t j j j | � } t | j � | � } | j | d | | �} t | � S( u<
Create a storage volume snapshot
:param volume_id: Volume ID from which to create the new
snapshot.
:type volume_id: ``str``
:param profile: The profile key
:type profile: ``str``
:param name: Name of the snapshot to be created (optional)
:type name: ``str``
:param libcloud_kwargs: Extra arguments for the driver's create_volume_snapshot method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.create_volume_snapshot vol1 profile1
R RB ( R R R R R R4 R8 t create_volume_snapshotR= ( R> R RB R" R# R; R@ ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRC D s
c K@ sg t d | � } t j j j | � } t | j � | � } t | j � | � } | j | | d | | �S( u?
Attaches volume to node.
:param node_id: Node ID to target
:type node_id: ``str``
:param volume_id: Volume ID from which to attach
:type volume_id: ``str``
:param profile: The profile key
:type profile: ``str``
:param device: Where the device is exposed, e.g. '/dev/sdb'
:type device: ``str``
:param libcloud_kwargs: Extra arguments for the driver's attach_volume method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.detach_volume vol1 profile1
R t device( R R R R R R4 R8 R t
attach_volume( R6 R> R RD R" R# R; R& ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRE c s
c K@ sI t d | � } t j j j | � } t | j � | � } | j | | � S( u�
Detaches a volume from a node.
:param volume_id: Volume ID from which to detach
:type volume_id: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's detach_volume method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.detach_volume vol1 profile1
R ( R R R R R R4 R8 t
detach_volume( R> R R" R# R; ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRF � s c K@ sI t d | � } t j j j | � } t | j � | � } | j | | � S( u�
Destroy a volume.
:param volume_id: Volume ID from which to destroy
:type volume_id: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's destroy_volume method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.destroy_volume vol1 profile1
R ( R R R R R R4 R8 t destroy_volume( R> R R" R# R; ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRG � s c K@ sa t d | � } t j j j | � } t | j � | � } t | j | � | � } | j | | � S( u%
Destroy a volume snapshot.
:param volume_id: Volume ID from which the snapshot belongs
:type volume_id: ``str``
:param snapshot_id: Volume Snapshot ID from which to destroy
:type snapshot_id: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's destroy_volume_snapshot method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.destroy_volume_snapshot snap1 profile1
R ( R R R R R R4 R8 R< t destroy_volume_snapshot( R> t snapshot_idR R" R# R; R@ ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRH � s
c K@ s� t d | � } t j j j | � } | d k rH t | j � | � } n d } | j d | | � } g } x! | D] } | j t
| � � qp W| S( u�
Return a list of images for this cloud
:param profile: The profile key
:type profile: ``str``
:param location_id: The location key, from list_locations
:type location_id: ``str``
:param libcloud_kwargs: Extra arguments for the driver's list_images method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.list_images profile1
R R' N( R R R R R R R4 R( t list_imagesR t
_simple_image( R R. R" R# R' t imagesR% t image( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRJ � s
c K@ sX t d | � } t j j j | � } t | j � | � } t | j | | d | | �� S( u�
Create an image from a node
:param node_id: Node to run the task on.
:type node_id: ``str``
:param name: name for new image.
:type name: ``str``
:param profile: The profile key
:type profile: ``str``
:param description: description for new image.
:type description: ``description``
:param libcloud_kwargs: Extra arguments for the driver's create_image method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.create_image server1 my_image profile1
salt myminion libcloud_compute.create_image server1 my_image profile1 description='test image'
R t description( R R R R R R4 R RK t create_image( R6 RB R RN R" R# R& ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRO � s c K@ sI t d | � } t j j j | � } t | j � | � } | j | | � S( u�
Delete an image of a node
:param image_id: Image to delete
:type image_id: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's delete_image method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.delete_image image1 profile1
R ( R R R R R R4 RJ t delete_image( t image_idR R" R# RM ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRP s c K@ s@ t d | � } t j j j | � } | j | | � } t | � S( u�
Get an image of a node
:param image_id: Image to fetch
:type image_id: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's delete_image method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.get_image image1 profile1
R ( R R R R R t get_imageRK ( RQ R R" R# RM ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRR , s c K@ s^ t d | � } t j j j | � } | j | | � } | j | | | d | | �} t | � S( u�
Copies an image from a source region to the current region.
:param source_region: Region to copy the node from.
:type source_region: ``str``
:param image_id: Image to copy.
:type image_id: ``str``
:param name: name for new image.
:type name: ``str``
:param profile: The profile key
:type profile: ``str``
:param description: description for new image.
:type name: ``str``
:param libcloud_kwargs: Extra arguments for the driver's copy_image method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.copy_image us-east1 image1 'new image' profile1
R RN ( R R R R R RR t
copy_imageRK ( t
source_regionRQ RB R RN R" R# RM t new_image( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRS E s c K@ sa t d | � } t j j j | � } | j | � } g } x! | D] } | j t | � � q@ W| S( uX
List all the available key pair objects.
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's list_key_pairs method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.list_key_pairs profile1
R ( R R R R R t list_key_pairsR t _simple_key_pair( R R" R# t keysR% t key( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRV i s
c K@ s: t d | � } t j j j | � } t | j | | � � S( u�
Get a single key pair by name
:param name: Name of the key pair to retrieve.
:type name: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's get_key_pair method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.get_key_pair pair1 profile1
R ( R R R R R RW t get_key_pair( RB R R" R# ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRZ � s c K@ s: t d | � } t j j j | � } t | j | | � � S( u�
Create a single key pair by name
:param name: Name of the key pair to create.
:type name: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's create_key_pair method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.create_key_pair pair1 profile1
R ( R R R R R RW t create_key_pair( RB R R" R# ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR[ � s c K@ sx t d | � } t j j j | � } t j j | � sB | d k r[ t | j | | | � � St | j
| | | � � Sd S( uZ
Import a new public key from string or a file path
:param name: Key pair name.
:type name: ``str``
:param key: Public key material, the string or a path to a file
:type key: ``str`` or path ``str``
:param profile: The profile key
:type profile: ``str``
:param key_type: The key pair type, either `FILE` or `STRING`. Will detect if not provided
and assume that if the string is a path to an existing path it is a FILE, else STRING.
:type key_type: ``str``
:param libcloud_kwargs: Extra arguments for the driver's import_key_pair_from_xxx method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.import_key_pair pair1 key_value_data123 profile1
salt myminion libcloud_compute.import_key_pair pair1 /path/to/key profile1
R u FILEN( R R R R R t ost patht existsRW t import_key_pair_from_filet import_key_pair_from_string( RB RY R t key_typeR" R# ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyt import_key_pair� s
c K@ sC t d | � } t j j j | � } | j | � } | j | | � S( u�
Delete a key pair
:param name: Key pair name.
:type name: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's import_key_pair_from_xxx method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.delete_key_pair pair1 profile1
R ( R R R R R RZ t delete_key_pair( RB R R" R# RY ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRc � s c K@ s= t j j j | � } t d | � } t | | � } | | � S( u�
Call an extended method on the driver
:param method: Driver's method name
:type method: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_compute.extra ex_get_permissions google container_name=my_container object_name=me.jpg --out=yaml
R ( R R R R R t getattr( t methodR R" R# t connection_method( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyt extra� s c C@ s� g | D] } | j | k r | ^ q } t | � d k rI t d � � n0 t | � d k ry t d j t | � � � � n | d S( u.
Get item from a list by the id field
i u Could not find a matching itemi u The id matched {0} items, not 1( R) R* R+ R ( t
collectionR) t itemt matches( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR4 s ( c C@ s6 i | j d 6| j d 6| j d 6| j d 6| j d 6S( Nu idu nameu sizeu stateu extra( R) RB R2 t stateRg ( R; ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR9 s
c C@ s" i | j d 6| j d 6| j d 6S( Nu idu nameu country( R) RB t country( R' ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR3 " s
c C@ sJ i | j d 6| j d 6| j d 6| j d 6| j d 6| j d 6| j d 6S( Nu idu nameu ramu disku bandwidthu priceu extra( R) RB t ramt diskt bandwidtht priceRg ( R2 ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR- * s
c C@ sh i | j d 6| j d 6t j | j � d 6| j d 6| j d 6| j rV t | j � n i d 6| j d 6S( Nu idu nameu stateu
public_ipsu private_ipsu sizeu extra(
R) RB R t text_typeRk t
public_ipst private_ipsR2 R- Rg ( R& ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR! 6 s
c C@ sX i | j d 6t | d � r% | j n | j d 6| j d 6| j d 6| j d 6| j d 6S( Nu idu nameu sizeu extrau createdu state( R) t hasattrRB R2 Rg t createdRk ( R@ ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyR= B s
"
c C@ s" i | j d 6| j d 6| j d 6S( Nu idu nameu extra( R) RB Rg ( RM ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRK M s
c C@ s6 i | j d 6| j d 6| j d 6| j d 6| j d 6S( Nu nameu fingerprintu
public_keyu private_keyu extra( RB t fingerprintt
public_keyt private_keyRg ( RY ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyRW U s
(E t __doc__t
__future__R R R t loggingt os.pathR\ t salt.utils.argsR t salt.utils.compatt salt.utils.versionsR t
_LooseVersiont salt.extR t getLoggerR t logR t libcloudt libcloud.compute.providersR t libcloud.compute.baseR Rt t __version__t ImportErrort setLevelt CRITICALR R R
R
R R R R R, R( R5 R7 R8 R< RA RC RE RF RG RH RJ RO RP RR RS RV RZ R[ Rb Rc Rg R4 R9 R3 R- R! R= RK RW ( ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_compute.pyt <module> sl *
% ' ! $ '
Mini Shell