ANSIBLE.RAX(3)

NAME
rax - create / delete an instance in Rackspace Public Cloud

DESCRIPTION

creates / deletes Rackspace Public Cloud instances and optionally waits for it to be 'running'.

OPTIONS

creds_file
    File to find the Rackspace Public Cloud credentials in

files
    Files to insert into the instance. remotefilename:localcontent

flavor
    flavor to use for the instance

image
    image to use for the instance

key_name
    key pair to use on the instance

meta
    A hash of metadata to associate with the instance

name
    Name to give the instance

region
    Region to create an instance in

service
    Cloud service to interact with Choices: cloudservers. (default: cloudservers)

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

wait
    wait for the instance to be in state 'running' before returning Choices: yes,no. (default: no)

wait_timeout
    how long before wait gives up, in seconds (default: 300)."

NOTES

Two environment variables can be used, RAX_CREDS and RAX_REGION.

RAX_CREDS points to a credentials file appropriate for pyrax

RAX_REGION defines a Rackspace Public Cloud region (DFW, ORD, LON, ...)

EXAMPLES

Example from Ansible Playbooks
- name: Create a server
  local_action:
    module: rax
    creds_file: ~/.raxpub
    service: cloudservers
    name: rax-test1
    flavor: 5
    image: b11d9567-e412-4255-96b9-bd63ab23bcfe
    wait: yes
    state: present
None

AUTHOR
Jesse Keating

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