rax_facts - Gather facts for Rackspace Cloud Servers

Author:Matt Martz

Synopsis

New in version 1.4.

Gather facts for Rackspace Cloud Servers.

Options

parameter required default choices comments
address no
    Server IP address to retrieve facts for, will match any IP assigned to the server
    api_key no
      Rackspace API key (overrides credentials)
      auth_endpoint no https://identity.api.rackspacecloud.com/v2.0/
        The URI of the authentication service (added in Ansible 1.5)
        credentials no
          File to find the Rackspace credentials in (ignored if api_key and username are provided)
          env no
            Environment as configured in ~/.pyrax.cfg, see https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration (added in Ansible 1.5)
            id no
              Server ID to retrieve facts for
              identity_type no rackspace
                Authentication machanism to use, such as rackspace or keystone (added in Ansible 1.5)
                name no
                  Server name to retrieve facts for
                  region no DFW
                    Region to create an instance in
                    tenant_id no
                      The tenant ID used for authentication (added in Ansible 1.5)
                      tenant_name no
                        The tenant name used for authentication (added in Ansible 1.5)
                        username no
                          Rackspace username (overrides credentials)
                          verify_ssl no
                            Whether or not to require SSL validation of API endpoints (added in Ansible 1.5)

                            Note

                            Requires pyrax

                            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 }}"
                            

                            Note

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

                            Note

                            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

                            Note

                            RAX_USERNAME and RAX_API_KEY obviate the use of a credentials file

                            Note

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