ansible.builtin._ec2_ami_search (v2.6.20) — module

Install Ansible via pip

Install with pip install ansible==2.6.20

Description

Look up the most recent AMI on AWS for a given operating system.

Returns C(ami), C(aki), C(ari), C(serial), C(tag)

If there is no AKI or ARI associated with an image, these will be C(null).

Only supports images from cloud-images.ubuntu.com

Example output: C({"ami": "ami-69f5a900", "changed": false, "aki": "aki-88aa75e1", "tag": "release", "ari": null, "serial": "20131024"})

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Launch an Ubuntu 12.04 (Precise Pangolin) EC2 instance
  hosts: 127.0.0.1
  connection: local
  tasks:
  - name: Get the Ubuntu precise AMI
    ec2_ami_search:
      distro: ubuntu
      release: precise
      region: us-west-1
      store: instance-store
    register: ubuntu_image

  - name: Start the EC2 instance
    ec2:
      image: "{{ ubuntu_image.ami }}"
      instance_type: m1.small
      key_name: mykey

Inputs

    
arch:
    choices:
    - i386
    - amd64
    default: amd64
    description: CPU architecture
    required: false

virt:
    choices:
    - paravirtual
    - hvm
    default: paravirtual
    description: virutalization type
    required: false

store:
    choices:
    - ebs
    - ebs-io1
    - ebs-ssd
    - instance-store
    default: ebs
    description: Back-end store for instance
    required: false

distro:
    choices:
    - ubuntu
    description: Linux distribution (e.g., C(ubuntu))
    required: true

region:
    choices:
    - ap-northeast-1
    - ap-southeast-1
    - ap-northeast-2
    - ap-southeast-2
    - ca-central-1
    - eu-central-1
    - eu-west-1
    - eu-west-2
    - sa-east-1
    - us-east-1
    - us-east-2
    - us-west-1
    - us-west-2
    - us-gov-west-1
    default: us-east-1
    description: EC2 region
    required: false

stream:
    choices:
    - server
    - desktop
    default: server
    description: Type of release.
    required: false

release:
    description: short name of the release (e.g., C(precise))
    required: true