#!/usr/bin/python -tt # -*- coding: utf-8 -*- # This file is part of Ansible # # Ansible is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # Ansible is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with Ansible. If not, see . DOCUMENTATION = ''' --- module: ec2_facts short_description: Gathers facts about remote hosts within ec2 (aws) options: {} description: - This module fetches data from the metadata servers in ec2 (aws). notes: - The module can add parameters to filter ec2_facts based on it. Some of the facts are not returned ( like mapping of the devices - but can be add it on). examples: - code: ansible all -m ec2_facts --tree /tmp/facts description: Obtain facts from ec2 metatdata servers. You will need to run an instance within ec2. author: Silviu Dicu ''' import urllib2 import socket socket.setdefaulttimeout(5) class Ec2Metadata(object): ec2_metadata_server = 'http://169.254.169.254/latest/meta-data/' ec2_sshdata_server = 'http://169.254.169.254/latest/meta-data/public-keys/0/openssh-key' ec2_userdata_server = 'http://169.254.169.254/latest/user-data/' def __init__(self, ec2_metadata_server=None, ec2_sshdata_server=None, ec2_userdata_server=None): self.url_meta = ec2_metadata_server or self.ec2_metadata_server self.url_user = ec2_userdata_server or self.ec2_userdata_server self.url_ssh = ec2_sshdata_server or self.ec2_sshdata_server def _fetch(self, url): try: return urllib2.urlopen(url).read() except urllib2.HTTPError: return except urllib2.URLError: return def run(self, field=None): data = {} raw_fields = self._fetch(self.url_meta) if not raw_fields: return data fields = raw_fields.split('\n') for field in fields: if field.endswith('/'): continue # deal with this later field_data = self._fetch(self.url_meta + field) if field == 'security-groups': sg_fields = ",".join(field_data.split('\n')) data['ansible_ec2_%s' % field] = sg_fields else: data['ansible_ec2_%s' % field] = field_data data['ansible_ec2_%s' % 'user-data'] = self._fetch(self.url_user) data['ensible_ec2_%s' % 'public-keys'] = self._fetch(self.url_ssh) return data def main(): ec2_facts = Ec2Metadata().run() ec2_facts_result = { "changed" : True, "ansible_facts" : ec2_facts } module = AnsibleModule( argument_spec = dict() ) module.exit_json(**ec2_facts_result) # this is magic, see lib/ansible/module_common.py #<> main()