ANSIBLE.NOVA_COMPUTE(3)         ANSIBLE MODULES        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



1.4.5                             2014-02-12           ANSIBLE.NOVA_COMPUTE(3)
