Current File : //usr/lib/python2.7/site-packages/salt/modules/nova.pyc
�
���^c @@ sB d Z d d l m Z m Z m Z d d l Z e j e � Z i d d 6Z y d d l
j j j
Z e Z Wn e k
r� Z e Z n Xd � Z i Z d d � Z d d d d d � Z d d d
� Z d d � Z d d d d d
� Z d d � Z d d d � Z d d d d � Z d d � Z d d � Z d d � Z! d d � Z" d d � Z# d d d d d d � Z$ d d � Z% d d � Z& d d d d � Z' d d � Z( d d d � Z) d d d d � Z* d d d d d � Z+ d d � Z, d d! � Z- d d" � Z. d d# � Z/ d d$ � Z0 d d% � Z1 d d& � Z2 d d' � Z3 d d( � Z4 d S() u
Module for handling OpenStack Nova calls
:depends: - novaclient Python module
:configuration: This module is not usable until the user, password, tenant, and
auth URL are specified either in a pillar or in the minion's config file.
For example:
.. code-block:: yaml
keystone.user: admin
keystone.password: verybadpass
keystone.tenant: admin
keystone.auth_url: 'http://127.0.0.1:5000/v2.0/'
# Optional
keystone.region_name: 'RegionOne'
If configuration for multiple OpenStack accounts is required, they can be
set up as different configuration profiles:
For example:
.. code-block:: yaml
openstack1:
keystone.user: admin
keystone.password: verybadpass
keystone.tenant: admin
keystone.auth_url: 'http://127.0.0.1:5000/v2.0/'
openstack2:
keystone.user: admin
keystone.password: verybadpass
keystone.tenant: admin
keystone.auth_url: 'http://127.0.0.2:5000/v2.0/'
With this configuration in place, any of the nova functions can make use of
a configuration profile by declaring it explicitly.
For example:
.. code-block:: bash
salt '*' nova.flavor_list profile=openstack1
To use keystoneauth1 instead of keystoneclient, include the `use_keystoneauth`
option in the pillar or minion config.
.. note::
This is required to use keystone v3 as for authentication.
.. code-block:: yaml
keystone.user: admin
keystone.password: verybadpass
keystone.tenant: admin
keystone.auth_url: 'http://127.0.0.1:5000/v3/'
keystone.use_keystoneauth: true
keystone.verify: '/path/to/custom/certs/ca-bundle.crt'
.. note::
By default the nova module will attempt to verify its connection
utilizing the system certificates. If you need to verify against
another bundle of CA certificates or want to skip verification
altogether you will need to specify the `verify` option. You can
specify True or False to verify (or not) against system certificates, a
path to a bundle or CA certs to check against, or None to allow
keystoneauth to search for the certificates on its own. (defaults to
True)
i ( t absolute_importt unicode_literalst print_functionNu listu list_c C@ s t S( uH
Only load this module if nova
is installed on this minion.
( t HAS_NOVA( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyt __virtual__\ s c C@ s� | r� t d | � } | d } | d } | d } | d } | j d d � } | j d d � } | j d d � } | j d t � } | j d
d � }
n� t d d � } t d d � } t d d � } t d d � } t d d � } t d d � } t d d � } t d d � } t d d
� }
| t k r�| d } | d } i | d
6| d 6| d 6| d 6| d 6| d 6|
d 6| d 6| d 6}
n7 i | d
6| d 6| d 6| d 6| d 6| d 6| d 6}
t j |
� S( u!
Set up nova credentials
u
config.optionu
keystone.useru keystone.passwordu keystone.tenantu keystone.auth_urlu keystone.region_nameu keystone.api_keyu keystone.os_auth_systemu keystone.use_keystoneauthu keystone.verifyu keystone.project_domain_nameu keystone.user_domain_nameu usernameu passwordu
project_idu auth_urlu region_nameu use_keystoneauthu verifyu project_domain_nameu user_domain_nameu api_keyu os_auth_pluginN( t __salt__t gett Nonet Falset Truet suont SaltNova( t profilet credentialst usert passwordt tenantt auth_urlt region_namet api_keyt os_auth_systemt use_keystoneautht verifyt project_domain_namet user_domain_namet kwargs( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyt _authg sT
i, c C@ s" t | � } | j | | | | � S( u�
Boot (create) a new instance
name
Name of the new instance (must be first)
flavor_id
Unique integer ID for the flavor
image_id
Unique integer ID for the image
timeout
How long to wait, after creating the instance, for the provider to
return information about it (default 300 seconds).
.. versionadded:: 2014.1.0
CLI Example:
.. code-block:: bash
salt '*' nova.boot myinstance flavor_id=4596 image_id=2
The flavor_id and image_id are obtained from nova.flavor_list and
nova.image_list
.. code-block:: bash
salt '*' nova.flavor_list
salt '*' nova.image_list
( R t boot( t namet flavor_idt image_idR t timeoutt conn( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR � s ! c C@ s t | � } | j d | � S( u
List storage volumes
search_opts
Dictionary of search options
profile
Profile to use
CLI Example:
.. code-block:: bash
salt '*' nova.volume_list search_opts='{"display_name": "myblock"}' profile=openstack
t search_opts( R t volume_list( R! R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR" � s c C@ s t | � } | j | � S( u�
Create a block storage volume
name
Name of the volume
profile
Profile to use
CLI Example:
.. code-block:: bash
salt '*' nova.volume_show myblock profile=openstack
( R t volume_show( R R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR# � s id c C@ s" t | � } | j | | | | � S( uq
Create a block storage volume
name
Name of the new volume (must be first)
size
Volume size
snapshot
Block storage snapshot id
voltype
Type of storage
profile
Profile to build on
CLI Example:
.. code-block:: bash
salt '*' nova.volume_create myblock size=300 profile=openstack
( R t
volume_create( R t sizet snapshott voltypeR R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR$ � s c C@ s t | � } | j | � S( u�
Destroy the volume
name
Name of the volume
profile
Profile to build on
CLI Example:
.. code-block:: bash
salt '*' nova.volume_delete myblock profile=openstack
( R t
volume_delete( R R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR( s c C@ s t | � } | j | | � S( u*
Attach a block storage volume
name
Name of the new volume to attach
server_name
Name of the server to detach from
profile
Profile to build on
CLI Example:
.. code-block:: bash
salt '*' nova.volume_detach myblock profile=openstack
( R t
volume_detach( R R R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR) & s u /dev/xvdbc C@ s" t | � } | j | | | | � S( u�
Attach a block storage volume
name
Name of the new volume to attach
server_name
Name of the server to attach to
device
Name of the device on the server
profile
Profile to build on
CLI Example:
.. code-block:: bash
salt '*' nova.volume_attach myblock slice.example.com profile=openstack
salt '*' nova.volume_attach myblock server.example.com device=/dev/xvdb profile=openstack
( R t
volume_attach( R t server_namet deviceR R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR* C s c C@ s t | � } | j | � S( u�
Suspend an instance
instance_id
ID of the instance to be suspended
CLI Example:
.. code-block:: bash
salt '*' nova.suspend 1138
( R t suspend( t instance_idR R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR- h s c C@ s t | � } | j | � S( u�
Resume an instance
instance_id
ID of the instance to be resumed
CLI Example:
.. code-block:: bash
salt '*' nova.resume 1138
( R t resume( R. R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR/ z s c C@ s t | � } | j | � S( u�
Lock an instance
instance_id
ID of the instance to be locked
CLI Example:
.. code-block:: bash
salt '*' nova.lock 1138
( R t lock( R. R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR0 � s c C@ s t | � } | j | � S( u�
Delete an instance
instance_id
ID of the instance to be deleted
CLI Example:
.. code-block:: bash
salt '*' nova.delete 1138
( R t delete( R. R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR1 � s c C@ s t | � } | j � S( u�
Return a list of available flavors (nova flavor-list)
CLI Example:
.. code-block:: bash
salt '*' nova.flavor_list
( R t flavor_list( R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR2 � s
i c C@ s% t | � } | j | | | | | � S( u�
Add a flavor to nova (nova flavor-create). The following parameters are
required:
name
Name of the new flavor (must be first)
flavor_id
Unique integer ID for the new flavor
ram
Memory size in MB
disk
Disk size in GB
vcpus
Number of vcpus
CLI Example:
.. code-block:: bash
salt '*' nova.flavor_create myflavor flavor_id=6 ram=4096 disk=10 vcpus=1
( R t
flavor_create( R R t ramt diskt vcpusR R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR3 � s c C@ s t | � } | j | � S( u�
Delete a flavor from nova by id (nova flavor-delete)
CLI Example:
.. code-block:: bash
salt '*' nova.flavor_delete 7
( R t
flavor_delete( R R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR7 � s
c C@ s t | � } | j � S( u�
Return a list of available keypairs (nova keypair-list)
CLI Example:
.. code-block:: bash
salt '*' nova.keypair_list
( R t keypair_list( R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR8 � s
c C@ s t | � } | j | | | � S( u�
Add a keypair to nova (nova keypair-add)
CLI Examples:
.. code-block:: bash
salt '*' nova.keypair_add mykey pubfile=/home/myuser/.ssh/id_rsa.pub
salt '*' nova.keypair_add mykey pubkey='ssh-rsa <key> myuser@mybox'
( R t keypair_add( R t pubfilet pubkeyR R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR9 � s
c C@ s t | � } | j | � S( u�
Add a keypair to nova (nova keypair-delete)
CLI Example:
.. code-block:: bash
salt '*' nova.keypair_delete mykey
( R t keypair_delete( R R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR< s
c C@ s t | � } | j | � S( u
Return a list of available images (nova images-list + nova image-show)
If a name is provided, only that image will be displayed.
CLI Examples:
.. code-block:: bash
salt '*' nova.image_list
salt '*' nova.image_list myimage
( R t
image_list( R R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR= s c K@ s t | � } | j | | | � S( u#
Sets a key=value pair in the metadata for an image (nova image-meta set)
CLI Examples:
.. code-block:: bash
salt '*' nova.image_meta_set 6f52b2ff-0b31-4d84-8fd1-af45b84824f6 cheese=gruyere
salt '*' nova.image_meta_set name=myimage salad=pasta beans=baked
( R t image_meta_set( R R R R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR> 0 s
c C@ s t | � } | j | | | � S( u'
Delete a key=value pair from the metadata for an image
(nova image-meta set)
CLI Examples:
.. code-block:: bash
salt '*' nova.image_meta_delete 6f52b2ff-0b31-4d84-8fd1-af45b84824f6 keys=cheese
salt '*' nova.image_meta_delete name=myimage keys=salad,beans
( R t image_meta_delete( R R t keysR R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyR? F s
c C@ s
t d | � S( u�
To maintain the feel of the nova command line, this function simply calls
the server_list function.
CLI Example:
.. code-block:: bash
salt '*' nova.list
R ( t server_list( R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyt list_] s c C@ s t | � } | j � S( uv
Return list of active servers
CLI Example:
.. code-block:: bash
salt '*' nova.server_list
( R RA ( R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyRA k s
c C@ s
t | | � S( u�
To maintain the feel of the nova command line, this function simply calls
the server_show function.
CLI Example:
.. code-block:: bash
salt '*' nova.show
( t server_show( t server_idR ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyt showy s c C@ s t | � } | j � S( u�
Return detailed list of active servers
CLI Example:
.. code-block:: bash
salt '*' nova.server_list_detailed
( R t server_list_detailed( R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyRF � s
c C@ s t | � } | j | � S( u�
Return detailed information for an active server
CLI Example:
.. code-block:: bash
salt '*' nova.server_show <server_id>
( R RC ( RD R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyRC � s
c C@ s t | � } | j | | � S( u�
Add a secgroup to nova (nova secgroup-create)
CLI Example:
.. code-block:: bash
salt '*' nova.secgroup_create mygroup 'This is my security group'
( R t secgroup_create( R t descriptionR R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyRG � s
c C@ s t | � } | j | � S( u�
Delete a secgroup to nova (nova secgroup-delete)
CLI Example:
.. code-block:: bash
salt '*' nova.secgroup_delete mygroup
( R t secgroup_delete( R R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyRI � s
c C@ s t | � } | j � S( u�
Return a list of available security groups (nova items-list)
CLI Example:
.. code-block:: bash
salt '*' nova.secgroup_list
( R t
secgroup_list( R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyRJ � s
c C@ s t | � } | j | � S( u�
Return information about a server
name
Server Name
CLI Example:
.. code-block:: bash
salt '*' nova.server_by_name myserver profile=openstack
( R t server_by_name( R R R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyRK � s
(5 t __doc__t
__future__R R R t loggingt getLoggert __name__t logt __func_alias__t salt.utils.openstack.novat utilst openstackt novaR
R R t NameErrort excR R t __opts__R R R R" R# R$ R( R) R* R- R/ R0 R1 R2 R3 R7 R8 R9 R< R= R> R? RB RA RE RF RC RG RI RJ RK ( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/nova.pyt <module>F sn
7% # !
Mini Shell