#!/usr/bin/python # -*- coding: utf-8 -*- # 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 ANSIBLE_METADATA = {'metadata_version': '1.1', 'status': ['stableinterface'], 'supported_by': 'core'} DOCUMENTATION = ''' --- module: ec2_metadata_facts short_description: Gathers facts (instance metadata) about remote hosts within ec2 version_added: "1.0" author: - Silviu Dicu (@silviud) - Vinay Dandekar (@roadmapper) description: - This module fetches data from the instance metadata endpoint in ec2 as per http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html. The module must be called from within the EC2 instance itself. notes: - Parameters to filter on ec2_metadata_facts may be added later. ''' EXAMPLES = ''' # Gather EC2 metadata facts - ec2_metadata_facts: - debug: msg: "This instance is a t1.micro" when: ansible_ec2_instance_type == "t1.micro" ''' RETURN = ''' ansible_facts: description: Dictionary of new facts representing discovered properties of the EC2 instance. returned: changed type: complex contains: ansible_ec2_ami_id: description: The AMI ID used to launch the instance. type: string sample: "ami-XXXXXXXX" ansible_ec2_ami_launch_index: description: - If you started more than one instance at the same time, this value indicates the order in which the instance was launched. The value of the first instance launched is 0. type: string sample: "0" ansible_ec2_ami_manifest_path: description: - The path to the AMI manifest file in Amazon S3. If you used an Amazon EBS-backed AMI to launch the instance, the returned result is unknown. type: string sample: "(unknown)" ansible_ec2_ancestor_ami_ids: description: - The AMI IDs of any instances that were rebundled to create this AMI. This value will only exist if the AMI manifest file contained an ancestor-amis key. type: string sample: "(unknown)" ansible_ec2_block_device_mapping_ami: description: The virtual device that contains the root/boot file system. type: string sample: "/dev/sda1" ansible_ec2_block_device_mapping_ebsN: description: - The virtual devices associated with Amazon EBS volumes, if any are present. Amazon EBS volumes are only available in metadata if they were present at launch time or when the instance was last started. The N indicates the index of the Amazon EBS volume (such as ebs1 or ebs2). type: string sample: "/dev/xvdb" ansible_ec2_block_device_mapping_ephemeralN: description: The virtual devices associated with ephemeral devices, if any are present. The N indicates the index of the ephemeral volume. type: string sample: "/dev/xvdc" ansible_ec2_block_device_mapping_root: description: - The virtual devices or partitions associated with the root devices, or partitions on the virtual device, where the root (/ or C) file system is associated with the given instance. type: string sample: "/dev/sda1" ansible_ec2_block_device_mapping_swap: description: The virtual devices associated with swap. Not always present. type: string sample: "/dev/sda2" ansible_ec2_fws_instance_monitoring: description: "Value showing whether the customer has enabled detailed one-minute monitoring in CloudWatch." type: string sample: "enabled" ansible_ec2_hostname: description: - The private IPv4 DNS hostname of the instance. In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0). type: string sample: "ip-10-0-0-1.ec2.internal" ansible_ec2_iam_info: description: - If there is an IAM role associated with the instance, contains information about the last time the instance profile was updated, including the instance's LastUpdated date, InstanceProfileArn, and InstanceProfileId. Otherwise, not present. type: complex sample: "" ansible_ec2_iam_info_instanceprofilearn: description: The IAM instance profile ARN. type: string sample: "arn:aws:iam:::instance-profile/" ansible_ec2_iam_info_instanceprofileid: description: IAM instance profile ID. type: string sample: "" ansible_ec2_iam_info_lastupdated: description: IAM info last updated time. type: string sample: "2017-05-12T02:42:27Z" ansible_ec2_iam_instance_profile_role: description: IAM instance role. type: string sample: "role_name" ansible_ec2_iam_security_credentials_: description: - If there is an IAM role associated with the instance, role-name is the name of the role, and role-name contains the temporary security credentials associated with the role. Otherwise, not present. type: string sample: "" ansible_ec2_iam_security_credentials__accesskeyid: description: IAM role access key ID. type: string sample: "" ansible_ec2_iam_security_credentials__code: description: IAM code. type: string sample: "Success" ansible_ec2_iam_security_credentials__expiration: description: IAM role credentials expiration time. type: string sample: "2017-05-12T09:11:41Z" ansible_ec2_iam_security_credentials__lastupdated: description: IAM role last updated time. type: string sample: "2017-05-12T02:40:44Z" ansible_ec2_iam_security_credentials__secretaccesskey: description: IAM role secret access key. type: string sample: "" ansible_ec2_iam_security_credentials__token: description: IAM role token. type: string sample: "" ansible_ec2_iam_security_credentials__type: description: IAM role type. type: string sample: "AWS-HMAC" ansible_ec2_instance_action: description: Notifies the instance that it should reboot in preparation for bundling. type: string sample: "none" ansible_ec2_instance_id: description: The ID of this instance. type: string sample: "i-XXXXXXXXXXXXXXXXX" ansible_ec2_instance_identity_document: description: JSON containing instance attributes, such as instance-id, private IP address, etc. type: string sample: "" ansible_ec2_instance_identity_document_accountid: description: "" type: string sample: "012345678901" ansible_ec2_instance_identity_document_architecture: description: Instance system architecture. type: string sample: "x86_64" ansible_ec2_instance_identity_document_availabilityzone: description: The Availability Zone in which the instance launched. type: string sample: "us-east-1a" ansible_ec2_instance_identity_document_billingproducts: description: Billing products for this instance. type: string sample: "" ansible_ec2_instance_identity_document_devpayproductcodes: description: Product codes for the launched AMI. type: string sample: "" ansible_ec2_instance_identity_document_imageid: description: The AMI ID used to launch the instance. type: string sample: "ami-01234567" ansible_ec2_instance_identity_document_instanceid: description: The ID of this instance. type: string sample: "i-0123456789abcdef0" ansible_ec2_instance_identity_document_instancetype: description: The type of instance. type: string sample: "m4.large" ansible_ec2_instance_identity_document_kernelid: description: The ID of the kernel launched with this instance, if applicable. type: string sample: "" ansible_ec2_instance_identity_document_pendingtime: description: The instance pending time. type: string sample: "2017-05-11T20:51:20Z" ansible_ec2_instance_identity_document_privateip: description: - The private IPv4 address of the instance. In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0). type: string sample: "10.0.0.1" ansible_ec2_instance_identity_document_ramdiskid: description: The ID of the RAM disk specified at launch time, if applicable. type: string sample: "" ansible_ec2_instance_identity_document_region: description: The Region in which the instance launched. type: string sample: "us-east-1" ansible_ec2_instance_identity_document_version: description: Identity document version. type: string sample: "2010-08-31" ansible_ec2_instance_identity_pkcs7: description: Used to verify the document's authenticity and content against the signature. type: string sample: "" ansible_ec2_instance_identity_rsa2048: description: Used to verify the document's authenticity and content against the signature. type: string sample: "" ansible_ec2_instance_identity_signature: description: Data that can be used by other parties to verify its origin and authenticity. type: string sample: "" ansible_ec2_instance_type: description: The type of instance. type: string sample: "m4.large" ansible_ec2_local_hostname: description: - The private IPv4 DNS hostname of the instance. In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0). type: string sample: "ip-10-0-0-1.ec2.internal" ansible_ec2_local_ipv4: description: - The private IPv4 address of the instance. In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0). type: string sample: "10.0.0.1" ansible_ec2_mac: description: - The instance's media access control (MAC) address. In cases where multiple network interfaces are present, this refers to the eth0 device (the device for which the device number is 0). type: string sample: "00:11:22:33:44:55" ansible_ec2_metrics_vhostmd: description: Metrics. type: string sample: "" ansible_ec2_network_interfaces_macs__device_number: description: - The unique device number associated with that interface. The device number corresponds to the device name; for example, a device-number of 2 is for the eth2 device. This category corresponds to the DeviceIndex and device-index fields that are used by the Amazon EC2 API and the EC2 commands for the AWS CLI. type: string sample: "0" ansible_ec2_network_interfaces_macs__interface_id: description: The elastic network interface ID. type: string sample: "eni-12345678" ansible_ec2_network_interfaces_macs__ipv4_associations_: description: The private IPv4 addresses that are associated with each public-ip address and assigned to that interface. type: string sample: "" ansible_ec2_network_interfaces_macs__ipv6s: description: The IPv6 addresses associated with the interface. Returned only for instances launched into a VPC. type: string sample: "" ansible_ec2_network_interfaces_macs__local_hostname: description: The interface's local hostname. type: string sample: "" ansible_ec2_network_interfaces_macs__local_ipv4s: description: The private IPv4 addresses associated with the interface. type: string sample: "" ansible_ec2_network_interfaces_macs__mac: description: The instance's MAC address. type: string sample: "00:11:22:33:44:55" ansible_ec2_network_interfaces_macs__owner_id: description: - The ID of the owner of the network interface. In multiple-interface environments, an interface can be attached by a third party, such as Elastic Load Balancing. Traffic on an interface is always billed to the interface owner. type: string sample: "01234567890" ansible_ec2_network_interfaces_macs__public_hostname: description: - The interface's public DNS (IPv4). If the instance is in a VPC, this category is only returned if the enableDnsHostnames attribute is set to true. type: string sample: "ec2-1-2-3-4.compute-1.amazonaws.com" ansible_ec2_network_interfaces_macs__public_ipv4s: description: The Elastic IP addresses associated with the interface. There may be multiple IPv4 addresses on an instance. type: string sample: "1.2.3.4" ansible_ec2_network_interfaces_macs__security_group_ids: description: The IDs of the security groups to which the network interface belongs. Returned only for instances launched into a VPC. type: string sample: "sg-01234567,sg-01234568" ansible_ec2_network_interfaces_macs__security_groups: description: Security groups to which the network interface belongs. Returned only for instances launched into a VPC. type: string sample: "secgroup1,secgroup2" ansible_ec2_network_interfaces_macs__subnet_id: description: The ID of the subnet in which the interface resides. Returned only for instances launched into a VPC. type: string sample: "subnet-01234567" ansible_ec2_network_interfaces_macs__subnet_ipv4_cidr_block: description: The IPv4 CIDR block of the subnet in which the interface resides. Returned only for instances launched into a VPC. type: string sample: "10.0.1.0/24" ansible_ec2_network_interfaces_macs__subnet_ipv6_cidr_blocks: description: The IPv6 CIDR block of the subnet in which the interface resides. Returned only for instances launched into a VPC. type: string sample: "" ansible_ec2_network_interfaces_macs__vpc_id: description: The ID of the VPC in which the interface resides. Returned only for instances launched into a VPC. type: string sample: "vpc-0123456" ansible_ec2_network_interfaces_macs__vpc_ipv4_cidr_block: description: The IPv4 CIDR block of the VPC in which the interface resides. Returned only for instances launched into a VPC. type: string sample: "10.0.0.0/16" ansible_ec2_network_interfaces_macs__vpc_ipv4_cidr_blocks: description: The IPv4 CIDR block of the VPC in which the interface resides. Returned only for instances launched into a VPC. type: string sample: "10.0.0.0/16" ansible_ec2_network_interfaces_macs__vpc_ipv6_cidr_blocks: description: The IPv6 CIDR block of the VPC in which the interface resides. Returned only for instances launched into a VPC. type: string sample: "" ansible_ec2_placement_availability_zone: description: The Availability Zone in which the instance launched. type: string sample: "us-east-1a" ansible_ec2_placement_region: description: The Region in which the instance launched. type: string sample: "us-east-1" ansible_ec2_product_codes: description: Product codes associated with the instance, if any. type: string sample: "aw0evgkw8e5c1q413zgy5pjce" ansible_ec2_profile: description: EC2 instance hardware profile. type: string sample: "default-hvm" ansible_ec2_public_hostname: description: - The instance's public DNS. If the instance is in a VPC, this category is only returned if the enableDnsHostnames attribute is set to true. type: string sample: "ec2-1-2-3-4.compute-1.amazonaws.com" ansible_ec2_public_ipv4: description: The public IPv4 address. If an Elastic IP address is associated with the instance, the value returned is the Elastic IP address. type: string sample: "1.2.3.4" ansible_ec2_public_key: description: Public key. Only available if supplied at instance launch time. type: string sample: "" ansible_ec2_ramdisk_id: description: The ID of the RAM disk specified at launch time, if applicable. type: string sample: "" ansible_ec2_reservation_id: description: The ID of the reservation. type: string sample: "r-0123456789abcdef0" ansible_ec2_security_groups: description: - The names of the security groups applied to the instance. After launch, you can only change the security groups of instances running in a VPC. Such changes are reflected here and in network/interfaces/macs/mac/security-groups. type: string sample: "securitygroup1,securitygroup2" ansible_ec2_services_domain: description: The domain for AWS resources for the region; for example, amazonaws.com for us-east-1. type: string sample: "amazonaws.com" ansible_ec2_services_partition: description: - The partition that the resource is in. For standard AWS regions, the partition is aws. If you have resources in other partitions, the partition is aws-partitionname. For example, the partition for resources in the China (Beijing) region is aws-cn. type: string sample: "aws" ansible_ec2_spot_termination_time: description: - The approximate time, in UTC, that the operating system for your Spot instance will receive the shutdown signal. This item is present and contains a time value only if the Spot instance has been marked for termination by Amazon EC2. The termination-time item is not set to a time if you terminated the Spot instance yourself. type: string sample: "2015-01-05T18:02:00Z" ansible_ec2_user_data: description: The instance user data. type: string sample: "#!/bin/bash" ''' import json import re import socket import time from ansible.module_utils.basic import AnsibleModule from ansible.module_utils._text import to_text from ansible.module_utils.urls import fetch_url socket.setdefaulttimeout(5) class Ec2Metadata(object): ec2_metadata_uri = 'http://169.254.169.254/latest/meta-data/' ec2_sshdata_uri = 'http://169.254.169.254/latest/meta-data/public-keys/0/openssh-key' ec2_userdata_uri = 'http://169.254.169.254/latest/user-data/' ec2_dynamicdata_uri = 'http://169.254.169.254/latest/dynamic/' def __init__(self, module, ec2_metadata_uri=None, ec2_sshdata_uri=None, ec2_userdata_uri=None, ec2_dynamicdata_uri=None): self.module = module self.uri_meta = ec2_metadata_uri or self.ec2_metadata_uri self.uri_user = ec2_userdata_uri or self.ec2_userdata_uri self.uri_ssh = ec2_sshdata_uri or self.ec2_sshdata_uri self.uri_dynamic = ec2_dynamicdata_uri or self.ec2_dynamicdata_uri self._data = {} self._prefix = 'ansible_ec2_%s' def _fetch(self, url): response, info = fetch_url(self.module, url, force=True) if info.get('status') not in (200, 404): time.sleep(3) # request went bad, retry once then raise self.module.warn('Retrying query to metadata service. First attempt failed: {0}'.format(info['msg'])) response, info = fetch_url(self.module, url, force=True) if info.get('status') not in (200, 404): # fail out now self.module.fail_json(msg='Failed to retrieve metadata from AWS: {0}'.format(info['msg']), response=info) if response: data = response.read() else: data = None return to_text(data) def _mangle_fields(self, fields, uri, filter_patterns=None): filter_patterns = ['public-keys-0'] if filter_patterns is None else filter_patterns new_fields = {} for key, value in fields.items(): split_fields = key[len(uri):].split('/') if len(split_fields) == 3 and split_fields[0:2] == ['iam', 'security-credentials']: new_fields[self._prefix % "iam-instance-profile-role"] = split_fields[2] if len(split_fields) > 1 and split_fields[1]: new_key = "-".join(split_fields) new_fields[self._prefix % new_key] = value else: new_key = "".join(split_fields) new_fields[self._prefix % new_key] = value for pattern in filter_patterns: for key in dict(new_fields): match = re.search(pattern, key) if match: new_fields.pop(key) return new_fields def fetch(self, uri, recurse=True): raw_subfields = self._fetch(uri) if not raw_subfields: return subfields = raw_subfields.split('\n') for field in subfields: if field.endswith('/') and recurse: self.fetch(uri + field) if uri.endswith('/'): new_uri = uri + field else: new_uri = uri + '/' + field if new_uri not in self._data and not new_uri.endswith('/'): content = self._fetch(new_uri) if field == 'security-groups' or field == 'security-group-ids': sg_fields = ",".join(content.split('\n')) self._data['%s' % (new_uri)] = sg_fields else: try: dict = json.loads(content) self._data['%s' % (new_uri)] = content for (key, value) in dict.items(): self._data['%s_%s' % (new_uri, key.lower())] = value except: self._data['%s' % (new_uri)] = content # not a stringifed JSON string def fix_invalid_varnames(self, data): """Change ':'' and '-' to '_' to ensure valid template variable names""" new_data = data.copy() for key, value in data.items(): if ':' in key or '-' in key: newkey = re.sub(':|-', '_', key) new_data[newkey] = value del new_data[key] return new_data def run(self): self.fetch(self.uri_meta) # populate _data with metadata data = self._mangle_fields(self._data, self.uri_meta) data[self._prefix % 'user-data'] = self._fetch(self.uri_user) data[self._prefix % 'public-key'] = self._fetch(self.uri_ssh) self._data = {} # clear out metadata in _data self.fetch(self.uri_dynamic) # populate _data with dynamic data dyndata = self._mangle_fields(self._data, self.uri_dynamic) data.update(dyndata) data = self.fix_invalid_varnames(data) # Maintain old key for backwards compatibility data['ansible_ec2_placement_region'] = data['ansible_ec2_instance_identity_document_region'] return data def main(): module = AnsibleModule( argument_spec={}, supports_check_mode=True, ) if module._name == 'ec2_facts': module.deprecate("The 'ec2_facts' module is being renamed 'ec2_metadata_facts'", version=2.7) ec2_metadata_facts = Ec2Metadata(module).run() ec2_metadata_facts_result = dict(changed=False, ansible_facts=ec2_metadata_facts) module.exit_json(**ec2_metadata_facts_result) if __name__ == '__main__': main()