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