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



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