ANSIBLE.EC2(3)                  ANSIBLE MODULES                 ANSIBLE.EC2(3)



NAME
       ec2 - create an instance in ec2, return instanceid

DESCRIPTION
       creates ec2 instances and optionally waits for it to be 'running'. This
       module has a dependency on the external euca2ools package.

OPTIONS
       ec2_access_key
              ec2 access key

       ec2_secret_key
              ec2 secret key

       ec2_url
              url to use to connect to ec2 or your cloud (for example
              https://ec2.amazonaws.com when using Amazon ec2 directly and not
              Eucalyptus)

       group  security group to use on the instance (default: default)

       image  emi (or ami) to use for the instance(required)

       instance_type
              instance type to use for the instance(required)

       kernel kernel eki to use for the instance

       keypair
              key pair to use on the instance(required)

       ramdisk
              ramdisk eri to use for the instance

       user_data
              opaque blob of data which is made available to the ec2
              instance(Added in Ansible version 0.9.)


       wait   wait for the instance to be in state 'running' before
              returning."

EXAMPLES
       Examples from Ansible Playbooks

       local_action: ec2 keypair=admin instance_type=m1.large image=emi-40603AD1 wait=true group=webserver

AUTHOR
       Seth Vidal

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#ec2



0.9                               2012-11-30                    ANSIBLE.EC2(3)
