ANSIBLE.RAX_CLB(3)

NAME
rax_clb - create / delete a load balancer in Rackspace Public Cloud

DESCRIPTION

creates / deletes a Rackspace Public Cloud load balancer.

OPTIONS

algorithm
    algorithm for the balancer being created Choices: RANDOM,LEAST_CONNECTIONS,ROUND_ROBIN,WEIGHTED_LEAST_CONNECTIONS,WEIGHTED_ROUND_ROBIN. (default: LEAST_CONNECTIONS)

api_key
    Rackspace API key (overrides credentials)

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

meta
    A hash of metadata to associate with the instance

name
    Name to give the load balancer

port
    Port for the balancer being created (default: 80)

protocol
    Protocol for the balancer being created Choices: DNS_TCP,DNS_UDP,FTP,HTTP,HTTPS,IMAPS,IMAPv4,LDAP,LDAPS,MYSQL,POP3,POP3S,SMTP,TCP,TCP_CLIENT_FIRST,UDP,UDP_STREAM,SFTP. (default: HTTP)

region
    Region to create the load balancer in (default: DFW)

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

timeout
    timeout for communication between the balancer and the node (default: 30)

type
    type of interface for the balancer being created Choices: PUBLIC,SERVICENET. (default: PUBLIC)

username
    Rackspace username (overrides credentials)

wait
    wait for the balancer 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

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: Build a Load Balancer
  gather_facts: False
  hosts: local
  connection: local
  tasks:
    - name: Load Balancer create request
      local_action:
        module: rax_clb
        credentials: ~/.raxpub
        name: my-lb
        port: 8080
        protocol: HTTP
        type: SERVICENET
        timeout: 30
        region: DFW
        wait: yes
        state: present
        meta:
          app: my-cool-app
      register: my_lb

AUTHOR
Christopher H. Laco, Matt Martz

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