Author: | Matt Hite |
---|
parameter | required | default | choices | comments |
---|---|---|---|---|
connection_limit | no | Pool member connection limit. Setting this to 0 disables the limit. | ||
description | no | Pool member description | ||
host | yes | Pool member IP | ||
partition | no | Common | Partition | |
password | yes | BIG-IP password | ||
pool | yes | Pool name. This pool must exist. | ||
port | yes | Pool member port | ||
rate_limit | no | Pool member rate limit (connections-per-second). Setting this to 0 disables the limit. | ||
ratio | no | Pool member ratio weight. Valid values range from 1 through 100. New pool members -- unless overriden with this value -- default to 1. | ||
server | yes | BIG-IP host | ||
state | yes | present |
|
Pool member state |
user | yes | BIG-IP username |
Note
Requires bigsuds
## playbook task examples:
---
# file bigip-test.yml
# ...
- hosts: bigip-test
tasks:
- name: Add pool member
local_action: >
bigip_pool_member
server=lb.mydomain.com
user=admin
password=mysecret
state=present
pool=matthite-pool
partition=matthite
host="{{ ansible_default_ipv4["address"] }}"
port=80
description="web server"
connection_limit=100
rate_limit=50
ratio=2
- name: Modify pool member ratio and description
local_action: >
bigip_pool_member
server=lb.mydomain.com
user=admin
password=mysecret
state=present
pool=matthite-pool
partition=matthite
host="{{ ansible_default_ipv4["address"] }}"
port=80
ratio=1
description="nginx server"
- name: Remove pool member from pool
local_action: >
bigip_pool_member
server=lb.mydomain.com
user=admin
password=mysecret
state=absent
pool=matthite-pool
partition=matthite
host="{{ ansible_default_ipv4["address"] }}"
port=80
Note
Requires BIG-IP software version >= 11
Note
F5 developed module ‘bigsuds’ required (see http://devcentral.f5.com)
Note
Best run as a local_action in your playbook
Note
Supersedes bigip_pool for managing pool members