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 image(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)."
    # 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