ANSIBLE.BIGIP_POOL(3)

NAME
bigip_pool - Manages F5 BIG-IP LTM pool members

DESCRIPTION

Manages F5 BIG-IP LTM pool members via iControl SOAP API

OPTIONS

host
    BIG-IP pool member(required)

name
    BIG-IP pool name(required)

partition
    BIG-IP partition (default: Common)

password
    BIG-IP password(required)

port
    BIG-IP pool member port(required)

server
    BIG-IP host(required)

state
    Pool member state Choices: present,absent. (default: present)

user
    BIG-IP username(required)."

NOTES

Requires BIG-IP software version >= 11

F5 developed module 'bigsuds' required (see http://devcentral.f5.com)

Best run as a local_action in your playbook

If pool member IP address is no longer referenced by another pool when running with state=absent, the node IP will also be deleted from the F5 configuration.
### Examples assume [localhost] is defined in inventory file
## ad-hoc ansible CLI example
# ensures 1.1.1.1:80 is present in pool /matthite/matthite-pool on load balancer lb.mydomain.com
ansible -c local localhost -m bigip_pool -a "server=lb.mydomain.com user=admin password=mysecret state=present name=matthite-pool partition=matthite host=1.1.1.1 port=80"
# ensures 1.1.1.1:80 is absent from pool /matthite/matthite-pool on load balancer lb.mydomain.com
ansible -c local localhost -m bigip_pool -a "server=lb.mydomain.com user=admin password=mysecret state=absent name=matthite-pool partition=matthite host=1.1.1.1 port=80"
## playbook task example:
---
# file bigip-test.yml
# ...
  tasks:
  - name: Register current node to load balancer pool
    local_action: bigip_pool server=lb.mydomain.com user=admin password=mysecret state=present name=matthite-pool partition=matthite host={{ ansible_default_ipv4.address }} port=80

AUTHOR
Matt Hite

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