ANSIBLE.BIGIP_NODE(3)           ANSIBLE MODULES          ANSIBLE.BIGIP_NODE(3)



NAME
       bigip_node - Manages F5 BIG-IP LTM nodes

DESCRIPTION
       Manages F5 BIG-IP LTM nodes via iControl SOAP API

OPTIONS
       description
              Node description.

       host   Node IP. Required when state=present and node does not exist.
              Error when state=absent.(required)

       name   Node name

       partition
              Partition (default: Common)

       password
              BIG-IP password(required)

       server BIG-IP host(required)

       state  Pool member state Choices: present,absent.(required) (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

EXAMPLES
       ## playbook task examples:

       ---
       # file bigip-test.yml
       # ...
       - hosts: bigip-test
         tasks:
         - name: Add node
           local_action: >
             bigip_node
             server=lb.mydomain.com
             user=admin
             password=mysecret
             state=present
             partition=matthite
             host="{{ ansible_default_ipv4["address"] }}"
             name="{{ ansible_default_ipv4["address"] }}"

       # Note that the BIG-IP automatically names the node using the
       # IP address specified in previous play's host parameter.
       # Future plays referencing this node no longer use the host
       # parameter but instead use the name parameter.
       # Alternatively, you could have specified a name with the
       # name parameter when state=present.

         - name: Modify node description
           local_action: >
             bigip_node
             server=lb.mydomain.com
             user=admin
             password=mysecret
             state=present
             partition=matthite
             name="{{ ansible_default_ipv4["address"] }}"
             description="Our best server yet"

         - name: Delete node
           local_action: >
             bigip_node
             server=lb.mydomain.com
             user=admin
             password=mysecret
             state=absent
             partition=matthite
             name="{{ ansible_default_ipv4["address"] }}"




AUTHOR
       Matt Hite

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



1.4.5                             2014-02-12             ANSIBLE.BIGIP_NODE(3)
