ngine_io.cloudstack.cs_instance_password_reset – Allows resetting VM the default passwords on Apache CloudStack based clouds.¶
Note
This plugin is part of the ngine_io.cloudstack collection (version 2.1.0).
To install it use: ansible-galaxy collection install ngine_io.cloudstack
.
To use it in a playbook, specify: ngine_io.cloudstack.cs_instance_password_reset
.
New in version 0.1.0: of ngine_io.cloudstack
Synopsis¶
Resets the default user account’s password on an instance.
Requires cloud-init to be installed in the virtual machine.
The passwordenabled flag must be set on the template associated with the VM.
Requirements¶
The below requirements are needed on the host that executes this module.
python >= 2.6
cs >= 0.9.0
Parameters¶
Notes¶
Note
A detailed guide about cloudstack modules can be found in the CloudStack Cloud Guide.
This module supports check mode.
Examples¶
- name: stop the virtual machine before resetting the password
ngine_io.cloudstack.cs_instance:
name: myvirtualmachine
zone: zone01
state: stopped
- name: reset and get new default password
ngine_io.cloudstack.cs_instance_password_reset:
vm: myvirtualmachine
zone: zone01
register: root
- debug:
msg: "new default password is {{ root.password }}"
- name: boot the virtual machine to activate the new password
ngine_io.cloudstack.cs_instance:
name: myvirtualmachine
zone: zone01
state: started
when: root is changed
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
id
string
|
success |
ID of the virtual machine.
Sample:
a6f7a5fc-43f8-11e5-a151-feff819cdc9f
|
password
string
|
success |
The new default password.
Sample:
ahQu5nuNge3keesh
|
Authors¶
Gregor Riepl (@onitake)