ANSIBLE.BIGIP_POOL(3)

NAME
bigip_pool - Manages F5 BIG-IP LTM pools

DESCRIPTION

Manages F5 BIG-IP LTM pools via iControl SOAP API

OPTIONS

host
    Pool member IP

lb_method
    Load balancing method Choices: round_robin,ratio_member,least_connection_member,observed_member,predictive_member,ratio_node_address,least_connection_node_address,fastest_node_address,observed_node_address,predictive_node_address,dynamic_ratio,fastest_app_response,least_sessions,dynamic_ratio_member,l3_addr,unknown,weighted_least_connection_member,weighted_least_connection_node_address,ratio_session,ratio_least_connection_member,ratio_least_connection_node_address. (default: round_robin)(Added in Ansible version 1.3.)

monitor_type
    Monitor rule type when monitors > 1 Choices: and_list,m_of_n.(Added in Ansible version 1.3.)

monitors
    Monitor template name list. Always use the full path to the monitor.(Added in Ansible version 1.3.)

name
    Pool name(required)

partition
    Partition of pool/pool member (default: Common)

password
    BIG-IP password(required)

port
    Pool member port

quorum
    Monitor quorum value when monitor_type is m_of_n(Added in Ansible version 1.3.)

server
    BIG-IP host(required)

service_down_action
    Sets the action to take when node goes down in pool Choices: none,reset,drop,reselect.(Added in Ansible version 1.3.)

slow_ramp_time
    Sets the ramp-up time (in seconds) to gradually ramp up the load on newly added or freshly detected up pool members(Added in Ansible version 1.3.)

state
    Pool/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
## playbook task examples:
---
# file bigip-test.yml
# ...
- hosts: localhost
  tasks:
  - name: Create pool
    local_action: >
      bigip_pool
      server=lb.mydomain.com
      user=admin
      password=mysecret
      state=present
      name=matthite-pool
      partition=matthite
      lb_method=least_connection_member
      slow_ramp_time=120
  - name: Modify load balancer method
    local_action: >
      bigip_pool
      server=lb.mydomain.com
      user=admin
      password=mysecret
      state=present
      name=matthite-pool
      partition=matthite
      lb_method=round_robin
- hosts: bigip-test
  tasks:
  - name: Add pool member
    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
  - name: Remove pool member from pool
    local_action: >
      bigip_pool
      server=lb.mydomain.com
      user=admin
      password=mysecret
      state=absent
      name=matthite-pool
      partition=matthite
      host="{{ ansible_default_ipv4["address"] }}"
      port=80
- hosts: localhost
  tasks:
  - name: Delete pool
    local_action: >
      bigip_pool
      server=lb.mydomain.com
      user=admin
      password=mysecret
      state=absent
      name=matthite-pool
      partition=matthite

AUTHOR
Matt Hite

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