ngine_io.cloudstack.cs_sshkeypair – Manages SSH keys 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_sshkeypair
.
New in version 0.1.0: of ngine_io.cloudstack
Synopsis¶
Create, register and remove SSH keys.
If no key was found and no public key was provided and a new SSH private/public key pair will be created and the private key will be returned.
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: create a new private / public key pair
ngine_io.cloudstack.cs_sshkeypair:
name: [email protected]
register: key
- debug:
msg: 'Private key is {{ key.private_key }}'
- name: remove a public key by its name
ngine_io.cloudstack.cs_sshkeypair:
name: [email protected]
state: absent
- name: register your existing local public key
ngine_io.cloudstack.cs_sshkeypair:
name: [email protected]
public_key: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Authors¶
René Moser (@resmo)