ANSIBLE.NOVA_COMPUTE(3)

NAME
nova_compute - Create/Delete VMs from OpenStack

DESCRIPTION

Create or Remove virtual machines from Openstack.

OPTIONS

auth_url
    The keystone url for authentication (default: http://127.0.0.1:35357/v2.0/)

flavor_id
    The id of the flavor in which the new VM has to be created (default: yes

image_id
    The id of the image that has to be cloned(required) (default: None)

key_name
    The key pair name to be used when creating a VM (default: None)

login_password
    Password of login user(required) (default: yes)

login_tenant_name
    The tenant name of the login user(required) (default: yes)

login_username
    login username to authenticate to keystone(required) (default: admin)

meta
    A list of key value pairs that should be provided as a metadata to the new VM (default: None)

name
    Name that has to be given to the instance(required) (default: None)

nics
    A list of network id's to which the VM's interface should be attached (default: None)

region_name
    Name of the region (default: None)

security_groups
    The name of the security group to which the VM should be added (default: None)

state
    Indicate desired state of the resource Choices: present,absent. (default: present)

wait
    If the module should wait for the VM to be created. (default: yes)

wait_for
    The amount of time the module should wait for the VM to get into active state (default: 180).

EXAMPLES
# Creates a new VM and attaches to a network and passes metadata to the instance
- nova_compute:
       state: present
       login_username: admin
       login_password: admin
       login_tenant_name: admin
       name: vm1
       image_id: 4f905f38-e52a-43d2-b6ec-754a13ffb529
       key_name: ansible_key
       wait_for: 200
       flavor_id: 4
       nics:
         - net-id: 34605f38-e52a-25d2-b6ec-754a13ffb723
       meta:
         hostname: test1
         group: uge_master

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