2020-03-09 10:11:07 +01:00
|
|
|
#!/usr/bin/python
|
|
|
|
# Copyright: Ansible Project
|
|
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
|
|
__metaclass__ = type
|
|
|
|
|
|
|
|
DOCUMENTATION = '''
|
|
|
|
---
|
|
|
|
module: proxmox
|
|
|
|
short_description: management of instances in Proxmox VE cluster
|
|
|
|
description:
|
|
|
|
- allows you to create/delete/stop instances in Proxmox VE cluster
|
|
|
|
- Starting in Ansible 2.1, it automatically detects containerization type (lxc for PVE 4, openvz for older)
|
2020-10-30 13:15:25 +01:00
|
|
|
- From community.general 4.0.0 on, there will be no default values, see I(proxmox_default_behavior).
|
2020-03-09 10:11:07 +01:00
|
|
|
options:
|
|
|
|
api_host:
|
|
|
|
description:
|
|
|
|
- the host of the Proxmox VE cluster
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
required: true
|
|
|
|
api_user:
|
|
|
|
description:
|
|
|
|
- the user to authenticate with
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
required: true
|
|
|
|
api_password:
|
|
|
|
description:
|
|
|
|
- the password to authenticate with
|
|
|
|
- you can use PROXMOX_PASSWORD environment variable
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-11-16 21:24:11 +01:00
|
|
|
api_token_id:
|
|
|
|
description:
|
|
|
|
- Specify the token ID.
|
|
|
|
type: str
|
|
|
|
version_added: 1.3.0
|
|
|
|
api_token_secret:
|
|
|
|
description:
|
|
|
|
- Specify the token secret.
|
|
|
|
type: str
|
|
|
|
version_added: 1.3.0
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid:
|
|
|
|
description:
|
|
|
|
- the instance id
|
|
|
|
- if not set, the next available VM ID will be fetched from ProxmoxAPI.
|
|
|
|
- if not set, will be fetched from PromoxAPI based on the hostname
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
validate_certs:
|
|
|
|
description:
|
|
|
|
- enable / disable https certificate verification
|
|
|
|
type: bool
|
|
|
|
default: 'no'
|
|
|
|
node:
|
|
|
|
description:
|
|
|
|
- Proxmox VE node, when new VM will be created
|
|
|
|
- required only for C(state=present)
|
|
|
|
- for another states will be autodiscovered
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
pool:
|
|
|
|
description:
|
|
|
|
- Proxmox VE resource pool
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
password:
|
|
|
|
description:
|
|
|
|
- the instance root password
|
|
|
|
- required only for C(state=present)
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
hostname:
|
|
|
|
description:
|
|
|
|
- the instance hostname
|
|
|
|
- required only for C(state=present)
|
|
|
|
- must be unique if vmid is not passed
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
ostemplate:
|
|
|
|
description:
|
|
|
|
- the template for VM creating
|
|
|
|
- required only for C(state=present)
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
disk:
|
|
|
|
description:
|
|
|
|
- hard disk size in GB for instance
|
2020-10-30 13:15:25 +01:00
|
|
|
- If I(proxmox_default_behavior) is set to C(compatiblity) (the default value), this
|
|
|
|
option has a default of C(3). Note that the default value of I(proxmox_default_behavior)
|
|
|
|
changes in community.general 4.0.0.
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
cores:
|
|
|
|
description:
|
|
|
|
- Specify number of cores per socket.
|
2020-10-30 13:15:25 +01:00
|
|
|
- If I(proxmox_default_behavior) is set to C(compatiblity) (the default value), this
|
|
|
|
option has a default of C(1). Note that the default value of I(proxmox_default_behavior)
|
|
|
|
changes in community.general 4.0.0.
|
2020-09-01 13:44:04 +02:00
|
|
|
type: int
|
2020-03-09 10:11:07 +01:00
|
|
|
cpus:
|
|
|
|
description:
|
|
|
|
- numbers of allocated cpus for instance
|
2020-10-30 13:15:25 +01:00
|
|
|
- If I(proxmox_default_behavior) is set to C(compatiblity) (the default value), this
|
|
|
|
option has a default of C(1). Note that the default value of I(proxmox_default_behavior)
|
|
|
|
changes in community.general 4.0.0.
|
2020-09-01 13:44:04 +02:00
|
|
|
type: int
|
2020-03-09 10:11:07 +01:00
|
|
|
memory:
|
|
|
|
description:
|
|
|
|
- memory size in MB for instance
|
2020-10-30 13:15:25 +01:00
|
|
|
- If I(proxmox_default_behavior) is set to C(compatiblity) (the default value), this
|
|
|
|
option has a default of C(512). Note that the default value of I(proxmox_default_behavior)
|
|
|
|
changes in community.general 4.0.0.
|
2020-09-01 13:44:04 +02:00
|
|
|
type: int
|
2020-03-09 10:11:07 +01:00
|
|
|
swap:
|
|
|
|
description:
|
|
|
|
- swap memory size in MB for instance
|
2020-10-30 13:15:25 +01:00
|
|
|
- If I(proxmox_default_behavior) is set to C(compatiblity) (the default value), this
|
|
|
|
option has a default of C(0). Note that the default value of I(proxmox_default_behavior)
|
|
|
|
changes in community.general 4.0.0.
|
2020-09-01 13:44:04 +02:00
|
|
|
type: int
|
2020-03-09 10:11:07 +01:00
|
|
|
netif:
|
|
|
|
description:
|
|
|
|
- specifies network interfaces for the container. As a hash/dictionary defining interfaces.
|
2020-09-01 13:44:04 +02:00
|
|
|
type: dict
|
2020-03-09 10:11:07 +01:00
|
|
|
mounts:
|
|
|
|
description:
|
|
|
|
- specifies additional mounts (separate disks) for the container. As a hash/dictionary defining mount points
|
2020-09-01 13:44:04 +02:00
|
|
|
type: dict
|
2020-03-09 10:11:07 +01:00
|
|
|
ip_address:
|
|
|
|
description:
|
|
|
|
- specifies the address the container will be assigned
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
onboot:
|
|
|
|
description:
|
|
|
|
- specifies whether a VM will be started during system bootup
|
2020-10-30 13:15:25 +01:00
|
|
|
- If I(proxmox_default_behavior) is set to C(compatiblity) (the default value), this
|
|
|
|
option has a default of C(no). Note that the default value of I(proxmox_default_behavior)
|
|
|
|
changes in community.general 4.0.0.
|
2020-03-09 10:11:07 +01:00
|
|
|
type: bool
|
|
|
|
storage:
|
|
|
|
description:
|
|
|
|
- target storage
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
default: 'local'
|
|
|
|
cpuunits:
|
|
|
|
description:
|
|
|
|
- CPU weight for a VM
|
2020-10-30 13:15:25 +01:00
|
|
|
- If I(proxmox_default_behavior) is set to C(compatiblity) (the default value), this
|
|
|
|
option has a default of C(1000). Note that the default value of I(proxmox_default_behavior)
|
|
|
|
changes in community.general 4.0.0.
|
2020-09-01 13:44:04 +02:00
|
|
|
type: int
|
2020-03-09 10:11:07 +01:00
|
|
|
nameserver:
|
|
|
|
description:
|
|
|
|
- sets DNS server IP address for a container
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
searchdomain:
|
|
|
|
description:
|
|
|
|
- sets DNS search domain for a container
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
timeout:
|
|
|
|
description:
|
|
|
|
- timeout for operations
|
2020-09-01 13:44:04 +02:00
|
|
|
type: int
|
2020-03-09 10:11:07 +01:00
|
|
|
default: 30
|
|
|
|
force:
|
|
|
|
description:
|
|
|
|
- forcing operations
|
|
|
|
- can be used only with states C(present), C(stopped), C(restarted)
|
|
|
|
- with C(state=present) force option allow to overwrite existing container
|
|
|
|
- with states C(stopped) , C(restarted) allow to force stop instance
|
|
|
|
type: bool
|
|
|
|
default: 'no'
|
|
|
|
state:
|
|
|
|
description:
|
|
|
|
- Indicate desired state of the instance
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
choices: ['present', 'started', 'absent', 'stopped', 'restarted']
|
|
|
|
default: present
|
|
|
|
pubkey:
|
|
|
|
description:
|
|
|
|
- Public key to add to /root/.ssh/authorized_keys. This was added on Proxmox 4.2, it is ignored for earlier versions
|
2020-09-01 13:44:04 +02:00
|
|
|
type: str
|
2020-03-09 10:11:07 +01:00
|
|
|
unprivileged:
|
|
|
|
description:
|
|
|
|
- Indicate if the container should be unprivileged
|
|
|
|
type: bool
|
|
|
|
default: 'no'
|
2020-05-18 07:17:11 +02:00
|
|
|
description:
|
|
|
|
description:
|
|
|
|
- Specify the description for the container. Only used on the configuration web interface.
|
|
|
|
- This is saved as a comment inside the configuration file.
|
|
|
|
type: str
|
2020-06-13 15:01:19 +02:00
|
|
|
version_added: '0.2.0'
|
2020-05-18 07:17:11 +02:00
|
|
|
hookscript:
|
|
|
|
description:
|
|
|
|
- Script that will be executed during various steps in the containers lifetime.
|
|
|
|
type: str
|
2020-06-13 15:01:19 +02:00
|
|
|
version_added: '0.2.0'
|
2020-10-30 13:15:25 +01:00
|
|
|
proxmox_default_behavior:
|
|
|
|
description:
|
|
|
|
- Various module options used to have default values. This cause problems when
|
|
|
|
user expects different behavior from proxmox by default or fill options which cause
|
|
|
|
problems when they have been set.
|
|
|
|
- The default value is C(compatibility), which will ensure that the default values
|
|
|
|
are used when the values are not explicitly specified by the user.
|
|
|
|
- From community.general 4.0.0 on, the default value will switch to C(no_defaults). To avoid
|
|
|
|
deprecation warnings, please set I(proxmox_default_behavior) to an explicit
|
|
|
|
value.
|
|
|
|
- This affects the I(disk), I(cores), I(cpus), I(memory), I(onboot), I(swap), I(cpuunits) options.
|
|
|
|
type: str
|
|
|
|
choices:
|
|
|
|
- compatibility
|
|
|
|
- no_defaults
|
|
|
|
version_added: "1.3.0"
|
2020-03-09 10:11:07 +01:00
|
|
|
|
|
|
|
notes:
|
|
|
|
- Requires proxmoxer and requests modules on host. This modules can be installed with pip.
|
|
|
|
requirements: [ "proxmoxer", "python >= 2.7", "requests" ]
|
|
|
|
author: Sergei Antipov (@UnderGreen)
|
|
|
|
'''
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
EXAMPLES = r'''
|
|
|
|
- name: Create new container with minimal options
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
node: uk-mc02
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
password: 123456
|
|
|
|
hostname: example.org
|
|
|
|
ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz'
|
|
|
|
|
2020-05-18 07:17:11 +02:00
|
|
|
- name: Create new container with hookscript and description
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-05-18 07:17:11 +02:00
|
|
|
vmid: 100
|
|
|
|
node: uk-mc02
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
password: 123456
|
|
|
|
hostname: example.org
|
|
|
|
ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz'
|
|
|
|
hookscript: 'local:snippets/vm_hook.sh'
|
|
|
|
description: created with ansible
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Create new container automatically selecting the next available vmid.
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
node: 'uk-mc02'
|
|
|
|
api_user: 'root@pam'
|
|
|
|
api_password: '1q2w3e'
|
|
|
|
api_host: 'node1'
|
|
|
|
password: '123456'
|
|
|
|
hostname: 'example.org'
|
|
|
|
ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz'
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Create new container with minimal options with force(it will rewrite existing container)
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
node: uk-mc02
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
password: 123456
|
|
|
|
hostname: example.org
|
|
|
|
ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz'
|
|
|
|
force: yes
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Create new container with minimal options use environment PROXMOX_PASSWORD variable(you should export it before)
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
node: uk-mc02
|
|
|
|
api_user: root@pam
|
|
|
|
api_host: node1
|
|
|
|
password: 123456
|
|
|
|
hostname: example.org
|
|
|
|
ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz'
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Create new container with minimal options defining network interface with dhcp
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
node: uk-mc02
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
password: 123456
|
|
|
|
hostname: example.org
|
|
|
|
ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz'
|
|
|
|
netif: '{"net0":"name=eth0,ip=dhcp,ip6=dhcp,bridge=vmbr0"}'
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Create new container with minimal options defining network interface with static ip
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
node: uk-mc02
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
password: 123456
|
|
|
|
hostname: example.org
|
|
|
|
ostemplate: 'local:vztmpl/ubuntu-14.04-x86_64.tar.gz'
|
|
|
|
netif: '{"net0":"name=eth0,gw=192.168.0.1,ip=192.168.0.2/24,bridge=vmbr0"}'
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Create new container with minimal options defining a mount with 8GB
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
node: uk-mc02
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
password: 123456
|
|
|
|
hostname: example.org
|
|
|
|
ostemplate: local:vztmpl/ubuntu-14.04-x86_64.tar.gz'
|
|
|
|
mounts: '{"mp0":"local:8,mp=/mnt/test/"}'
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Create new container with minimal options defining a cpu core limit
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
node: uk-mc02
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
password: 123456
|
|
|
|
hostname: example.org
|
|
|
|
ostemplate: local:vztmpl/ubuntu-14.04-x86_64.tar.gz'
|
|
|
|
cores: 2
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Start container
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
state: started
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: >
|
|
|
|
Start container with mount. You should enter a 90-second timeout because servers
|
|
|
|
with additional disks take longer to boot
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
state: started
|
|
|
|
timeout: 90
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Stop container
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
state: stopped
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Stop container with force
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
force: yes
|
|
|
|
state: stopped
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Restart container(stopped or mounted container you can't restart)
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
state: restarted
|
|
|
|
|
2020-04-28 16:22:02 +02:00
|
|
|
- name: Remove container
|
2020-07-13 21:50:31 +02:00
|
|
|
community.general.proxmox:
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid: 100
|
|
|
|
api_user: root@pam
|
|
|
|
api_password: 1q2w3e
|
|
|
|
api_host: node1
|
|
|
|
state: absent
|
|
|
|
'''
|
|
|
|
|
|
|
|
import os
|
|
|
|
import time
|
|
|
|
import traceback
|
|
|
|
from distutils.version import LooseVersion
|
|
|
|
|
|
|
|
try:
|
|
|
|
from proxmoxer import ProxmoxAPI
|
|
|
|
HAS_PROXMOXER = True
|
|
|
|
except ImportError:
|
|
|
|
HAS_PROXMOXER = False
|
|
|
|
|
|
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
|
|
from ansible.module_utils._text import to_native
|
|
|
|
|
|
|
|
|
|
|
|
VZ_TYPE = None
|
|
|
|
|
|
|
|
|
|
|
|
def get_nextvmid(module, proxmox):
|
|
|
|
try:
|
|
|
|
vmid = proxmox.cluster.nextid.get()
|
|
|
|
return vmid
|
|
|
|
except Exception as e:
|
|
|
|
module.fail_json(msg="Unable to get next vmid. Failed with exception: %s" % to_native(e),
|
|
|
|
exception=traceback.format_exc())
|
|
|
|
|
|
|
|
|
|
|
|
def get_vmid(proxmox, hostname):
|
|
|
|
return [vm['vmid'] for vm in proxmox.cluster.resources.get(type='vm') if 'name' in vm and vm['name'] == hostname]
|
|
|
|
|
|
|
|
|
|
|
|
def get_instance(proxmox, vmid):
|
|
|
|
return [vm for vm in proxmox.cluster.resources.get(type='vm') if vm['vmid'] == int(vmid)]
|
|
|
|
|
|
|
|
|
|
|
|
def content_check(proxmox, node, ostemplate, template_store):
|
|
|
|
return [True for cnt in proxmox.nodes(node).storage(template_store).content.get() if cnt['volid'] == ostemplate]
|
|
|
|
|
|
|
|
|
|
|
|
def node_check(proxmox, node):
|
|
|
|
return [True for nd in proxmox.nodes.get() if nd['node'] == node]
|
|
|
|
|
|
|
|
|
|
|
|
def proxmox_version(proxmox):
|
|
|
|
apireturn = proxmox.version.get()
|
|
|
|
return LooseVersion(apireturn['version'])
|
|
|
|
|
|
|
|
|
|
|
|
def create_instance(module, proxmox, vmid, node, disk, storage, cpus, memory, swap, timeout, **kwargs):
|
|
|
|
proxmox_node = proxmox.nodes(node)
|
|
|
|
kwargs = dict((k, v) for k, v in kwargs.items() if v is not None)
|
|
|
|
|
|
|
|
if VZ_TYPE == 'lxc':
|
|
|
|
kwargs['cpulimit'] = cpus
|
|
|
|
kwargs['rootfs'] = disk
|
|
|
|
if 'netif' in kwargs:
|
|
|
|
kwargs.update(kwargs['netif'])
|
|
|
|
del kwargs['netif']
|
|
|
|
if 'mounts' in kwargs:
|
|
|
|
kwargs.update(kwargs['mounts'])
|
|
|
|
del kwargs['mounts']
|
|
|
|
if 'pubkey' in kwargs:
|
|
|
|
if proxmox_version(proxmox) >= LooseVersion('4.2'):
|
|
|
|
kwargs['ssh-public-keys'] = kwargs['pubkey']
|
|
|
|
del kwargs['pubkey']
|
|
|
|
else:
|
|
|
|
kwargs['cpus'] = cpus
|
|
|
|
kwargs['disk'] = disk
|
|
|
|
|
|
|
|
taskid = getattr(proxmox_node, VZ_TYPE).create(vmid=vmid, storage=storage, memory=memory, swap=swap, **kwargs)
|
|
|
|
|
|
|
|
while timeout:
|
|
|
|
if (proxmox_node.tasks(taskid).status.get()['status'] == 'stopped' and
|
|
|
|
proxmox_node.tasks(taskid).status.get()['exitstatus'] == 'OK'):
|
|
|
|
return True
|
|
|
|
timeout -= 1
|
|
|
|
if timeout == 0:
|
|
|
|
module.fail_json(msg='Reached timeout while waiting for creating VM. Last line in task before timeout: %s' %
|
|
|
|
proxmox_node.tasks(taskid).log.get()[:1])
|
|
|
|
|
|
|
|
time.sleep(1)
|
|
|
|
return False
|
|
|
|
|
|
|
|
|
|
|
|
def start_instance(module, proxmox, vm, vmid, timeout):
|
|
|
|
taskid = getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE)(vmid).status.start.post()
|
|
|
|
while timeout:
|
|
|
|
if (proxmox.nodes(vm[0]['node']).tasks(taskid).status.get()['status'] == 'stopped' and
|
|
|
|
proxmox.nodes(vm[0]['node']).tasks(taskid).status.get()['exitstatus'] == 'OK'):
|
|
|
|
return True
|
|
|
|
timeout -= 1
|
|
|
|
if timeout == 0:
|
|
|
|
module.fail_json(msg='Reached timeout while waiting for starting VM. Last line in task before timeout: %s' %
|
|
|
|
proxmox.nodes(vm[0]['node']).tasks(taskid).log.get()[:1])
|
|
|
|
|
|
|
|
time.sleep(1)
|
|
|
|
return False
|
|
|
|
|
|
|
|
|
|
|
|
def stop_instance(module, proxmox, vm, vmid, timeout, force):
|
|
|
|
if force:
|
|
|
|
taskid = getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE)(vmid).status.shutdown.post(forceStop=1)
|
|
|
|
else:
|
|
|
|
taskid = getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE)(vmid).status.shutdown.post()
|
|
|
|
while timeout:
|
|
|
|
if (proxmox.nodes(vm[0]['node']).tasks(taskid).status.get()['status'] == 'stopped' and
|
|
|
|
proxmox.nodes(vm[0]['node']).tasks(taskid).status.get()['exitstatus'] == 'OK'):
|
|
|
|
return True
|
|
|
|
timeout -= 1
|
|
|
|
if timeout == 0:
|
|
|
|
module.fail_json(msg='Reached timeout while waiting for stopping VM. Last line in task before timeout: %s' %
|
|
|
|
proxmox.nodes(vm[0]['node']).tasks(taskid).log.get()[:1])
|
|
|
|
|
|
|
|
time.sleep(1)
|
|
|
|
return False
|
|
|
|
|
|
|
|
|
|
|
|
def umount_instance(module, proxmox, vm, vmid, timeout):
|
|
|
|
taskid = getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE)(vmid).status.umount.post()
|
|
|
|
while timeout:
|
|
|
|
if (proxmox.nodes(vm[0]['node']).tasks(taskid).status.get()['status'] == 'stopped' and
|
|
|
|
proxmox.nodes(vm[0]['node']).tasks(taskid).status.get()['exitstatus'] == 'OK'):
|
|
|
|
return True
|
|
|
|
timeout -= 1
|
|
|
|
if timeout == 0:
|
|
|
|
module.fail_json(msg='Reached timeout while waiting for unmounting VM. Last line in task before timeout: %s' %
|
|
|
|
proxmox.nodes(vm[0]['node']).tasks(taskid).log.get()[:1])
|
|
|
|
|
|
|
|
time.sleep(1)
|
|
|
|
return False
|
|
|
|
|
|
|
|
|
|
|
|
def main():
|
|
|
|
module = AnsibleModule(
|
|
|
|
argument_spec=dict(
|
|
|
|
api_host=dict(required=True),
|
|
|
|
api_password=dict(no_log=True),
|
2020-11-16 21:24:11 +01:00
|
|
|
api_token_id=dict(no_log=True),
|
|
|
|
api_token_secret=dict(no_log=True),
|
|
|
|
api_user=dict(required=True),
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid=dict(required=False),
|
2020-06-22 15:56:35 +02:00
|
|
|
validate_certs=dict(type='bool', default=False),
|
2020-03-09 10:11:07 +01:00
|
|
|
node=dict(),
|
|
|
|
pool=dict(),
|
|
|
|
password=dict(no_log=True),
|
|
|
|
hostname=dict(),
|
|
|
|
ostemplate=dict(),
|
2020-10-30 13:15:25 +01:00
|
|
|
disk=dict(type='str'),
|
|
|
|
cores=dict(type='int'),
|
|
|
|
cpus=dict(type='int'),
|
|
|
|
memory=dict(type='int'),
|
|
|
|
swap=dict(type='int'),
|
2020-03-09 10:11:07 +01:00
|
|
|
netif=dict(type='dict'),
|
|
|
|
mounts=dict(type='dict'),
|
|
|
|
ip_address=dict(),
|
2020-10-30 13:15:25 +01:00
|
|
|
onboot=dict(type='bool'),
|
2020-03-09 10:11:07 +01:00
|
|
|
storage=dict(default='local'),
|
2020-10-30 13:15:25 +01:00
|
|
|
cpuunits=dict(type='int'),
|
2020-03-09 10:11:07 +01:00
|
|
|
nameserver=dict(),
|
|
|
|
searchdomain=dict(),
|
|
|
|
timeout=dict(type='int', default=30),
|
2020-06-22 15:56:35 +02:00
|
|
|
force=dict(type='bool', default=False),
|
2020-03-09 10:11:07 +01:00
|
|
|
state=dict(default='present', choices=['present', 'absent', 'stopped', 'started', 'restarted']),
|
|
|
|
pubkey=dict(type='str', default=None),
|
2020-06-22 15:56:35 +02:00
|
|
|
unprivileged=dict(type='bool', default=False),
|
2020-05-18 07:17:11 +02:00
|
|
|
description=dict(type='str'),
|
|
|
|
hookscript=dict(type='str'),
|
2020-10-30 13:15:25 +01:00
|
|
|
proxmox_default_behavior=dict(type='str', choices=['compatibility', 'no_defaults']),
|
2020-03-09 10:11:07 +01:00
|
|
|
)
|
|
|
|
)
|
|
|
|
|
|
|
|
if not HAS_PROXMOXER:
|
|
|
|
module.fail_json(msg='proxmoxer required for this module')
|
|
|
|
|
|
|
|
state = module.params['state']
|
|
|
|
api_host = module.params['api_host']
|
|
|
|
api_password = module.params['api_password']
|
2020-11-16 21:24:11 +01:00
|
|
|
api_token_id = module.params['api_token_id']
|
|
|
|
api_token_secret = module.params['api_token_secret']
|
|
|
|
api_user = module.params['api_user']
|
2020-03-09 10:11:07 +01:00
|
|
|
vmid = module.params['vmid']
|
|
|
|
validate_certs = module.params['validate_certs']
|
|
|
|
node = module.params['node']
|
|
|
|
disk = module.params['disk']
|
|
|
|
cpus = module.params['cpus']
|
|
|
|
memory = module.params['memory']
|
|
|
|
swap = module.params['swap']
|
|
|
|
storage = module.params['storage']
|
|
|
|
hostname = module.params['hostname']
|
|
|
|
if module.params['ostemplate'] is not None:
|
|
|
|
template_store = module.params['ostemplate'].split(":")[0]
|
|
|
|
timeout = module.params['timeout']
|
|
|
|
|
2020-10-30 13:15:25 +01:00
|
|
|
if module.params['proxmox_default_behavior'] is None:
|
|
|
|
module.params['proxmox_default_behavior'] = 'compatibility'
|
|
|
|
module.deprecate(
|
|
|
|
'The proxmox_default_behavior option will change its default value from "compatibility" to '
|
|
|
|
'"no_defaults" in community.general 4.0.0. To remove this warning, please specify an explicit value for it now',
|
|
|
|
version='4.0.0', collection_name='community.general'
|
|
|
|
)
|
|
|
|
if module.params['proxmox_default_behavior'] == 'compatibility':
|
|
|
|
old_default_values = dict(
|
|
|
|
disk="3",
|
|
|
|
cores=1,
|
|
|
|
cpus=1,
|
|
|
|
memory=512,
|
|
|
|
swap=0,
|
|
|
|
onboot=False,
|
|
|
|
cpuunits=1000,
|
|
|
|
)
|
|
|
|
for param, value in old_default_values.items():
|
|
|
|
if module.params[param] is None:
|
|
|
|
module.params[param] = value
|
|
|
|
|
2020-11-16 21:24:11 +01:00
|
|
|
auth_args = {'user': api_user}
|
|
|
|
if not (api_token_id and api_token_secret):
|
|
|
|
# If password not set get it from PROXMOX_PASSWORD env
|
|
|
|
if not api_password:
|
|
|
|
try:
|
|
|
|
api_password = os.environ['PROXMOX_PASSWORD']
|
|
|
|
except KeyError as e:
|
|
|
|
module.fail_json(msg='You should set api_password param or use PROXMOX_PASSWORD environment variable')
|
|
|
|
auth_args['password'] = api_password
|
|
|
|
else:
|
|
|
|
auth_args['token_name'] = api_token_id
|
|
|
|
auth_args['token_value'] = api_token_secret
|
2020-03-09 10:11:07 +01:00
|
|
|
|
|
|
|
try:
|
2020-11-16 21:24:11 +01:00
|
|
|
proxmox = ProxmoxAPI(api_host, verify_ssl=validate_certs, **auth_args)
|
2020-03-09 10:11:07 +01:00
|
|
|
global VZ_TYPE
|
|
|
|
VZ_TYPE = 'openvz' if proxmox_version(proxmox) < LooseVersion('4.0') else 'lxc'
|
|
|
|
except Exception as e:
|
|
|
|
module.fail_json(msg='authorization on proxmox cluster failed with exception: %s' % e)
|
|
|
|
|
|
|
|
# If vmid not set get the Next VM id from ProxmoxAPI
|
|
|
|
# If hostname is set get the VM id from ProxmoxAPI
|
|
|
|
if not vmid and state == 'present':
|
|
|
|
vmid = get_nextvmid(module, proxmox)
|
|
|
|
elif not vmid and hostname:
|
|
|
|
hosts = get_vmid(proxmox, hostname)
|
|
|
|
if len(hosts) == 0:
|
|
|
|
module.fail_json(msg="Vmid could not be fetched => Hostname doesn't exist (action: %s)" % state)
|
|
|
|
vmid = hosts[0]
|
|
|
|
elif not vmid:
|
|
|
|
module.exit_json(changed=False, msg="Vmid could not be fetched for the following action: %s" % state)
|
|
|
|
|
|
|
|
if state == 'present':
|
|
|
|
try:
|
|
|
|
if get_instance(proxmox, vmid) and not module.params['force']:
|
|
|
|
module.exit_json(changed=False, msg="VM with vmid = %s is already exists" % vmid)
|
|
|
|
# If no vmid was passed, there cannot be another VM named 'hostname'
|
|
|
|
if not module.params['vmid'] and get_vmid(proxmox, hostname) and not module.params['force']:
|
|
|
|
module.exit_json(changed=False, msg="VM with hostname %s already exists and has ID number %s" % (hostname, get_vmid(proxmox, hostname)[0]))
|
|
|
|
elif not (node, module.params['hostname'] and module.params['password'] and module.params['ostemplate']):
|
|
|
|
module.fail_json(msg='node, hostname, password and ostemplate are mandatory for creating vm')
|
|
|
|
elif not node_check(proxmox, node):
|
|
|
|
module.fail_json(msg="node '%s' not exists in cluster" % node)
|
|
|
|
elif not content_check(proxmox, node, module.params['ostemplate'], template_store):
|
|
|
|
module.fail_json(msg="ostemplate '%s' not exists on node %s and storage %s"
|
|
|
|
% (module.params['ostemplate'], node, template_store))
|
|
|
|
|
|
|
|
create_instance(module, proxmox, vmid, node, disk, storage, cpus, memory, swap, timeout,
|
|
|
|
cores=module.params['cores'],
|
|
|
|
pool=module.params['pool'],
|
|
|
|
password=module.params['password'],
|
|
|
|
hostname=module.params['hostname'],
|
|
|
|
ostemplate=module.params['ostemplate'],
|
|
|
|
netif=module.params['netif'],
|
|
|
|
mounts=module.params['mounts'],
|
|
|
|
ip_address=module.params['ip_address'],
|
|
|
|
onboot=int(module.params['onboot']),
|
|
|
|
cpuunits=module.params['cpuunits'],
|
|
|
|
nameserver=module.params['nameserver'],
|
|
|
|
searchdomain=module.params['searchdomain'],
|
|
|
|
force=int(module.params['force']),
|
|
|
|
pubkey=module.params['pubkey'],
|
2020-05-18 07:17:11 +02:00
|
|
|
unprivileged=int(module.params['unprivileged']),
|
|
|
|
description=module.params['description'],
|
|
|
|
hookscript=module.params['hookscript'])
|
2020-03-09 10:11:07 +01:00
|
|
|
|
|
|
|
module.exit_json(changed=True, msg="deployed VM %s from template %s" % (vmid, module.params['ostemplate']))
|
|
|
|
except Exception as e:
|
|
|
|
module.fail_json(msg="creation of %s VM %s failed with exception: %s" % (VZ_TYPE, vmid, e))
|
|
|
|
|
|
|
|
elif state == 'started':
|
|
|
|
try:
|
|
|
|
vm = get_instance(proxmox, vmid)
|
|
|
|
if not vm:
|
|
|
|
module.fail_json(msg='VM with vmid = %s not exists in cluster' % vmid)
|
|
|
|
if getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE)(vmid).status.current.get()['status'] == 'running':
|
|
|
|
module.exit_json(changed=False, msg="VM %s is already running" % vmid)
|
|
|
|
|
|
|
|
if start_instance(module, proxmox, vm, vmid, timeout):
|
|
|
|
module.exit_json(changed=True, msg="VM %s started" % vmid)
|
|
|
|
except Exception as e:
|
|
|
|
module.fail_json(msg="starting of VM %s failed with exception: %s" % (vmid, e))
|
|
|
|
|
|
|
|
elif state == 'stopped':
|
|
|
|
try:
|
|
|
|
vm = get_instance(proxmox, vmid)
|
|
|
|
if not vm:
|
|
|
|
module.fail_json(msg='VM with vmid = %s not exists in cluster' % vmid)
|
|
|
|
|
|
|
|
if getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE)(vmid).status.current.get()['status'] == 'mounted':
|
|
|
|
if module.params['force']:
|
|
|
|
if umount_instance(module, proxmox, vm, vmid, timeout):
|
|
|
|
module.exit_json(changed=True, msg="VM %s is shutting down" % vmid)
|
|
|
|
else:
|
|
|
|
module.exit_json(changed=False, msg=("VM %s is already shutdown, but mounted. "
|
|
|
|
"You can use force option to umount it.") % vmid)
|
|
|
|
|
|
|
|
if getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE)(vmid).status.current.get()['status'] == 'stopped':
|
|
|
|
module.exit_json(changed=False, msg="VM %s is already shutdown" % vmid)
|
|
|
|
|
|
|
|
if stop_instance(module, proxmox, vm, vmid, timeout, force=module.params['force']):
|
|
|
|
module.exit_json(changed=True, msg="VM %s is shutting down" % vmid)
|
|
|
|
except Exception as e:
|
|
|
|
module.fail_json(msg="stopping of VM %s failed with exception: %s" % (vmid, e))
|
|
|
|
|
|
|
|
elif state == 'restarted':
|
|
|
|
try:
|
|
|
|
vm = get_instance(proxmox, vmid)
|
|
|
|
if not vm:
|
|
|
|
module.fail_json(msg='VM with vmid = %s not exists in cluster' % vmid)
|
|
|
|
if (getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE)(vmid).status.current.get()['status'] == 'stopped' or
|
|
|
|
getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE)(vmid).status.current.get()['status'] == 'mounted'):
|
|
|
|
module.exit_json(changed=False, msg="VM %s is not running" % vmid)
|
|
|
|
|
|
|
|
if (stop_instance(module, proxmox, vm, vmid, timeout, force=module.params['force']) and
|
|
|
|
start_instance(module, proxmox, vm, vmid, timeout)):
|
|
|
|
module.exit_json(changed=True, msg="VM %s is restarted" % vmid)
|
|
|
|
except Exception as e:
|
|
|
|
module.fail_json(msg="restarting of VM %s failed with exception: %s" % (vmid, e))
|
|
|
|
|
|
|
|
elif state == 'absent':
|
|
|
|
try:
|
|
|
|
vm = get_instance(proxmox, vmid)
|
|
|
|
if not vm:
|
|
|
|
module.exit_json(changed=False, msg="VM %s does not exist" % vmid)
|
|
|
|
|
|
|
|
if getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE)(vmid).status.current.get()['status'] == 'running':
|
|
|
|
module.exit_json(changed=False, msg="VM %s is running. Stop it before deletion." % vmid)
|
|
|
|
|
|
|
|
if getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE)(vmid).status.current.get()['status'] == 'mounted':
|
|
|
|
module.exit_json(changed=False, msg="VM %s is mounted. Stop it with force option before deletion." % vmid)
|
|
|
|
|
|
|
|
taskid = getattr(proxmox.nodes(vm[0]['node']), VZ_TYPE).delete(vmid)
|
|
|
|
while timeout:
|
|
|
|
if (proxmox.nodes(vm[0]['node']).tasks(taskid).status.get()['status'] == 'stopped' and
|
|
|
|
proxmox.nodes(vm[0]['node']).tasks(taskid).status.get()['exitstatus'] == 'OK'):
|
|
|
|
module.exit_json(changed=True, msg="VM %s removed" % vmid)
|
|
|
|
timeout -= 1
|
|
|
|
if timeout == 0:
|
|
|
|
module.fail_json(msg='Reached timeout while waiting for removing VM. Last line in task before timeout: %s'
|
|
|
|
% proxmox.nodes(vm[0]['node']).tasks(taskid).log.get()[:1])
|
|
|
|
|
|
|
|
time.sleep(1)
|
|
|
|
except Exception as e:
|
|
|
|
module.fail_json(msg="deletion of VM %s failed with exception: %s" % (vmid, to_native(e)))
|
|
|
|
|
|
|
|
|
|
|
|
if __name__ == '__main__':
|
|
|
|
main()
|