Current File : //proc/227033/root/lib/python2.7/site-packages/salt/cloud/clouds/linode.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 Z d d l
j Z d d l m
Z
d d l m Z d d l m Z m Z m Z m Z e j e � Z e e j e j j � j � � � a i i d d 6d d
6d 6i d d 6d
d
6d 6i d d 6d d
6d 6i d d 6d d
6d 6i d d 6d d
6d 6i d d 6d d
6d 6i d d 6d d
6d 6Z d Z d � Z d � Z d d � Z" d d! � Z# d d" � Z$ d d d d# � Z% d d d$ � Z& d% � Z' d d d& � Z( d d' � Z) d d( � Z* d d d d) � Z+ d* � Z, d d+ � Z- d d d, � Z. d- � Z/ d. � Z0 d/ � Z1 d0 � Z2 d d1 � Z3 d d d2 � Z4 d3 � Z5 d4 � Z6 d5 � Z7 d d d6 � Z8 d7 � Z9 d8 � Z: d9 � Z; d: � Z< d; � Z= d d< � Z> d d= � Z? d d> � Z@ d d? � ZA d d@ � ZB d dA � ZC d d dB � ZD d dC � ZE d dD � ZF d dE � ZG dF � ZH eI dG � ZJ d d d dH d d dI dJ � ZK dK eL dL � ZM d dK eL dM � ZN dN � ZO dO � ZP dP � ZQ dQ � ZR d S(R u%
Linode Cloud Module using Linode's REST API
===========================================
The Linode cloud module is used to control access to the Linode VPS system.
Use of this module only requires the ``apikey`` parameter. However, the default root password for new instances
also needs to be set. The password needs to be 8 characters and contain lowercase, uppercase, and numbers.
Set up the cloud configuration at ``/etc/salt/cloud.providers`` or ``/etc/salt/cloud.providers.d/linode.conf``:
.. code-block:: yaml
my-linode-provider:
apikey: f4ZsmwtB1c7f85Jdu43RgXVDFlNjuJaeIYV8QMftTqKScEB2vSosFSr...
password: F00barbaz
driver: linode
linode-profile:
provider: my-linode-provider
size: Linode 1024
image: CentOS 7
location: London, England, UK
i ( t absolute_importt print_functiont unicode_literalsN( t six( t range( t SaltCloudConfigErrort SaltCloudExceptiont SaltCloudNotFoundt SaltCloudSystemExiti����u codeu Boot Failed (not in use)u descru boot_failedi����u
Being Createdu beeing_createdu Brand Newu brand_newi u Runningu runningi u Powered Offu poweroffi u Shutting Down (not in use)u shutdowni u Saved to Disk (not in use)u save_to_disku linodec C@ s t � t k r t St S( u#
Check for Linode configs.
( t get_configured_providert Falset __virtualname__( ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt __virtual__Y s c C@ s t j t t p t d � S( u/
Return the first configured instance.
u apikeyu password( u apikeyu password( t configt is_provider_configuredt __opts__t __active_provider_name__R ( ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyR c s c C@ s] | d k r t d � � n t d d � } i } x& | d D] } | d } | | | <q; W| S( u�
Return available Linode images.
CLI Example:
.. code-block:: bash
salt-cloud --list-images my-linode-config
salt-cloud -f avail_images my-linode-config
u actionu? The avail_images function must be called with -f or --function.u availu
distributionsu DATAu LABEL( R t _query( t callt responset rett itemt name( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt avail_imagesn s
c C@ s] | d k r t d � � n t d d � } i } x& | d D] } | d } | | | <q; W| S( u�
Return available Linode datacenter locations.
CLI Example:
.. code-block:: bash
salt-cloud --list-locations my-linode-config
salt-cloud -f avail_locations my-linode-config
u actionuB The avail_locations function must be called with -f or --function.u availu datacentersu DATAu LOCATION( R R ( R R R R R ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt avail_locations� s
c C@ s] | d k r t d � � n t d d � } i } x& | d D] } | d } | | | <q; W| S( u�
Return available Linode sizes.
CLI Example:
.. code-block:: bash
salt-cloud --list-sizes my-linode-config
salt-cloud -f avail_sizes my-linode-config
u actionuB The avail_locations function must be called with -f or --function.u availu LinodePlansu DATAu LABEL( R R ( R R R R R ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt avail_sizes� s
c
C@ s� | d k r' | d k r' t d � � n | d k r< i } n | j d d � } | j d d � } | j d t � } | d k r� | j d d � } n | d k r� | d k r� t d � � n | d k r� t d � � n | d k r� t | � } | } n | } | t k rIt d
i | d 6� d } | d k rIt d
j | � � � qIn t d d d i | d 6| d 6�d } | d } t | | � s�t j
d | � t St S( u3
Boot a Linode.
name
The name of the Linode to boot. Can be used instead of ``linode_id``.
linode_id
The ID of the Linode to boot. If provided, will be used as an
alternative to ``name`` and reduces the number of API calls to
Linode by one. Will be preferred over ``name``.
config_id
The ID of the Config to boot. Required.
check_running
Defaults to True. If set to False, overrides the call to check if
the VM is running before calling the linode.boot API call. Change
``check_running`` to True is useful during the boot call in the
create function, since the new VM will not be running yet.
Can be called as an action (which requires a name):
.. code-block:: bash
salt-cloud -a boot my-instance config_id=10
...or as a function (which requires either a name or linode_id):
.. code-block:: bash
salt-cloud -f boot my-linode-config name=my-instance config_id=10
salt-cloud -f boot my-linode-config linode_id=1225876 config_id=10
u actionu" The boot action requires a 'name'.u linode_idu config_idu
check_runningu functionu nameu< The boot function requires either a 'name' or a 'linode_id'.u) The boot function requires a 'config_id'.t kwargsu STATUSu 1u6 Cannot boot Linode {0}. Linode {0} is already running.u linodeu boott argsu LinodeIDu ConfigIDu DATAu JobIDu Boot failed for Linode %s.N( t NoneR t gett Truet get_linode_id_from_namet
get_linodet formatR t
_wait_for_jobt logt errorR
(
R R R t linode_idt config_idt
check_runningt linode_itemt statusR t boot_job_id( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt boot� sD "
c C@ s� | d k r t d � � n | d
k r0 i } n | j d d
� } | j d d
� } | j d d
� } | | | g } x) | D]! } | d
k r| t d � � q| q| Wi | d 6| d 6| d 6} t d
d d | �S( u�
Clone a Linode.
linode_id
The ID of the Linode to clone. Required.
datacenter_id
The ID of the Datacenter where the Linode will be placed. Required.
plan_id
The ID of the plan (size) of the Linode. Required.
CLI Example:
.. code-block:: bash
salt-cloud -f clone my-linode-config linode_id=1234567 datacenter_id=2 plan_id=5
u actionu8 The clone function must be called with -f or --function.u linode_idu
datacenter_idu plan_iduY The clone function requires a 'linode_id', 'datacenter_id', and 'plan_id' to be provided.u LinodeIDu DatacenterIDu PlanIDu linodeu cloneR N( R R R R ( R R R% t
datacenter_idt plan_idt required_paramsR t
clone_args( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt clone s$
c C@ s� | d } y= | d rF t j t t p) d | d d | �t k rF t SWn t k
rZ n Xt | � t k rq t St d d d d j | � d t d
d | d d d d
g � d t d d t d �t j
d | � i } i | d 6} dJ } | j d � } | r%| | d <t
d i | d 6� } n dJ } | j d � } | rmy t | � } Wqmt k
rid } qmXn | j d � } | r�t n t } | rwt | � }
t d i |
d 6� } i | d 6d j | � d 6} | dJ k r | d } | | d <| d } n | dJ k r| d } n y( t d i |
d 6| d 6| d 6� } Wq�t k
rs}
t j d! | |
d" t j �t SXnh | d | d <y' t d d# d i | d 6| d 6�} Wn0 t k
r�}
t j d$ | |
d" t j �t SXd% | k rx- | d% D] } t j d& | | d' � t SWn t d d d( d) j | � d t d
d* | d d d d
g � d t d d t d �t | � d+ } | | d, <t | d- t d. � �s�t j d/ | d" t j �n t | d0 i | d1 6�t j d2 | | � t | � } | rt | � n t | � } | d3 k r<| t k r<t | � t } n | r_t! d i | d 6� d4 } ne t j d5 | � t" | | � d6 } t# | | � d6 } t$ d i | d 6| d 6| d7 6| d8 6� d9 } t% d i | d 6| d4 6t d: 6� t d i | d 6� } t& | � } t' | d; � } | d | d <| | d <| | d <t( | � | d< <| d3 | d3 <| d= | d= <| d3 k r�| d3 d> | d? <n | d= d> | d? <t) | � | d@ <| d= | d= <| d3 | d3 <t d d dA dB j | � d t d d i | d? dC 6d t d �t dD | t � } | j* | � t j
dE | � t j dF | t+ j, | � � t d d dG dH j | � d t d
dI | d d d d
g � d t d d t d �| S(K u$
Create a single Linode VM.
u nameu profileu linodet vm_u cloud.fire_eventu eventu starting createu salt/cloud/{0}/creatingR u cloud.filter_eventu creatingu provideru drivert sock_diru sock_dirt transportu transportu Creating Cloud VM %su sizeR u labelu locationi u clonefromu linode_idu Clone of {0}u imageu TOTALRAMu PLANIDu DATACENTERIDu
datacenter_idu plan_iduz Error cloning '%s' on Linode.
The following exception was thrown by Linode when trying to clone the specified machine:
%st exc_info_on_loglevelu createuw Error creating %s on Linode
The following exception was thrown by Linode when trying to run the initial deployment:
%su
ERRORARRAYuG Error creating %s on Linode
The Linode API returned the following: %s
u ERRORMESSAGEu requesting instanceu salt/cloud/{0}/requestingu
requestingu LinodeIDu idR) u brand_newuC Error creating %s on LINODE
while waiting for initial ready statust update_argsu Labelu Set name for %s - was linode%s.u private_ipsu config_idu Creating disks for %su DiskIDu root_disk_idu swap_disk_idu ConfigIDu
check_runningu STATUSu stateu
public_ipsi u ssh_hostu passwordu waiting for sshu salt/cloud/{0}/waiting_for_sshu
ip_addressu cloud.bootstrapu Created Cloud VM '%s'u '%s' VM creation details:
%su created instanceu salt/cloud/{0}/createdu createdN(- R
t is_profile_configuredR R R
t AttributeErrort _validate_namet __utils__R! R# t infoR R t get_plan_idt get_datacenter_idt KeyErrorR R R R0 t ExceptionR$ t loggingt DEBUGR t _clean_datat _wait_for_statust _get_status_id_by_namet
update_linodet debugt get_private_ipt create_private_ipt _get_ssh_interfacet
get_config_idt create_disk_from_distrot create_swap_diskt
create_configR+ t get_ipst intt _get_status_descr_by_idt get_passwordt updatet pprintt pformat( R1 R t dataR R- t sizeR, t locationt clonefrom_namet cloningR% t clone_sourcet resultt errt
error_datat node_idt private_ip_assignmentt
ssh_interfaceR& t root_disk_idt swap_disk_idt node_datat ipst stateR ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt createC s
"
"
"
c
C@ sf | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | j d d � } | j d d � } | j d d � } | d k r� d } n | | | | g } x) | D]! } | d k r� t d
� � q� q� Wd j | | � }
| d k r%d j | | | � }
n i | d
6| d 6| d 6|
d 6} t d d d | �} t | � S( u
Creates a Linode Configuration Profile.
name
The name of the VM to create the config for.
linode_id
The ID of the Linode to create the configuration for.
root_disk_id
The Root Disk ID to be used for this config.
swap_disk_id
The Swap Disk ID to be used for this config.
data_disk_id
The Data Disk ID to be used for this config.
.. versionadded:: 2016.3.0
kernel_id
The ID of the kernel to use for this configuration profile.
u actionu@ The create_config function must be called with -f or --function.u nameu linode_idu root_disk_idu swap_disk_idu data_disk_idu kernel_idi� u_ The create_config functions requires a 'name', 'linode_id', 'root_disk_id', and 'swap_disk_id'.u {0},{1}u {0},{1},{2}u LinodeIDu KernelIDu Labelu DiskListu linodeu
config.createR N( R R R R! R RA (
R R R R% R` Ra t data_disk_idt kernel_idR. R t disklistt config_argsRZ ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRL s6
c C@ s� i } | d k r! t | � } n t | � } t | � } | rV | j i | d 6� n | rs | j i | d 6� n t d � � | j i | d 6t | � d 6| d d 6t | | | � d 6� t d d
d | �} t | � S(
u
Creates the disk for the Linode from the distribution.
vm\_
The VM profile to create the disk for.
linode_id
The ID of the Linode to create the distribution disk for. Required.
swap_size
The size of the disk, in MB.
u
rootSSHKeyu rootPassu& The Linode driver requires a password.u LinodeIDu DistributionIDu nameu Labelu Sizeu linodeu disk.createfromdistributionR N(
R t
get_swap_sizet get_pub_keyRP RQ R t get_distribution_idt
get_disk_sizeR RA ( R1 R% t swap_sizeR t pub_keyt
root_passwordRZ ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRJ ^ s"
c C@ sg i } | s t | � } n | j i | d 6| d d 6d d 6| d 6� t d d d | �} t | � S(
u�
Creates the disk for the specified Linode.
vm\_
The VM profile to create the swap disk for.
linode_id
The ID of the Linode to create the swap disk for.
swap_size
The size of the disk, in MB.
u LinodeIDu nameu Labelu swapu Typeu Sizeu linodeu disk.createR ( Rj RQ R RA ( R1 R% Rn R RZ ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRK � s
c C@ sV i } | j i | d 6| d d d 6d d 6| d 6� t d d d
| �} t | � S( u1
Create a data disk for the linode (type is hardcoded to ext4 at the moment)
.. versionadded:: 2016.3.0
vm\_
The VM profile to create the data disk for.
linode_id
The ID of the Linode to create the data disk for.
data_size
The size of the disk, in MB.
u LinodeIDu nameu _datau Labelu ext4u Typeu Sizeu linodeu disk.createR ( RQ R RA ( R1 R% t data_sizeR RZ ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt create_data_disk� s c C@ s, i | d 6} t d d d | �} t | � S( u�
Creates a private IP for the specified Linode.
linode_id
The ID of the Linode to create the IP address for.
u LinodeIDu linodeu
ip.addprivateR ( R RA ( R% R RZ ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRG � s
c C@ s | d k r t d � � n t d d d d j | � d i | d 6d t d
d t d �t | � } t d
d d i | d 6t d 6�} t d d d d j | � d i | d 6d t d
d t d �t j d t � t k rt d | t j
d � d t � n | S( u�
Destroys a Linode by name.
name
The name of VM to be be destroyed.
CLI Example:
.. code-block:: bash
salt-cloud -d vm_name
u functionuE The destroy action must be called with -d, --destroy, -a or --action.u cloud.fire_eventu eventu destroying instanceu salt/cloud/{0}/destroyingR u nameR2 u sock_dirR3 u transportu linodeu deleteu LinodeIDu
skipChecksu destroyed instanceu salt/cloud/{0}/destroyedu update_cachediru cloud.delete_minion_cachediru :i ( R R9 R! R R R R R R
R t split( R R R% R ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt destroy� s,
#
$c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | d k r{ | d k r{ t d � � n | d k r� t | � } n t d d d i | d 6�d
} i | d d d
6} | S( u�
Returns a config_id for a given linode.
.. versionadded:: 2015.8.0
name
The name of the Linode for which to get the config_id. Can be used instead
of ``linode_id``.h
linode_id
The ID of the Linode for which to get the config_id. Can be used instead
of ``name``.
CLI Example:
.. code-block:: bash
salt-cloud -f get_config_id my-linode-config name=my-linode
salt-cloud -f get_config_id my-linode-config linode_id=1234567
u actionu@ The get_config_id function must be called with -f or --function.u nameu linode_iduT The get_config_id function requires either a 'name' or a 'linode_id' to be provided.u linodeu config.listR u LinodeIDu DATAi u ConfigIDu config_idN( R R R R R R ( R R R R% R R& ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRI � s c C@ s t � | d S( u~
Returns the Linode Datacenter ID.
location
The location, or name, of the datacenter to get the ID from.
u DATACENTERID( R ( RV ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyR< ) s c C@ s7 t d i | d 6� d } t j d | t d | | �S( uh
Returns the size of of the root disk in MB.
vm\_
The VM to get the disk size for.
R u linode_idu TOTALHDu disk_sizet default( R R
t get_cloud_config_valueR ( R1 t swapR% t disk_size( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRm 4 s c C@ sE t d i | d 6� d } t j d | t d | | �} | | | S( uS
Return the size of of the data disk in MB
.. versionadded:: 2016.3.0
R u linode_idu TOTALHDu disk_sizeRu ( R R
Rv R ( R1 Rw R% Rx t root_disk_size( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt get_data_disk_sizeA s c
C@ s� t d d � d } t j d | t � } d } x, | D]$ } | | d k r5 | d } | Sq5 W| s� t d j | | d t j t g | D] } | d j t � ^ q� � � � � � n d
S( uf
Returns the distribution ID for a VM
vm\_
The VM to get the distribution ID for
u availu
distributionsu DATAu imageu u LABELu DISTRIBUTIONIDu� The DistributionID for the '{0}' profile could not be found.
The '{1}' instance could not be provisioned. The following distributions are available:
{2}u nameN(
R R
Rv R R R! RR t sortedt encodet __salt_system_encoding__( R1 t
distributionst
vm_image_namet distro_idt distro( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRl N s
c C@ s> | r% t d d d i | d 6�} n t d d � } | d } i } x� | D]� } t j | d � } | d d k r} d } n d
} | j | � d k r� | j i i g d 6g d
6| 6� n | | | j | d � qK W| r:i g d 6g d
6} | j t j | � � } | r1| d
| d
<| d | d <n | } n | S(
u�
Returns public and private IP addresses.
linode_id
Limits the IP addresses returned to the specified Linode ID.
u linodeu ip.listR u LinodeIDu DATAu LINODEIDu ISPUBLICi u
public_ipsu private_ipsu IPADDRESSN( R R t text_typeR R RQ t append( R% Rc R R R] t keyt _all_ipst matching_id( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRM k s*
% c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | d k r{ | d k r{ t d � � n | d k r� t | � } n t d d d i | d 6�} | d
d S(
u
Returns data for a single named Linode.
name
The name of the Linode for which to get data. Can be used instead
``linode_id``. Note this will induce an additional API call
compared to using ``linode_id``.
linode_id
The ID of the Linode for which to get data. Can be used instead of
``name``.
CLI Example:
.. code-block:: bash
salt-cloud -f get_linode my-linode-config name=my-instance
salt-cloud -f get_linode my-linode-config linode_id=1234567
u actionu= The get_linode function must be called with -f or --function.u nameu linode_iduB The get_linode function requires either a 'name' or a 'linode_id'.u linodeu listR u LinodeIDu DATAi N( R R R R R ( R R R R% RZ ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyR � s c C@ sj t d d � d } d } x, | D]$ } | | d k r | d } | Sq W| sf t d j | � � � n d S( u�
Returns the Linode ID for a VM from the provided name.
name
The name of the Linode from which to get the Linode ID. Required.
u linodeu listu DATAu u LABELu LINODEIDu, The specified name, {0}, could not be found.N( R R R! ( R t nodesR% t node( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyR � s
c C@ s4 t j d | t d t j d | t d t �d t �S( uo
Return the password to use for a VM.
vm\_
The configuration to obtain the password from.
u passwordRu u passwdt
search_global( R
Rv R R
( R1 ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRP � s c C@ s@ t � } | | k r4d | k r9 t d j | � � � q4| j � } t | � d k ro t d j | � � � n | d } y t | d � } Wn' t k
r� d } t j d | � n X| d k r� | d k r� d } n | d } d
j | | � } | | k rt d j | � � � n t j d | | � | } n | | d S(
u�
Attempts to decode a user-supplied Linode plan label
into the format in Linode API output
label
The label, or name, of the plan to decode.
Example:
`Linode 2048` will decode to `Linode 2GB`
u GBuQ Invalid Linode plan ({}) specified - call avail_sizes() for all available optionsi i i u7 Failed to decode Linode plan label in Cloud Profile: %su Linodei u Nanodeu {} {}GBu� An outdated Linode plan label was detected in your Cloud Profile (%s). Please update the profile to use the new label format (%s) for the requested Linode plan size.u PLANID(
R R R! Rs t lenRN t TypeErrorR# RE t warning( t labelt sizest plant plan_typet plan_sizet new_label( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt _decode_linode_plan_label� s6
c C@ sm | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n t | � } | S( u�
Returns the Linode Plan ID.
label
The label, or name, of the plan to get the ID from.
CLI Example:
.. code-block:: bash
salt-cloud -f get_plan_id linode label="Linode 1024"
u actionu> The show_instance action must be called with -f or --function.u labelu, The get_plan_id function requires a 'label'.N( R R R R� ( R R R� ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyR; s
c C@ s t j d | t d t �S( u:
Return True if a private ip address is requested
u assign_private_ipRu ( R
Rv R R
( R1 ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRF < s c C@ s t j d | t d t �S( uQ
Return True if a data disk is requested
.. versionadded:: 2016.3.0
u allocate_data_diskRu ( R
Rv R R
( R1 ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt
get_data_diskE s c C@ s t j d | t d t �S( uc
Return the SSH pubkey.
vm\_
The configuration to obtain the public key from.
u
ssh_pubkeyR� ( R
Rv R R
( R1 ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRk P s c C@ s t j d | t d d �S( u{
Returns the amoutn of swap space to be used in MB.
vm\_
The VM profile to obtain the swap size from.
u swapRu i� ( R
Rv R ( R1 ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRj \ s c C@ sy t j d | t � } t � | d } | j d � rJ | j d d � } n | t | � k r` | St d j | � � � d S( uN
Returns the VM's size.
vm\_
The VM to get the size for.
u sizeu RAMu Linodeu Linode u u, The specified size, {0}, could not be found.N( R
Rv R R t
startswitht replaceRN R R! ( R1 t vm_sizet ram( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt get_vm_sizeh s c C@ s( | d k r t d � � n t d t � S( u�
Returns a list of linodes, keeping only a brief listing.
CLI Example:
.. code-block:: bash
salt-cloud -Q
salt-cloud --query
salt-cloud -f list_nodes my-linode-config
.. note::
The ``image`` label only displays information about the VM's distribution vendor,
such as "Debian" or "RHEL" and does not display the actual image name. This is
due to a limitation of the Linode API.
u actionu= The list_nodes function must be called with -f or --function.t full( R t
_list_linodesR
( R ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt
list_nodes} s c C@ s( | d k r t d � � n t d t � S( u�
List linodes, with all available information.
CLI Example:
.. code-block:: bash
salt-cloud -F
salt-cloud --full-query
salt-cloud -f list_nodes_full my-linode-config
.. note::
The ``image`` label only displays information about the VM's distribution vendor,
such as "Debian" or "RHEL" and does not display the actual image name. This is
due to a limitation of the Linode API.
u actionuB The list_nodes_full function must be called with -f or --function.R� ( R R� R ( R ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt list_nodes_full� s c C@ s� | d k r t d � � n i } t d d � d } xS | D]K } | d } i t j | d � d 6t t | d � � d
6} | | | <q; W| S( u�
Return a list of the VMs that are on the provider. Only a list of VM names and
their state is returned. This is the minimum amount of information needed to
check for existing VMs.
.. versionadded:: 2015.8.0
CLI Example:
.. code-block:: bash
salt-cloud -f list_nodes_min my-linode-config
salt-cloud --function list_nodes_min my-linode-config
u actionuA The list_nodes_min function must be called with -f or --function.u linodeu listu DATAu LABELu LINODEIDu idu STATUSu state( R R R R� RO RN ( R R R� R� R t this_node( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt list_nodes_min� s
c C@ s t d t � t d | � S( uP
Return a list of the VMs that are on the provider, with select fields.
u cloud.list_nodes_selectu query.selection( R9 R� R ( R ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt list_nodes_select� s c C@ s� | d k r t d � � n t | � } t d d d i | d 6�} t | � } | d } t | | � s| t j d | � t S| S( u�
Reboot a linode.
.. versionadded:: 2015.8.0
name
The name of the VM to reboot.
CLI Example:
.. code-block:: bash
salt-cloud -a reboot vm_name
u actionu< The show_instance action must be called with -a or --action.u linodeu rebootR u LinodeIDu JobIDu Reboot failed for %s.( R R R RA R" R# R$ R
( R R R] R RT t
reboot_jid( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt reboot� s
c C@ s� | d k r t d � � n t | � } t d i | d 6� } t | � } t | d � } i | d d 6| d d 6| d
d 6| d d
6t | � d 6| d d 6| d d 6} | S( u
Displays details about a particular Linode VM. Either a name or a linode_id must
be provided.
.. versionadded:: 2015.8.0
name
The name of the VM for which to display details.
CLI Example:
.. code-block:: bash
salt-cloud -a show_instance vm_name
.. note::
The ``image`` label only displays information about the VM's distribution vendor,
such as "Debian" or "RHEL" and does not display the actual image name. This is
due to a limitation of the Linode API.
u actionu< The show_instance action must be called with -a or --action.R u linode_idu STATUSu LINODEIDu idu DISTRIBUTIONVENDORu imageu LABELu nameu TOTALRAMu sizeu stateu private_ipsu
public_ips( R R R RM RN RO ( R R R] Rb Rc Rd R ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt
show_instance� s
c C@ sA | d k r t d � � n t d j | d i � } | sJ t d � � n | j d d � } | j d � } t | � d k s� | d
d k r� t d � � n t d
i | d d 6� } t d d d i | d 6�d d } i } | d | d <| d d | d <| d d | d <| d | d <| d d | d <i | | d 6S( u
Show pricing for a particular profile. This is only an estimate, based on
unofficial pricing sources.
.. versionadded:: 2015.8.0
CLI Example:
.. code-block:: bash
salt-cloud -f show_pricing my-linode-config profile=my-linode-profile
u functionu> The show_instance action must be called with -f or --function.u profilesu profileu$ The requested profile was not found.u provideru 0:0u :i i u linodeu0 The requested profile does not belong to Linode.R u sizeu labelu availu linodeplansR u PlanIDu DATAi u HOURLYu per_houri u per_dayi u per_weeku PRICEu per_monthi u per_year( R R R R Rs R� R; R ( R R t profilet providert compsR- R R ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt show_pricing& s*
" $c C@ s� | d k r t d � � n t | � } t d i | d 6� } | d d k rm i t d 6d d 6d d
6d d 6St d
d d i | d 6�d } t | | d � r� i d d
6d d 6t d 6Si d d 6t d 6Sd S( u�
Start a VM in Linode.
name
The name of the VM to start.
CLI Example:
.. code-block:: bash
salt-cloud -a stop vm_name
u actionu4 The start action must be called with -a or --action.R u linode_idu STATUSi u successu startu Runningu stateu Machine already runningu msgu linodeu bootR u LinodeIDu DATAu JobIDN( R R R R R R" R
( R R R] R� R ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt startS s"
c C@ s� | d k r t d � � n t | � } t d i | d 6� } | d d k rf i t d 6d d 6d
d 6St d d
d i | d 6�d } t | | d � r� i d d 6d d 6t d 6Si d d 6t d 6Sd S( u�
Stop a VM in Linode.
name
The name of the VM to stop.
CLI Example:
.. code-block:: bash
salt-cloud -a stop vm_name
u actionu3 The stop action must be called with -a or --action.R u linode_idu STATUSi u successu Stoppedu stateu Machine already stoppedu msgu linodeu shutdownR u LinodeIDu DATAu JobIDu stopN( R R R R R R" R
( R R R] R� R ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt stopy s
c C@ s3 | j i | d 6� t d d d | �} t | � S( u�
Updates a Linode's properties.
linode_id
The ID of the Linode to shutdown. Required.
update_args
The args to update the Linode with. Must be in dictionary form.
u LinodeIDu linodeu updateR ( RQ R RA ( R% R5 RZ ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRD � s
c C@ s; i } | j | d � | s7 | d } | j | � n | S( u�
Returns the DATA response from a Linode API query as a single pre-formatted dictionary
api_response
The query to be cleaned.
u DATA( RQ ( t api_responseRT t
response_data( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRA � s
c
C@ s t d d � d } t � } i } x� | D]� } i } t j | d � } | | d <| d | d <| d | d <| d
| d <t | d � } t | � | d
<xH t j | � D]7 \ } } | | k r� | d | d <| d | d <q� q� W| r� | | d <n | | | d <q) W| S( u9
Helper function to format and parse linode data
u linodeu listu DATAu LINODEIDu idu DISTRIBUTIONVENDORu imageu LABELu nameu TOTALRAMu sizeu STATUSu stateu private_ipsu
public_ipsu extra( R RM R R� RN RO t iteritems(
R� R� Rc R R� R� R% Rd R� t val( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyR� � s(
u GETu https://api.linode.com/c C@ sX t � } t j d | t d t d d �} t j d | t d t �} t | t � s] i } n d | j � k r| | | d <n | r� d | j � k r� d j | | � | d <n | d" k r� i } n | d k r� d
| d <n t
}
| d k r� t }
n t t j
t j j � j � � � } t | k r6t j | � n t d
| | d | d | d | d |
d d d t
d t
d d d g d t � } d | d k r| d d rg }
xH | d d D]8 } | d } | d k r�t d � � q�|
j | � q�Wt d j d j |
� � � � qn t t j
t j j � j � � � a t j d | d! � | d S(# u,
Make a web call to the Linode API.
u ratelimit_sleepR� Ru i u apikeyu api_keyu
api_actionu {0}.{1}u POSTu application/jsonu Acceptu DELETEu
http.queryt paramsRT t header_dictt decodet decode_typeu jsont textR) t hide_fieldsu rootPasst optsu
ERRORARRAYu dictu ERRORMESSAGEu Authentication failedu$ Linode API Key is expired or invalidu Linode API reported error(s): {}u , u Linode Response Status Code: %su statusN( R R
Rv R R
t
isinstancet dictt keysR! R R RN t timet mktimet datetimet nowt timetuplet LASTCALLt sleepR9 R R� R t joinR# RE ( t actiont commandR t methodR� RT t urlR1 t ratelimit_sleept apikeyR� R� RZ t
error_listR$ t msg( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyR � s^
$
!$i, c C@ s� d } t | | � } x� t d | � D]� } t d d d i | d 6�d } | d d | k rx | d d d
k rx t St j | � t j | s� t j n t j d | | � q& Wt
S( u8
Wait for a Job to return.
linode_id
The ID of the Linode to wait on. Required.
job_id
The ID of the job to wait for.
timeout
The amount of time to wait for a status to update.
quiet
Log status updates to debug logs when True. Otherwise, logs to info.
i i u linodeu job.listR u LinodeIDu DATAu JOBIDu HOST_SUCCESSi u& Still waiting on Job %s for Linode %s.( RN R R R R� R� R# R? t INFOR@ R
( R% t job_idt timeoutt quiett intervalt
iterationst it jobs_result( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyR" 1 s (
c
C@ s� | d k r t d � } n t | � } d } t | | � } x� t d | � D]x } t d i | d 6� } | d | k r} t St | d � } t j | � t j | s� t
j n t
j d | | | � qM Wt
S( uI
Wait for a certain status from Linode.
linode_id
The ID of the Linode to wait on. Required.
status
The status to look for to update.
timeout
The amount of time to wait for a status to update.
quiet
Log status updates to debug logs when False. Otherwise, logs to info.
u brand_newi i R u linode_idu STATUSu/ Status for Linode %s is '%s', waiting for '%s'.N( R RC RO RN R R R R� R� R# R? R� R@ R
(
R% R) R� R� t status_desc_waitingR� R� R� RZ t status_desc_result( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRB S s
c C@ sN x; t j t � D]* \ } } | d t | � k r | d Sq Wt j | d � S( uO
Return linode status by ID
status_id
linode VM status ID
u codeu descrN( R R� t
LINODE_STATUSRN R R ( t status_idt status_namet status_data( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRO } s c C@ s t j | i � j d d � S( uy
Return linode status description by internalstatus name
status_name
internal linode VM status name
u codeN( R� R R ( R� ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRC � s c C@ s� t j | � } t | � } t j d � } | d k sB | d k rK t } n! t j | | � sf t } n t } | t k r� t j d � n | S( u�
Checks if the provided name fits Linode's labeling parameters.
.. versionadded:: 2015.5.6
name
The VM name to validate
u& ^[a-zA-Z0-9][A-Za-z0-9_-]*[a-zA-Z0-9]$i i0 u� A Linode label may only contain ASCII letters or numbers, dashes, and underscores, must begin and end with letters or numbers, and be at least three characters in length.(
R R� R� t ret compileR
t matchR R# R� ( R t name_lengtht regexR ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyR8 � s
c C@ s t j d | t d d d t �S( uj
Return the ssh_interface type to connect to. Either 'public_ips' (default)
or 'private_ips'.
u
ssh_interfaceRu u
public_ipsR� ( R
Rv R R
( R1 ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyRH � s (S t __doc__t
__future__R R R R? RR R� R� R� t salt.configR
t salt.extR t salt.ext.six.movesR t salt.exceptionsR R R R t getLoggert __name__R# RN R� R� R� R� R� R R R R R R R R+ R0 Re RL RJ RK Rr RG Rt RI R< Rm Rz Rl RM R R RP R� R; RF R� Rk Rj R� R� R� R� R� R� R� R� R� R� RD RA R
R� R R R" RB RO RC R8 RH ( ( ( s< /usr/lib/python2.7/site-packages/salt/cloud/clouds/linode.pyt <module> s� "$
W0 �B )
/-
(+ 8 # +- & % ! J"*
Mini Shell