ANSIBLE.RAX_FACTS(3)

NAME
rax_facts - Gather facts for Rackspace Cloud Servers

DESCRIPTION

Gather facts for Rackspace Cloud Servers.

OPTIONS

address
    Server IP address to retrieve facts for, will match any IP assigned to the server

api_key
    Rackspace API key (overrides credentials)

credentials
    File to find the Rackspace credentials in (ignored if api_key and username are provided)

id  Server ID to retrieve facts for

name
    Server name to retrieve facts for

region
    Region to retrieve facts for (default: DFW)

username
    Rackspace username (overrides credentials).

NOTES

The following environment variables can be used, RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.

RAX_CREDENTIALS and RAX_CREDS_FILE points to a credentials file appropriate for pyrax. See https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating

RAX_USERNAME and RAX_API_KEY obviate the use of a credentials file

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

EXAMPLES
- name: Gather info about servers
  hosts: all
  gather_facts: False
  tasks:
    - name: Get facts about servers
      local_action:
        module: rax_facts
        credentials: ~/.raxpub
        name: "{{ inventory_hostname }}"
        region: DFW
    - name: Map some facts
      set_fact:
        ansible_ssh_host: "{{ rax_accessipv4 }}"

AUTHOR
Matt Martz

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