bigip_pool_member - Manages F5 BIG-IP LTM pool members

Author:Matt Hite

Synopsis

New in version 1.4.

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

Options

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
                      • present
                      • absent
                      Pool member state
                      user yes
                        BIG-IP username

                        Note

                        Requires bigsuds

                        Examples


                        ## 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