atlantic_cloud ========= The Ansible module for Atlantic.Net Cloud 0.2.0 - 07/07/17: Add new state 'restarted' to make the logic for restarting servers more straightforward. Unique names: One can now query the API of an already existing server with 'servername'. This will return an error if there is more than one server that has this name (non-case-sensitive). If your servers all have the same name, then either change the server names in Cloud or use the instanceid method. 0.1.6 - 06/17/17: Fixed provisioning with backups. You must choose 'Y' or 'N'. Default is 'N'. Requirements ------------ ```` /library/atlantic_cloud.py - The Ansible module for Atlantic.Net Cloud https://github.com/cailen/anetpy - The Atlantic.Net Cloud API Python wrapper ```` Dependencies ------------ ```` anetpy ```` Options ------- ```` state: description: - Indicate desired state of the target. default: present choices: ['present', 'active', 'absent', 'deleted', 'restarted'] public_key: description: - Atlantic.Net public API key. private_key: - Atlantic.Net private API key. instanceid: description: - Numeric, the cloudserver id you want to operate on. servername: description: - String, this is the name of the cloudserver - must be formatted by hostname rules, or the name of a SSH key. planname: description: - This is the slug of the size you would like the cloudserver created with. imageid: description: - This is the slug of the image you would like the cloudserver created with. vm_location: description: - This is the slug of the region you would like your server to be created in. enablebackup: description: - Optional, string, enables backups for your cloudserver. default: "no" choices: [ "Y", "N" ] wait: description: - Wait for the cloudserver to be in state 'running' before returning. If wait is "no" an ip_address may not be returned. default: "yes" choices: [ "yes", "no" ] wait_timeout: description: - How long before wait gives up, in seconds. default: 300 ssh_key: description: - The name of the public SSH key you want to add to your account. reboottype: description: - The type of restart you want to perform (hard or soft). (Note: 'hard' is the default.) ```` Example Playbook ---------------- ```` - hosts: localhost vars: - public_key: XXX - private_key: XXX tasks: - name: Atlantic_Net Cloud - Create new server atlantic_cloud: public_key: "{{public_key}}" private_key: "{{private_key}}" state: present servername: test-server" vm_location: USEAST1 imageid: CentOS-7.2_64bit planname: "G2.4GB" ssh_key: "ansible" register: my_cloudserver - name: Wait for the server to come online... local_action: module: wait_for host={{ my_cloudserver.results.ip_address }} port=22 delay=1 timeout=300 - name: Atlantic_Net Cloud - Get server details from the server just created atlantic_cloud: state: present servername: test-server public_key: "{{public_key}}" private_key: "{{private_key}}" - name: Server ID debug: msg: "ID is {{ my_cloudserver.results.instanceid }}" - name: Server IP debug: msg: "IP is {{ my_cloudserver.results.vm_ip_address }}" - name: Atlantic_Net Cloud - Reboot server atlantic_cloud: public_key: "{{public_key}}" private_key: "{{private_key}}" state: restarted instanceid: "{{my_cloudserver.results.instanceid}}" register: result - name: Server reboot message debug: var: result - name: Wait for the server to come online... local_action: module: wait_for host={{ my_cloudserver.results.ip_address }} port=22 delay=1 timeout=300 - name: Atlantic_Net Cloud - Delete the server atlantic_cloud: public_key: "{{public_key}}" private_key: "{{private_key}}" state: absent instanceid: "{{my_cloudserver.results.instanceid}}" register: result - name: Server deleted message debug: var: result ```` License ------- BSD Author Information ------------------ Derek Wiedenhoeft - @cailenletigre - http://derekdesignsorlando.com - derek [at] derekdesignsorlando.com