ANSIBLE.RAX_CLB_NODES(3)        ANSIBLE MODULES       ANSIBLE.RAX_CLB_NODES(3)



NAME
       rax_clb_nodes - add, modify and remove nodes from a Rackspace Cloud
       Load Balancer

DESCRIPTION
       Adds, modifies and removes nodes from a Rackspace Cloud Load Balancer

OPTIONS
       address
              IP address or domain name of the node

       api_key
              Rackspace API key (overrides credentials)

       condition
              Condition for the node, which determines its role within the
              load balancer Choices: enabled,disabled,draining.

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

       load_balancer_id
              Load balancer id(required)

       node_id
              Node id

       port   Port number of the load balanced service on the node

       region Region to authenticate in

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

       type   Type of node Choices: primary,secondary.

       username
              Rackspace username (overrides credentials)

       virtualenv
              Path to a virtualenv that should be activated before doing
              anything. The virtualenv has to already exist. Useful if
              installing pyrax globally is not an option.

       wait   Wait for the load balancer to become active before returning
              Choices: yes,no. (default: no)

       wait_timeout
              How long to wait before giving up and returning an error
              (default: 30)

       weight Weight of node.

NOTES
       The following environment variables can be used: RAX_USERNAME,
       RAX_API_KEY, RAX_CREDENTIALS and RAX_REGION.

EXAMPLES
       # Add a new node to the load balancer
       - local_action:
           module: rax_clb_nodes
           load_balancer_id: 71
           address: 10.2.2.3
           port: 80
           condition: enabled
           type: primary
           wait: yes
           credentials: /path/to/credentials

       # Drain connections from a node
       - local_action:
           module: rax_clb_nodes
           load_balancer_id: 71
           node_id: 410
           condition: draining
           wait: yes
           credentials: /path/to/credentials

       # Remove a node from the load balancer
       - local_action:
           module: rax_clb_nodes
           load_balancer_id: 71
           node_id: 410
           state: absent
           wait: yes
           credentials: /path/to/credentials



AUTHOR
       Lukasz Kawczynski

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



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