o

�N�gbN�
@s�
dZd
dl
Z
e
�e�
Zddi
Zzd
dlm
m
m	Z

dZWney3
Z

zdZWYdZ
[
ndZ
[
w
wdZdd	�ZdId
d�
ZdJd
d�
ZdKdd�
ZdIdd�
ZdLdd�
ZdIdd�
ZdMdd�
ZdNdd�
ZdIdd�
ZdIdd �
ZdId!d"�
ZdId#d$�
ZdId%d&�
Z	
	
	
	'	dOd(d)�
ZdId*d+�
ZdId,d-�
ZdPd.d/�
Z dId0d1�
Z!dKd2d3�
Z"	dPd4d5�
Z#	dQd6d7�
Z$dId8d�
Z%dId9d:�
Z&dId;d<�
Z'dId=d>�
Z(dId?d@�
Z)dIdAdB�
Z*dIdCdD�
Z+dIdEdF�
Z,dIdGdH�
Z-dS)Ra
	
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)
�N�list_�listTF�novac
CstS)
zH
    Only load this module if nova
    is installed on this minion.
    )
�HAS_NOVA�rr�E/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/nova.py�__virtual__Zsrc

Cs0
|r7td
|�
}
|
d}|
d}|
d}|
d}|
�
dd�}|
�
dd�}|
�
d	d�}|
�
d
d�}	|
�
dd�}
n6td
d�
}td
d�
}td
d�
}td
d�
}td
d�
}td
d�
}td
d	�
}td
d
�
}	td
d�
}
|	d
ur�|
d}|
d}||||||	|
||d�	}
n
|||||||d�}
tjdi|
�
�
S)z!
    Set up nova credentials
    z
config.optionz
keystone.userzkeystone.passwordzkeystone.tenantzkeystone.auth_urlzkeystone.region_nameNzkeystone.api_keyzkeystone.os_auth_systemzkeystone.use_keystoneauthFzkeystone.verifyTzkeystone.project_domain_namezkeystone.user_domain_name)	�username�password�
project_id�auth_url�region_name�use_keystoneauth�verify�project_domain_name�user_domain_name)r	r
�api_keyrrr
Zos_auth_pluginr)Z__salt__�get�suonZSaltNova)�profileZcredentials�userr
Ztenantrr
rZos_auth_systemrrrr�kwargsrrr�_authbsT



























�






�
r�,
cC�t|�
}|�
||
||�S)
a�
    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�boot)�name�	flavor_id�image_idr�timeout�connrrrr�s!
rcCst|
�
}|j
|d
�
S)a

    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

    )
�search_opts)r�volume_list)r!rr rrrr"�s
r"cC�t|
�
}|�
|�
S)
z�
    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�volume_show�rrr rrrr$��

r$�dcCst|�
}|�
||
||�S)
aq

    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�
volume_create)r�sizeZsnapshotZvoltyperr rrrr(�s
r(cCr#)
z�
    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�
volume_deleter%rrrr*
r&r*cCst|
�
}|�
||�S)
a*

    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�
volume_detach)rrrr rrrr+
s
r+�	/dev/xvdbcCr)
a�

    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�
volume_attach)rZserver_nameZdevicerrr rrrr-3
s
r-cCr#)
z�
    Suspend an instance

    instance_id
        ID of the instance to be suspended

    CLI Example:

    .. code-block:: bash

        salt '*' nova.suspend 1138

    )r�suspend�Zinstance_idrr rrrr.O
�

r.cCr#)
z�
    Resume an instance

    instance_id
        ID of the instance to be resumed

    CLI Example:

    .. code-block:: bash

        salt '*' nova.resume 1138

    )r�resumer/rrrr1a
r0r1cCr#)
z�
    Lock an instance

    instance_id
        ID of the instance to be locked

    CLI Example:

    .. code-block:: bash

        salt '*' nova.lock 1138

    )r�lockr/rrrr2s
r0r2cCr#)
z�
    Delete an instance

    instance_id
        ID of the instance to be deleted

    CLI Example:

    .. code-block:: bash

        salt '*' nova.delete 1138

    )r�deleter/rrrr3�
r0r3c
C�t|�
}
|
�
�S)
z�
    Return a list of available flavors (nova flavor-list)

    CLI Example:

    .. code-block:: bash

        salt '*' nova.flavor_list
    )r�flavor_list�rr rrrr5�
�

r5�
cCst|�
}|�
||
|||�S)
a�

    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�
flavor_create)rrZramZdiskZvcpusrr rrrr9�
s
r9cCr#)
z�
    Delete a flavor from nova by id (nova flavor-delete)

    CLI Example:

    .. code-block:: bash

        salt '*' nova.flavor_delete 7
    )r�
flavor_delete)rrr rrrr:�
�


r:c
Cr4)
z�
    Return a list of available keypairs (nova keypair-list)

    CLI Example:

    .. code-block:: bash

        salt '*' nova.keypair_list
    )r�keypair_listr6rrrr<�
r7r<cC�t|�
}|�
||
|�S)
z�
    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�keypair_add)rZpubfileZpubkeyrr rrrr>�
s
r>cCr#)
z�
    Add a keypair to nova (nova keypair-delete)

    CLI Example:

    .. code-block:: bash

        salt '*' nova.keypair_delete mykey
    )r�keypair_deleter%rrrr?�
r;r?cCr#)
a

    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�
image_listr%rrrr@�
s

r@cKst|�
}|j
||
fi|�
�
S)
a#

    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�image_meta_set)rrrrr rrrrAs

rAcCr=)
a'

    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�image_meta_delete)rr�keysrr rrrrB s
rBc

Cs
t|d
�
S)z�
    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)
�server_listrDrrrr2�
c
Cr4)
zv
    Return list of active servers

    CLI Example:

    .. code-block:: bash

        salt '*' nova.server_list
    )rrEr6rrrrE@r7rEcCs
t||
�S)
z�
    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
    )
�server_show)�	server_idrrrr�showNrFrIc
Cr4)
z�
    Return detailed list of active servers

    CLI Example:

    .. code-block:: bash

        salt '*' nova.server_list_detailed
    )r�server_list_detailedr6rrrrJ\r7rJcCr#)
z�
    Return detailed information for an active server

    CLI Example:

    .. code-block:: bash

        salt '*' nova.server_show <server_id>
    )rrG)rHrr rrrrGjr;rGcCst|�
}|�
||
�S)
z�
    Add a secgroup to nova (nova secgroup-create)

    CLI Example:

    .. code-block:: bash

        salt '*' nova.secgroup_create mygroup 'This is my security group'
    )r�secgroup_create)r�descriptionrr rrrrKxs

rKcCr#)
z�
    Delete a secgroup to nova (nova secgroup-delete)

    CLI Example:

    .. code-block:: bash

        salt '*' nova.secgroup_delete mygroup
    )r�secgroup_deleter%rrrrM�r;rMc
Cr4)
z�
    Return a list of available security groups (nova items-list)

    CLI Example:

    .. code-block:: bash

        salt '*' nova.secgroup_list
    )r�
secgroup_listr6rrrrN�r7rNcCr#)
z�
    Return information about a server

    name
        Server Name

    CLI Example:

    .. code-block:: bash

        salt '*' nova.server_by_name myserver profile=openstack
    )r�server_by_namer%rrrrO�s

rO)
N)r
r
Nr)NN)r'NNN)Nr)r,Nr)r
r
r
r8N)NNN)NNNN).�__doc__�logging�	getLogger�__name__�logZ__func_alias__Zsalt.utils.openstack.nova�utilsZ	openstackrrr�	NameError�excZ__virtualname__rrrr"r$r(r*r+r-r.r1r2r3r5r9r:r<r>r?r@rArBrrErIrJrGrKrMrNrOrrrr�<module>
sdF



��

7
%














�
!




�
�