ANSIBLE.NOVA_COMPUTE(3)

NAME
nova_compute - Create/Delete VM's 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 keypair 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)."

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
None

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